Aracıları Microsoft Teams'e dağıtın

Microsoft Teams, kalıcı konuşma ortamı nedeniyle Copilot Studio aracıları için benzersiz dağıtım zorlukları sunar. Oturumların otomatik olarak sıfırlandığı web tabanlı dağıtımlardan farklı olarak, Teams konuşma yazışmalarını süresiz olarak tutar ve bu da eski bağlam, belirteç süre sonu ve eski önbelleğe alınmış içeriğe yol açabilir.

Bu makale, Teams'de Copilot Studio aracılarını etkili bir şekilde dağıtmaya yönelik rehberlik sağlar. Kalıcı oturumları yönetmeyi, hata ayıklama stratejileri uygulamayı ve genişletilmiş konuşma yaşam döngüleri arasında güvenilir performans sağlamayı öğrenirsiniz.

Ele alınan önemli hususlar:

  • Oturum yaşam döngüsü yönetimi ve etkinliksizlik işleme
  • Kalıcı konuşmalar için hata ayıklama teknikleri
  • Sürüm denetimi ve güncelleştirme dağıtım stratejileri
  • Teams'e özgü uygulama desenleri

Teams ortamında tutarlı bir şekilde performans gösteren güçlü aracılar oluşturmak ve kullanıcılara durum değişiklikleri ve sistem davranışı hakkında net geri bildirim sağlamak için bu uygulamaları izleyin.

Teams dağıtımı neden farklıdır?

Teams konuşmaları otomatik sıfırlama olmadan günler boyunca devam eder. Web Sohbeti oturumlarından farklı olarak, ConversationStart olayı yalnızca bir temsilci ilk kez eklendiğinde tetiklenir. Uygulamayı yeniden yüklemek bu olayı yeniden tetiklemez.

Teams'in kalıcılığı çeşitli riskler oluşturur:

  • Eski içerik: Konuşma geçmişi silinmediği sürece kalmaya devam eder.
  • Token geçerlilik süresi: Bağlayıcılar uzun oturumlar sırasında geçerlilik süresini doldurabilir.
  • Bağlam sınırları: Birikmiş iletiler model sınırlarını aşabilir.
  • Önbelleğe alma güncelleştirme: Kullanıcılar eski mantıkla etkileşime devam edebilir.

Proaktif durum yönetimi ve net kullanıcı kılavuzu gereklidir.

Oturum yaşam döngüsünü yönetme

Etkinliksizlik işleme ile oturum yaşam döngüsünü yönetin.

Faaliyetsizlik sıfırlamalarını uygulama

Yeni bir konu oluşturun ve Kullanıcı bir süre etkin değiltetikleyicisini seçerek kullanıcı etkinlik dışı bir süre sonra bir sıfırlama akışı başlatın. Koruma değişkenleri ve kalıcı konuşma modeli de dahil olmak üzere Teams'e özgü desenler hakkında etkinlik dışı tetikleyici bölümünde daha fazla bilgi edinin.

  1. Etkinlik dışı tetikleyicisini ekleyin ve bir zaman aşımı ayarlayın (örneğin, 15 dakika).
  2. Bağlam taşmasını önlemek için oturum değişkenlerini ve konuşma geçmişini kaldırmak için bir veya daha fazla Değişken değerlerini temizle düğümü ekleyin.
  3. Konuşmayı sonlandırın ve oturumu çözüldü olarak işaretleyin.

Copilot Studio konu düzenleyicisinin, tetikleyici, ileti, değişken değerlerini temizle ve konuşma düğümlerini sonlandır içeren etkinlik dışı sıfırlama iş akışını görüntüleyen ekran görüntüsü.

Bu yaklaşım, bağlam taşmasını önler ve kullanıcı döndüğünde öngörülebilir davranışlar sağlar.

Sıfırlamadan sonra rehberlik sağlama

Durumu temizledikten sonra, ne olduğunu açıklayan bir ileti gönderin. Örneğin: "Görünüşe göre konuşmamız boşta kaldı, bu yüzden güvenlik için önceki bağlamı temizliyorum. Yeniden başlatmak için 'merhaba' deyin."

Sadece bir kez ConversationStart ateşlendiği için, bir aracı ilk kez eklendiğinde, Selamlama konusu etkili başlatma noktanız olur. Kullanıcıdan "merhaba" demesinin istenmesi, başlangıç mantığınızın doğru şekilde çalışmasını sağlar.

