Alt aracı ekleme

Alt aracı, ana aracınız bağlamında var olan basit bir aracıdır. Alt aracılar, araçları, yönergeleri ve bilgileri mantıksal olarak daha büyük bir aracı içinde açıkça tanımlanmış alt eflatunlar halinde gruplandırmanıza olanak sağlar. Tek bir amada yanıt veren veya tek bir görevi tamamlayan tek kullanımlık durumlar için idealdir. Bu makalede alt aracı oluşturma ve yönetme açıklanmaktadır.

Alt aracı oluşturun

1. Ana aracınızın Aracılar sayfasına gidin ve Aracı ekle'yi seçin.

2. Yeni alt aracı'yı seçin.

3. Yeni alt aracınız için ayırt edici bir ad girin.

4. Aracınızın ne zaman kullanılacağını belirleyin. Varsayılan olarak, aracılar açıklamalarına göre kullanıcılara veya tetikleyicilere yanıt verir.

   • Varsayılan davranışı kullanmak istiyorsanız (Aracı seçer - Açıklamaya göre), aracınızın amacının kısa bir açıklamasını girin.
   • Aksi takdirde, Bu ne zaman kullanılacak? altındaki listeyi genişletin ve istediğiniz davranışı seçin. Desteklenen davranışlar hakkında daha fazla bilgi için Aracınızı ne zaman kullanacağınızı belirleyin bölümüne bakın.

5. Aracınızın çağrıldığında izlemesini istediğiniz açık yönergeleri girin. Yönergelerde araçlara, değişkenlere başvurmak veya Power Fx formülleri eklemek için bir eğik çizgi (/) girin ve görüntülenen menüden istediğiniz seçeneği belirtin.

   Önemli

   Yönergelerinizde mevcut araçlara başvururken, aracın doğrudan ana aracınız tarafından mı yoksa yalnızca yönergeler içinde açıkça çağrıldığında mı erişilebilir olması gerektiğine karar verin. Bir aracın kullanımını açık yönerge başvurularıyla sınırlamak, benzer araçlar veya aracılar mevcut olduğunda karışıklığı önlemeye yardımcı olur. Örneğin, "Hesap bakiyesini denetle" aracınız ve benzer bir "Hesap bakiyesini al" aracınız varsa, çakışmayı önlemek için aracı tarafından çağrılmasını kısıtlayın. Bir aracın yalnızca başka bir aracıdan referans verildiğinde kullanılabilir olmasını kısıtlamak için, aracın ayrıntı sayfasındaki Ek ayrıntılar bölümünde Aracının bu aracı ne zaman kullanacağına dinamik olarak karar vermesine izin ver özelliğini temizleyin.

6. İsteğe bağlı olarak, yalnızca bu alt aracının kullanabileceği bilgi ve araçları ekleyin:

   • Bilgi bölümünde, Ekle seçeneğini belirleyin ve ana aracınıza bilgi eklerken yaptığınız gibi aynı şekilde devam edin.
   • Araçlar bölümünde, Ekle seçeneğini belirleyin ve ana aracınıza araç eklerken yaptığınız gibi aynı şekilde devam edin.

7. Bu aracıyı henüz etkinleştirmek istemiyorsanız Etkin seçeneğini kapatın. Alt aracınızı daha sonra aktif hale getirebilirsiniz.

8. Kaydet'i seçin.

Giriş ve çıkışları yönetme

Varsayılan olarak, bir alt aracı, aracı çağırdığında ana aracıdan gerçekleştirmek için doğal bir dil görevi alır. Ardından, görevini tamamladığında, yürütmesi sırasında neler olduğunu içeren doğal bir dil özeti döndürür. Bazı durumlarda aracı için daha açık giriş ve çıkış değerleri belirtmek isteyebilirsiniz.

Girişleri yönetmek için

1. Alt aracı ayrıntılarına gidin.

2. Aşağı kaydırarak Girişler bölümüne gidin.

3. Giriş eklemek için Giriş Ekle'yi seçin. Aracının, bu aracıyı çağırırken giriş alanını ilgili bir değerle doldurabilmesi için girişin amacını anlamasına yardımcı olacak bir Görüntü adı ve Açıklama tanımlayın.

4. Bir Veri türü seçin.

5. İsteğe bağlı olarak, aracının çağrılabilmesi için girişin bir değere sahip olmasını zorunlu kılmak üzere Bu girişi zorunlu kıl seçeneğini belirleyin.

6. Kaydet'i seçin.

Not

İsteğe bağlı olarak Gelişmiş bölümünü genişletebilir ve Kullanıcıya sorulmalı mı seçeneği de dahil olmak üzere giriş için diğer ayarları yapılandırabilirsiniz. Ayar etkinleştirilirse aracı, kullanılabilir bağlamdan bulunamıyorsa, giriş için son kullanıcıdan açıkça bir değer ister. Girişler için diğer ayarlar hakkında daha fazla ayrıntı için bkz.

