Aracılığıyla paylaş


Konu oluşturma ve düzenleme

Copilot Studio'de bir konu, bir aracı görüşmesinin nasıl ilerleyeceğini tanımlar.

Konular için, sağlanan şablonları özelleştirebilir, sıfırdan konular oluşturabilir veyane istediğinizi açıklayabilir ve AI'nın sizin için konu oluşturmasını sağlayabilirsiniz.

Copilot Studio'de, bir konu, bir kullanıcı ile bir aracı arasındaki konuşma dizisinin bir bölümünü temsil eder. Bir yazma tuvalinde konuları tanımlar ve bu konular üzerinde çalışırsınız. Konu, bir konu içerebilen konuşma yollarını birlikte tanımlayan bir veya daha fazla konuşma düğümleri içerir. Her düğüm, ileti gönderme veya soru sorma gibi bir eylem gerçekleştirir.

Çoğu zaman, konu bir dizi tetikleyici ifadeye (müşterinin belirli bir sorunla ilgili olarak kullanabileceği ifadeler, anahtar kelimeler ve sorular) sahiptir. Copilot Studio aracıları, tetiklenecek en iyi konuyu bulmak için doğal dil anlayışını, müşterinizin mesajını ve tüm konularınız için tetikleyici ifadeleri kullanır. İletinin, konu tetiklemek için konunun tetikleme tümcecikleriyle tam olarak eşleşmesi gerekmez. Örneğin, mağaza çalışma saatleri hakkındaki bir konu, check store hours tetikleme tümceciğini içerebilir. Müşteri "bkz. mağaza çalışma saatleri"ni girerse, bu cümle mağaza saatleri konunuzu tetikler.

Önkoşullar

Doğal Dil anlama

Bir aracı, müşterinin yazdıklarını ayrıştırmak ve en iyi tetikleyici ifadeyi veya düğümü bulmak için doğal dil anlama (NLU) özelliğini kullanır.

Örneğin, bir kullanıcı "Açık saatler" yazabilir. Aracı bunu Mağaza saatleri konusuyla eşleştirir, müşterinin hangi mağazayla ilgilendiğini soran bir konuşma başlatır ve ardından mağazanın açık olduğu saatleri görüntüler.

Test aracısı bölmesi, aracı görüşmesinin her adımda nasıl ilerlediğini gösterir. Copilot Studio içinden çıkmak zorunda kalmadan bir konuda hassas ayar yapmak için Test aracısı bölmesini kullanabilirsiniz.

Aracı ve konu limitleri için Kotalar, sınırlar, uygulama kaydı, sertifikalar ve yapılandırma değerleri konusunda bakın.

Copilot Studio'taki konular

Konu türleri

Bir aracı iki tür konu içerebilir: sistem ve özel konular. Her yeni aracı, önceden tanımlanmış bir dizi sistem ve özel konu ile başlar.

  • Sistem konuları, bir kişiyle konuşmak veya konuşmayı sonlandırmak için özel istekte bulunmak gibi temel davranışları destekler. Bazı sistem konularında, aracınızın gereksinimlerine uyacak şekilde özelleştirebileceğiniz tetikleme tümcecikleri bulunur.

    • Sistem konuları oluşturamazsınız.
    • Sistem konularını silemezsiniz ancak bunları devre dışı bırakabilirsiniz.
    • Sistem konularında değişiklikler yapabilirsiniz. Ancak, eksiksiz aracı deneyimleri oluşturma konusunda rahat olana kadar sistem konularını düzenlemenizi önermiyoruz.

    Daha fazla bilgi edinmek için bkz. Sistem Konularını kullanma.

  • Önceden tanımlanmış özel konular, müşteriyi selamlama, bir konuşmayı sona erdirme veya konuşmayı yeniden başlatma gibi ortak davranışları içerir.

    • Önceden tanımlanmış özel konularda değişiklik yapabilir veya bunları aracınızdan tamamen kaldırabilirsiniz.
    • Oluşturduğunuz tüm konular özel konular olur.

Düğüm türleri

Aşağıdaki düğüm türleri kullanılabilir:

Seçenek Description
İleti gönderme Müşteriye ileti gönderin.
Bir soru sorun Müşteriye soru sorun.
Uyarlamalı kart ile sorun Diğer uygulamalarla alışveriş yapmak için bir JSON kod parçacığı oluşturun.
Koşulları kullanarak yazma Koşula bağlı olarak konuşmanızı dallandırın.
Değişken yönetimi Bir değer ayarlama, bir değeri ayrıştırma veya tüm değişkenleri temizleme.
Konuları yönetme Konuyu veya konuşmayı yeniden yönlendirin, aktarın ya da sonlandırın.
Akış çağır Power Automate veya Excel Online gibi bir akışı arayın ya da bir bağlayıcı veya eklenti kullanın.
Gelişmiş Üretken yanıtlar, HTTP istekleri, olaylar ve daha fazlası.