Self servis sıfırlama komutu teklif etme

Kullanıcılara belirli bir komut yazabileceklerini bildiren mesajlaşma ekleyin: "Bir sorun varsa, durumumu yenilemek için yazmayı /debug clearstate deneyin."

Bu komut tüm sohbeti sıfırdan başlatır.

  • Konuşma durumunu temizler
  • Önbelleğe alınmış bağlayıcı bilgilerini kaldırır
  • Bağlayıcıların kimlik doğrulama işlemini yeniler
  • Aracının en son sürümünü yükler.

Şu durumlarda bu komutu kullanın:

  • Bot güncel olmayan bilgilerle "takılmış" görünüyor
  • Bağlayıcı kimlik doğrulamasının süresi doldu
  • Bot mantığı güncelleştirmelerinin ardından
  • Davranış tutarsız göründüğünde

Saydamlığı artırma ve hata ayıklamayı geliştirme

Saydamlığı artırmak ve Teams'de dağıtılan aracılarda hata ayıklamayı geliştirmek için tetikleyiciyi OnKnowledgeRequested kullanın.

Yeniden yazılan sorguları ortaya çıkarmak için OnKnowledgeRequested kullanma

Copilot Studio, alma işlemi gerçekleştirmeden önce kullanıcı sorularını yeniden yazar. Tetikleyiciyi OnKnowledgeRequested etkinleştirirseniz şunları yapabilirsiniz:

  • Amaç uyuşmazlıklarını tanılama
  • Sorguların nasıl yeniden yazıldığını anlama
  • Hata ayıklama sırasında kullanıcı güvenini artırma

Uyarı

YAML kullanarak tetikleyiciyi OnKnowledgeRequested yalnızca kod görünümünde yapılandırabilirsiniz. Görsel tasarımcı desteği yoktur.

Hem anahtar sözcüğü hem de oluşturulan anlamsal sorguları gösteren bir ileti ekleyin. Örneğin:

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

Bu sorgu, düzenleyicinin kullanıcının sorusundan oluşturduğu geliştirilmiş arama sorgusuna (sorgu yeniden yazma) salt okunur erişim sağlar.

Avantajlar:

  • Niyetteki uyuşmazlıkları hata ayıklamaya yardımcı olur.
  • Kullanıcılara aracının neyi aradığını gösterir.
  • Ajanın eylemlerine güven oluşturur.
  • Test sırasında üreticilere yardımcı olur.

Sürüm denetimi ve güncelleştirme güvenilirliği

Aracı sürümlerini yönetmek ve kullanıcıların en son mantıkla etkileşim kurmasını sağlamak, teams gibi kalıcı bir ortamda özellikle önemlidir.

Selamlaşmada veya ayrılmış bir konu başlığında Surface bot sürümünü belirtin.

Selamlama konusunu veya ayrılmış bir Sürüm konusunu kullanarak bir sürüm tanımlayıcısı ekleyin:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Kullanıcıların ve destek ekiplerinin hangi derlemenin etkin olduğunu doğrulamasına yardımcı olmak için bu değeri her yayımlamayla güncelleştirin. Sürüm meta verilerinin güncelleştirilmesi, önbelleğe alınan içeriği de yeniler. Ajanın adını veya açıklamasını değiştirmek, Teams'in bunu yeni bir güncelleştirme olarak yüklemesini tetikler.

Yayımlarken "En yeni sürümü zorla" özelliğini etkinleştirme

En yeni sürümü zorla ayarı, kullanıcı bir sonraki ileti gönderdiğinde Teams'in en yeni aracı mantığını yüklemesini sağlar. Bu ayar, önbelleğe alınmış sürümlerin geçersiz kılınmasinde de yardımcı olur. Ancak, bir güncelleştirmeyi zorlamak devam eden konuşmaları kesintiye uğratır.

Kimlik bilgileri, önizleme modeli ve "En yeni sürümü zorlama" özelliğinin etkinleştirilmesiyle ilgili uyarıları içeren aracı yayımlama iletişim kutusunun ekran görüntüsü.

Teams'e özgü uygulama konuları

Ekipler özel dikkat gerektiren benzersiz davranışlara sahiptir.

Selamlama konusunu başlangıç mantığınız olarak ele alma

