Konu tetikleyicileri ayarlama

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Üretken düzenleme kullanan aracılar için varsayılan konu tetikleyicisi Aracı seçer şeklindedir. Aracı, konunun adının ve Tetikleyici düğümünde belirtilen açıklamanın, kullanıcıdan gelen mesajla eşleştiğini belirlediğinde etkinleşir.

Klasik orkestrasyon kullanan aracılar için varsayılan konu tetikleyicisi Kullanıcı bir ifade söylüyor şeklindedir. Belirtilen tetikleme tümcecikleriden bir veya daha fazlası, kullanıcıdan gelen bir mesajla yakından eşleştiğinde etkinleşir. Daha fazla bilgi edinin: Etkili tetikleyici ifadeler tasarla. Konunun ne zaman yürütüleceğini belirleyen başka tetikleyici türleri de mevcuttur.

Prerequisites

Konu oluşturma ve düzenleme hakkında bilgi sahibi olun.

Tetikleyici türleri

Tetikleyiciler, ajanınızın farklı türdeki olayları veya gelen aktiviteleri kesmesini ve işlemesini mümkün hale getirir. Aşağıdaki tetikleyici türleri konunun ne zaman tetiklenmesi gerektiğini belirler.

Tip

Kullanıcı bir aracıya mesaj gönderdiğinde, bu yük etkinlik türünde bir mesajdır. Ajanlar, sohbet sırasında veya diğer olaylarda gerçekleşenlere bağlı olarak diğer türlerde etkinlikler alabilir.

Örneğin, Microsoft Teams, bir kullanıcı eylemini temsil eden gizli çağırma etkinlikleri gönderir; bunlar bir mesaj uzantısı ile etkileşim kurmak gibi eylemlerdir.

Türü	Description
Ajan seçer	Üretken düzenleme kullanan aracılar için kullanılabilir. Aracı , Tetikleyici düğümünde belirtilen konunun adı ve açıklamasının kullanıcıdan gelen iletiyle eşleşeceğini belirlediğinde tetikler.
Kullanıcı bir ifade söyler	Klasik orkestrasyon kullanan ajanslar için kullanılabilir. Tetikleme tümcelerinden biri veya daha fazlası bir kullanıcıdan gelen mesajla uyuştuğunda devreye girer.
Bir ileti alındı	En yaygın etkinlik türü olan mesaj etkinliği alındığında tetiklenir. Bir kullanıcı aracıya bir şey yazdığında veya söylediğinde bu mesaj alınır.
Özel bir istemci olayı gerçekleşir	Etkinlik alındığında tetiklenir. Varsayılan olarak, tüm etkinlikler yanıtlanır. Belirli bir olayı filtrelemek için tetikleyici özelliklerindeki Olay adı özelliğini kullanın.
Bir etkinlik gerçekleşiyor	Herhangi türde bir etkinlik alındığında tetiklenir. İsteğe bağlı olarak tetikleyici özelliklerindeki Etkinlik türü özelliğini belirli bir etkinlik türüne göre filtrelemek üzere ayarlayabilirsiniz.
Konuşma değişir	Konuşma güncelleme etkinliği alındığında tetiklenir. Örneğin, bir kullanıcı bir konuşmaya katıldığında Teams bu türden bir etkinlik gönderir.
Çağrılmıştır	Bir çağırma etkinliği alındığında tetiklenir. En yaygın olarak Teams kanalından alınır (örneğin, kullanıcı Teams'de bir ileti veya arama uzantısıyla etkileşim kurduğunda).
Şuraya yönlendirildi:	Bir konu başka bir konu tarafından açıkça çağrıldığında tetiklenir. Tetikleyici özelliklerinde Etkin olmama süresi özelliğini kullanarak istenen etkin olmama süresini ayarlayın.
Kullanıcı bir süre etkin değil	Kullanıcı yapılandırılmış bir süre sonra aracıyla etkileşim kurmadığında tetiklenir. Etkinliksizlik tetikleyicisi hakkında daha fazla bilgi edinin.
Bir plan tamamlandığında	Üretken düzenleme kullanan aracılar için kullanılabilir. Ajan, kullanıcı sorgusuna veya otonom tetikleyiciye yanıt vermek için planlanan tüm adımları tamamladığında tetiklenir.
Yapay zeka tarafından oluşturulan bir yanıt gönderilmek üzere	Üretken düzenleme kullanan aracılar için kullanılabilir. Aracı, bir veya daha fazla konu, araç veya bilgi kaynağını çağırdıktan sonra kullanıcı için bir yanıt oluşturduğunda tetiklenir. Oluşturulan yanıtı görmek için Response.FormattedText sistem değişkenini kullanın. Orkestrasyon yanıtının gönderilmesini engellemek istiyorsanız (yani, mesajı değiştirip ContinueResponse düğümünü kullanarak kendi mesajınızı gönderirseniz), değişkenini false olarak ayarlayın.

Konu için tetikleyiciyi değiştirme

1. Ajansınızın Konular sayfasına gidin ve açmak istediğiniz konuyu açın.

2. Tetikleyici düğümünün kutusunun üzerine gelin ve Tetikleyiciyi değiştir simgesini seçin.

   

3. Konunuz için uygun tetikleyici türünü seçin.

   • Aracı seçer tetikleyicisi için, aracınızın bu konuyu ne zaman kullanması gerektiğini açıklayın.
   • Kullanıcı bir ifade söyler tetikleyicisi için, istediğiniz tetikleyici tümcecikleri girin.

4. Tetikleyici kutusunda Düzenle'yi seçin. Belirtilen tetikleyici türü için özellikler paneli görüntülenir.

5. Tetikleyiciniz için geçerli özellikleri ayarlayın:

   • Etkinlik türü
   • Condition
   • Priority

Tetikleme koşulu

Tetikleyicinin çalışması için sağlanması gereken koşulları belirtin. Örneğin, tetikleyicinin yalnızca bir çalışanın kullandığı kanal Microsoft Teams ise çalışmasını isteyebilirsiniz.

Daha karmaşık koşullara ihtiyacınız varsa Power Fx formül düzenleyicisine geçin: Oluşturucu'ya ve ardından Formül'e tıklayın.

Tetikleyici önceliği

Gelen tek bir etkinlik (örneğin ileti) için birden fazla tetikleyici etkinleştirilebilir. Tetikleyici türü, tetikleyicilerin etkinleştirilme sırasını belirler.

Yürütme sırası:

1. Bir etkinlik gerçekleşir
2. Bir mesaj alındı / Özel bir istemci olayı meydana geldi / Konuşma değişti / Çağrıldı
3. Agent seçer / Kullanıcı bir ifade söyler

Aynı türde birden fazla niteleyici tetikleyici varsa, sistem tetikleyicileri oluşturma sırasına göre yürütür (önce en eski).

Yürütme sırasını açıkça belirlemek için Priority özelliğini ayarlayabilirsiniz.