İpucu

Düğümleri daha kolay tanımlayacak şekilde yeniden adlandırın. Adı doğrudan güncelleştirmek için düğümün ad alanını seçin veya düğümün Daha fazla simgesini (...) ve menüden Yeniden adlandır'ı seçin. Ayrıca kod düzenleyicide düğümleri yeniden adlandırabilirsiniz.

Tetikleyici düğümlerini ve Adıma git düğümlerini yeniden adlandırmak mümkün değildir.

Düğüm adlarının uzunluğu en fazla 500 karakter olabilir.

Konu oluşturma

  1. Aracılar sayfasındaki listeden aracınızı açın. Daha iyi görünürlük için Aracınızı test etme panelini şimdilik kapatın.

  2. Üst menü çubuğunda, Konular'ı seçin.

  3. Bir konu ekle'yi ve sonra da Boştan'ı seçin.

    Tetikleyici düğümü, başka bir şekilde boş konu yazarlık tuvalinde görünür.

  4. Tetikleyici düğümünün Diğer simgesini (...) seçin ve ardından Özellikler'i seçin. Amaç Tanındığında özellikleri paneli görünür.

  5. Tanınan Amaç özellikleri bölmesinde, İfadeler alanını seçin. İfadeler ikincil bölmesi görünür.

  6. İfadeler ekle altına konu için bir tetikleme tümceciği girin.

    Aracınızın, müşterilerinizin yanıtlarını anlamak üzere yapay zekayı eğitmek için 5 ila 10 tetikleme tümceciğine ihtiyacı vardır. Daha fazla tetik tümceciği eklemek için aşağıdakilerden birini yapabilirsiniz:

    • Metin alanının yanındaki Ekle simgesini seçin ve istediğiniz ifadeyi girin.
    • Her biri ayrı bir satıra tetikleme tümcecikleri kümesini yapıştırın ve Enter'ı seçin.
    • Bir tetikleme tümceciği kümesi yazın ve her birinden sonra Shift+Enter tuşlarına basarak bir satıra yerleştirin ve Enter seçeneğini belirleyin.

    Tetikleme tümceciğine noktalama işaretleri ekleyebilirsiniz ancak uzun cümleler yerine kısa ifadeler kullanmak en iyisidir.

  7. Araç çubuğunda Detaylar seçeneğini belirleyin ve Konu detayları bölmesini açın.

  8. Aracı konu ayrıntılarınızı ekleyin:

    • Konuyu tanımlamak için "Mağaza saatleri" gibi bir ad girin. Konular sayfası, aracınızda tanımlanan tüm konuları bu adla listeler.
    • İstenirse, aracının müşterinin mesajıyla hangi konunun eşleştiğini belirleyemediği durumlarda müşteriye gösterilecek bir görüntüleme adı girin.
    • İstenirse, konunun amacını kendiniz ve ekibinizdeki diğer aracı üreticiler için açıklamak üzere Açıklama alanını kullanın. Müşteriler konu açıklamalarını asla görmez.
  9. Konunuzu kaydetmek için üst menü çubuğunda Kaydet'i seçin.

Önemli

Konu adlarınızda noktalardan (.) kaçının. Konularından herhangi birinin adında nokta içeren aracı içeren bir çözümü dışarı aktarmak mümkün değildir.

Konu konuşma yolu tasarlama

Bir konu oluşturduğunuzda, bu işlem otomatik olarak yazma tuvalinde bir Tetikleyici düğümü görünür. Daha sonra konu için istediğiniz konuşma yolunu elde etmek için farklı düğüm türleri ekleyebilirsiniz.

Başka bir düğümden sonra veya konu yazma tuvalinizde iki düğüm arasına bir düğüm eklemek için:

  1. Altına yeni bir düğüm eklemek istediğiniz düğmenin altındaki Düğüm ekleme simgesini seçin.

  2. Görüntülenen listeden istediğiniz düğüm türünü seçin.

    Bir Tetikleyici düğümünden sonra bir düğüm eklemek üzere seçim için kullanılabilir seçeneklerin ekran görüntüsü.

Düğüm silme

Silmek istediğiniz düğümün Daha fazlasimgesini (...) seçin ve ardından Sil seçeneğini belirleyin.

Tuvalde düğüm düzenleme denetimleri

Seçili düğümü veya seçili bitişik düğümleri kesmek, kopyalamak, yapıştırmak ve silmek için araç çubuğundaki denetimleri kullanabilirsiniz.

Yazma tuvalinde düğümleri düzenlemek için araç çubuğu denetimlerinin ekran görüntüsü.