ConversationStart sadece bir kez tetiklendiğinden, bir aracı ilk kez eklendiğinde:

  • Başlatma mantığını Greeting'e yerleştirin.
  • Teams uygulama açıklamasına net yönergeler ekleyin.
  • Kullanıcılara şunu anımsat: "Zaman aşımının ardından yeni bir konuşma başlatmak için 'hello' yazın."

Tetikleyicileri ve geri dönüşleri iyileştirme

Teams kullanıcıları doğal ve öngörülemez bir şekilde etkileşim kurar. Botunuzun:

  • Birden çok selamlama varyasyonunu yönetir.
  • Veda işlemlerini içerir.
  • Birden çok örnek konuşma sağlar.
  • Kullanıcı dostu ve yardımcı alternatif yanıtlar sunar.
  • Kullanıcıları ilgili konulara yönlendirmek için anahtar sözcükleri kullanır.
  • Kaçırılan amaçları teşhis etmeye yardımcı olmak için OnKnowledgeRequested kullanılır.
  • Anahtar sözcüklere göre ilgili konulara yönlendirir.
  • Bot gerçekten takılıp kaldığında kullanıcılardan yeniden ifade etmelerini ister.

Bağlayıcı kimlik doğrulama davranışını doğrulama

Bağlayıcıları (ServiceNow, Outlook ve diğerleri) kullandığınızda şunları test edin:

  • İlk oturum açma kartının davranışı.
  • Belirtecin süresi dolduğunda ve otomatik olarak yenilendiğinde ne olur?
  • Zorlamalı geçersizleştirme ve mutabakat akışları nasıl çalışır?

Tip

Bağlayıcılar, genişletilmiş oturumlar sırasında belirteçleri yenilemeyebilir. Kullanılması gereken durumlarda, etkin olmayan durum sıfırlamalarını veya /debug clearstate kullanarak OAuth'u yeniden tetikleyin. Hızlı sorun giderme için ekipleri ve kullanıcıları desteklemek için bu komutu iletin.

Gerçek koşullar altında test

Teams oturumlar arasında durumu koruduğundan, testiniz gerçek kullanıcı deneyimini yansıtmalıdır:

  1. Sadece bana göster seçeneğini kullanarak dağıtın.
  2. Uzun süre çalışan senaryoları test edin (iş dışı saatlerde geri dönün).
  3. Güncellemeleri duyurun ve aracın sürümler arasında geçişini onaylayın.
  4. Masaüstü ve mobil cihazlarda Uyarlamalı Kart işlemeyi doğrulayın.
  5. Çeşitli konuşma bağlamlarındaki eylemleri test edin.

Dağıtım denetim listesi

Tamam mı? Görev
✓ Konuşma geçmişini temizlemek için yapılandırılmış etkinlik dışı tetikleyici
✓ Kullanıcıya yönelik mesajlar sıfırlamaları açıklar ve yeniden başlatma için rehberlik eder.
✓ /debug clearstate kullanıcılar için belgelenmiştir
✓ OnKnowledgeRequested geliştirme sırasında saydamlık için etkinleştirildi
✓ Yanıtlara eklenen sürüm tanımlayıcısı
✓ En yeni sürüm zorla uygun şekilde etkinleştirildi
✓ Selamlama başlığı başlatma mantığını içerir
✓ Geri dönüş davranışı kullanıcı dostudur
✓ Bağlayıcı kimlik doğrulaması süre sonu ve yenileme için test edildi
✓ Gerçek koşullar altında Teams'de test tamamlandı

Önemli temel bilgiler

  • Etkinlik dışı tetikleyicileri yapılandırarak ve uygun olduğunda durum temizleme seçeneklerini kullanarak oturum yaşam döngüsünü yönetin.
  • Sorgu yeniden yazımları ve durumla ilgili iletiler aracılığıyla sistem etkinliğini görünür hale getirerek şeffaflığı artırın.
  • El ile karşılamaları işleme ve kalıcı belleği yönetme gibi Teams'e özgü davranışları hesaba katın.
  • Sürüm oluşturma uygulamaları uygulayarak ve gerektiğinde güncelleştirmeleri zorunlu tutarak aracı güvenilirliğini koruyun.
  • Self servis sorun giderme komutları ve destekli kurtarma seçenekleri sağlayarak kullanıcı özerkliğini destekleyin.
  • Last updated on