Çıkış listesini yönetmek için

1. Alt aracı ayrıntılarına gidin.

2. Aşağı kaydırarak Çıkışlar bölümüne gidin.

3. Mevcut çıktı listesini görmek için, Çıktılar bölümü içindeki Gelişmiş bölümünü genişletin.

4. Çıkış eklemek için Çıktı Ekle seçeneğini seçin. Aracının çıktının amacını anlamasına ve çağıran aracıya değerler döndürürken ilgili bir değerle doldurmasına yardımcı olacak bir Görüntü adı ve Açıklama tanımlayın.

5. Bir Veri türü seçin.

6. Kaydet'i seçin.

Çıkışlar bölümünde, alt aracınız tamamlandıktan hemen sonra kullanıcıya bir ileti gönderilmesini de seçebilirsiniz. İletiyi göndermek için Çalıştırıldıktan sonra seçimini değiştirin.

Aracınızın ne zaman kullanılacağını belirleme

Varsayılan olarak, alt aracılar açıklamalarına göre bir kullanıcı sorgusuna yanıt verir. Ayrıca, Bu ne zaman kullanılacak? altında alt aracıların diğer olayları yakalamasını ve bunlara yanıt vermesini de yapılandırabilirsiniz.

Etkinlik	Açıklama
Bir ileti alındı	En yaygın etkinlik türü olan mesaj etkinliği alındığında çağrılır. Bir kullanıcı aracıya bir şey yazdığında veya söylediğinde alınır. Varsayılan olarak, aracı tüm iletilere yanıt verir. Aracının yanıtını belirli bir mesaj türüyle sınırlandırmak için, Ek ayrıntılar altındaki Etkinlik türü listesini kullanın.
Özel bir istemci olayı gerçekleşir	Bir olay etkinliği alındığında çağrılır. Varsayılan olarak, aracı tüm etkinliklere yanıt verir. Aracının yanıtını belirli bir olayla sınırlandırmak için, Ek ayrıntılar altındaki Olay adı özelliğini kullanın.
Bir etkinlik gerçekleşir	Her türlü etkinlik alındığında çağrılır. Aracının yanıtını belirli bir etkinlik türüyle sınırlandırmak için, Ek ayrıntılar altındaki Etkinlik türü listesini kullanın.
Konuşma değişiklikleri	Konuşma güncelleştirme etkinliği alındığında çağrılır. Örneğin, bir kullanıcı bir konuşmaya katıldığında Teams bu türden bir etkinlik gönderir.
Çağrıldı	Bir çağırma etkinliği alındığında çağrılır. 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:	Aracı, bir konu içinden açıkça çağrıldığında çağrılır.
Kullanıcı bir süreliğine aktif değil	Kullanıcının yapılandırılmış bir süre boyunca ana aracıyla etkileşim kurmaması durumunda çağrılır. Ek bilgiler altında yer alan Etkin olmama süresi listesinden istediğiniz etkin olmama eşiğini seçin.
Bir plan tamamlandığında	Ana aracı, kullanıcı sorgusuna veya otonom tetikleyiciye yanıt vermek için planlanan tüm adımları tamamlamasının ardından çağrılır.
Yapay zeka tarafından oluşturulan bir yanıt gönderilmek üzere	Ana 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 çağrılır. 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 Mesaj düğümünü kullanarak kendi mesajınızı gönderirseniz), ContinueResponse değişkenini false olarak ayarlayın.

Diğer ayrıntılar

Bu ne zaman kullanılacak? seçeneğinize bağlı olarak daha fazla özellik mevcut olabilir. Aşağıdaki özellikler her zaman mevcuttur.

Koşul

Aracının çağrılabilmesi için karşılanması gereken koşulları belirtin. Örneğin, bir çalışanın kullandığı kanal Microsoft Teams ise aracının çağrılmasını isteyebilirsiniz.

Daha karmaşık koşullara ihtiyacınız varsa, Power Fx formül düzenleyicisine geçebilirsiniz: Oluşturucu'yu seçin ve ardından Formül'ü seçin.

Öncelik

Gelen tek bir etkinlik (örneğin ileti) için birden fazla aracı etkinleştirilebilir. Varsayılan olarak, Ne zaman kullanılacak? için belirlediğiniz seçenek aracıların tetiklenme sırasını belirler.

Alt aracılar ve konular, yanıt verebilecekleri aynı tetikleyici veya olay kümesini paylaşır. Bir aracı ve konu, kullanıcı etkinlik dışı gibi aynı olaya yanıt verecek şekilde yapılandırılmışsa, öncelik özelliğini kullanarak hangisinin önce gittiğini belirleyin.

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. Aracı seçer

Aynı olay türüne göre birden çok aracı veya konu çağrılmalıdırsa, bunlar oluşturma sırasına göre çağrılır (ilk olarak en eski).

Öncelik özelliğini açıkça ayarlayabilirsiniz. Daha düşük bir sayı daha yüksek bir önceliğe işaret eder.