Araç çubuğunda ayrıca bir düzenlemeyi geri almaya yönelik bir kontrol bulunur. Tüm eylemleri, son kaydedilen duruma döndürmek veya önceki eyleme dönmek için Geri al menüsünü açın.

Geri Alma menüsünün ekran görüntüsü.

Düğümleri yapıştırma

Panoya bir veya daha fazla düğüm yerleştirmek için Kes veya Kopyala araçlarını kullandıktan sonra bunları tuvale yapıştırmak için iki yol vardır:

  • Düğüm seçip ardından Yapıştır seçeneğini belirlerseniz panodaki düğümler, seçili düğümün sonrasına eklenir.

  • Düğüm ekle menüsünü görmek için "+" öğesini seçip ardından Yapıştır'ı seçerseniz panodaki düğüm bu konuma yerleştirilir.

Bir konu için giriş ve çıkış parametreleri ekleme

Konular giriş ve çıkış parametrelerine sahip olabilir. Bir konu başka bir konuya yönlendirildiğinde, konular arasında bilgi iletmek için bu parametreleri kullanabilirsiniz.

Ayrıca, aracınız üretici modu kullanıyorsa, konu girişlerini konuşma bağlamından otomatik olarak doldurabilir veya kullanıcılardan değer toplamak için sorular ürettikten sonra doldurabilir. Bu davranış, eylemler için üretken yuva doldurmanın çalışma şekline benzerdir.

Konulara ilişkin giriş ve çıkış parametreleri hakkında daha fazla bilgi edinmek için Konu girişlerini ve çıkışlarını yönetme konusuna bakın.

Kod düzenleyicisi ile konuları düzenleme

Kod düzenleyicisi, konuyu okunması ve anlaşılması kolay bir işaretleme dili olan YAML olarak gösterir. Diğer yazarlar tarafından oluşturulanlar dahil olmak üzere diğer botlardaki konuları kopyalayıp yapıştırmak için kod düzenleyicisini kullanın.

Önemli

Tamamen kod düzenleyicisinde konu tasarlamak ve karmaşık konuları yapıştırmak tam olarak desteklenmez.

Bu örnekte, müşteriden gönderim bilgilerini soran konu kodunu hızlı bir şekilde eklemek için YAML'yi kopyalayıp kod düzenleyiciye yapıştırırsınız.

  1. Konular sayfasında + Oluşturma>Boştan'ı seçin.

  2. Yazarlık tuvalinin sağ üst köşesinden Daha Fazla'yı seçin, ardından Kod düzenleyicisini aç'ı seçin.

    Bir konu için kod düzenleyicisinin nasıl açılacağını gösteren ekran görüntüsü.

  3. Kod düzenleyicisinin içeriğini seçin ve silin. Ardından aşağıdaki YAML kodunu kopyalayıp yapıştırın:

    kind: AdaptiveDialog
    beginDialog:
      kind: OnRecognizedIntent
      id: main
      intent:
        displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
        triggerQueries:
          - Buy items
          - Buy online
          - Buy product
          - Purchase item
          - Order product
    
      actions:
        - kind: SendMessage
          id: Sjghab
          message: I am happy to help you place your order.
    
        - kind: Question
          id: eRH3BJ
          alwaysPrompt: false
          variable: init:Topic.State
          prompt: To what state will you be shipping?
          entity: StatePrebuiltEntity
    
        - kind: ConditionGroup
          id: sEzulE
          conditions:
            - id: pbR5LO
              condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
    
          elseActions:
            - kind: SendMessage
              id: X7BFUC
              message: There will be an additional shipping charge of $27.50.
    
            - kind: Question
              id: 6lyBi8
              alwaysPrompt: false
              variable: init:Topic.ShippingRateAccepted
              prompt: Is that acceptable?
              entity: BooleanPrebuiltEntity
    
            - kind: ConditionGroup
              id: 9BR57P
              conditions:
                - id: BW47C4
                  condition: =Topic.ShippingRateAccepted = true
    
              elseActions:
                - kind: SendMessage
                  id: LMwySU
                  message: Thank you and please come again.
    
  4. Kaydet'i ve ardından Kod düzenleyiciyi kapat'ı seçin. Soru düğümünde artık gönderimle ilgili soru için birçok koşul var.

    Copilot Studio kod düzenleyicisinde YAML'den oluşturulan bir konuşmanın ekran görüntüsü.

Aracınızı test etme ve yayımlama

Konularınızda değişiklik yaptığınızda her şeyin beklendiği gibi çalıştığından emin olmak için aracınızı test edin.

Aracınızı tasarlayıp test ettikten sonra onu web, mobil veya yerel uygulamalarda veya Microsoft Bot Framework kanallarında yayınlayın.