Özelleştirilmiş aracılara araçlar ekleme

Araçlar, ajanınızın dış sistemlerle etkileşime girmesini sağlayan yapı taşlarıdır. Araçlar, ajanınızın yapabileceklerini genişleterek ajanınızın kullanıcı taleplerine veya otonom tetikleyicilere yanıt olarak çeşitli eylemler gerçekleştirmesine olanak tanır. Her araç, ajanınızın gerçekleştirebileceği belirli bir yetkinliği temsil eder. Örneğin, ajanınızı aşağıdaki gibi görevleri yerine getirecek araçlarla donatabilirsiniz:

• Office 365 Outlook bağlayıcısını kullanarak e-posta gönderme
• Geçerli hava koşullarını ve tahminlerini denetleme
• Dataverse'den veri okuma ve yazma
• Teams'e ileti okuma ve gönderme

Ajanlara araç ekleme mekanizmaları

Bir veya daha fazla araç ekleyerek özel aracınızın özelliklerini genişletebilirsiniz. Aracınız, oluşturucu düzenlemeyi kullanarak kullanıcılara otomatik olarak yanıt vermek için araçları kullanabilir. Ayrıca araçları bir konu içinden açıkça adlandırabilirsiniz.

Oluşturucu düzenleme ile (varsayılan olarak etkin), aracınız kullanıcıya yanıt vermek için otomatik olarak en uygun aracıyı veya konuyu seçebilir veya bilgi genelinde arama yapabilir. Bu düzenleme modu daha dinamik ve akıllı bir konuşma deneyimi oluşturur.

Klasik modda (üretken orkestrasyon kapalı), bir ajan yalnızca kullanıcıya yanıt vermek için konular kullanabilir. Ancak yine de aracınızı, araçlarınızı açıkça konuların içinden çağıracak şekilde tasarlayabilirsiniz.

Temsilcinize araçlar eklemek için kullanabileceğiniz çeşitli mekanizmalar vardır.

• Bağlayıcı: Verileri çekmek veya eylemleri gerçekleştirmek için Power Platform Bağlayıcıları'nı kullanarak üzerinde mülkiyet hakları bulunan API'lere ve hizmetlere bağlanın.
  • Önceden oluşturulmuş bağlayıcı: Hem Microsoft hem de Microsoft dışı hizmetlerden binlerce popüler API'ye önceden ayarlanmış bağlantılar arasından seçim yapın.
  • Özel bağlayıcı: Power Platform Bağlayıcıları'nı kullanarak özel araç seçeneklerini etkinleştirmek için özel bir hizmete veya sisteme bağlantı tanımlayın. Aracının bağlayıcıyı kullanabilmesi için bağlayıcının kuruluş için görüntüleme ve paylaşım izinlerine ihtiyacı vardır.
• Aracı akışı: Gerçekleştirilecek bir veya daha fazla eylem içeren bir aracı akışı tanımlayın.
• İstem: Sağladığınız bilgilere başvurabilen ve verileri analiz etmek için kod oluşturabilen tek dönüşlü model tabanlı istem.
• REST API: REST API'ye bağlantı tanımlayın ve araç olarak eklemek için bir veya daha fazla API uç noktası ve yöntemi seçin.
• Model Bağlam Protokolü: Araçlara ve kaynaklara erişmek için bir MCP sunucusuna bağlanın.
• Bilgisayar kullanımı: Aracınızın web siteleri ve masaüstü uygulamaları için grafik kullanıcı arabirimi olan herhangi bir sistemle etkileşim kurmasına, düğmeleri seçmesine, menü seçmesine ve ekrandaki alanlara metin girmesine olanak tanır.

Temsilcinize araç benzeri davranışlar ekleyebileceğiniz iki mekanizma vardır:

• Beceriler: Bir dizi ilgili araç için kap.
• İstemci aracı: İstemcinin bir eylem gerçekleştirmesi ve yanıt döndürmesi için istemciye bir olay etkinliği gönderin.

Beceriler ve istemci araçları hakkında daha fazla bilgi için İlgili içerik bölümündeki bağlantılara bakın.

Ajan düzeyinde yeni bir araç oluştur ve ekle

Doğrudan Copilot Studio'da yeni araçlar oluşturmak geliştirme sürecini kolaylaştırır ve temsilcinizle doğru tümleştirmeyi sağlar. Bir araca eklenen araçlar, aracınızın konuşmaları boyunca otomatik orkestrasyon için kullanılabilir.

1. Sol taraftaki gezinme bölmesinde Aracılar'ı seçip listeden aracınızı seçerek aracınızı açın.

2. Ajan için Araçlar sayfasına gidin.

3. Araç ekle'yi seçin.

4. Araç ekle bölmesinde Yeni araç'ı seçin.

5. Görüntülenen listeden eklemek istediğiniz araç türünü seçin:

   • Uyarı
   • Aracı akışı
   • Bilgisayar kullanımı
   • Özel bağlayıcı
   • Model Bağlam Protokolü
   • REST API

   

6. Seçtiğiniz araç türüne özgü yapılandırma adımlarını gerçekleştirin. Örneğin, İstem'i seçtiğinizde aşağıdaki adımları uygulamanız gerekir:

   • İstem şablonunu ve yönergeleri tanımlama
   • Giriş parametrelerini belirtme
   • Bilgi kaynaklarını yapılandırma
   • Yanıt biçimini ve kısıtlamalarını ayarlama

7. Yeni aracı oluşturmak için uygun olan Kaydet veya Yayımla seçeneğini seçin.

8. Ekle ve yapılandır'ı seçin. Araç aracınıza eklenir. Aracınızın yapılandırma sayfası görüntülenir. Burada araç yapılandırmanızı burada görüntüleyebilir ve yapılandırmada değişiklik yapabilirsiniz.

Ajan için Araçlar sayfasında yeni aracı görebilirsiniz.

Araç yapılandırmanızı görüntüleme ve bu yapılandırmada değişiklik yapma

İstediğiniz zaman aracının yapılandırmasını görüntüleyebilir ve düzenleyebilirsiniz: Aracınızın Araçlar sayfasına gidin ve araç listesinden aracıyı seçin.

Aracınızın yapılandırma sayfası açılır. Ayrıntılar üç bölümde görüntülenir:

• Ayrıntılar
• Girişler
• Completion

Aracı araçları olarak bağlanan MCP sunucuları için yapılandırma sayfası diğer araç türlerinden farklıdır. Ayrıntılar bölümü benzerdir, ancak Girişler ve Tamamlama yerine MCP sunucusu için kullanılabilir araçlar ve kaynaklar hakkında bilgi içeren Araçlar ve Kaynaklar bölümleri vardır. Daha fazla bilgi için Mevcut bir MCP sunucusundaki araçları ve kaynakları görüntüleme bölümüne bakın.

Ayrıntılar

Ayrıntılar bölümü, aracınızla ilgili temel ayrıntıları yapılandırmanıza olanak tanır.

Burada şunları görüntüleyebilir ve güncelleştirebilirsiniz:

• Ad: Aletin adı. Bu isim, temsilcinizin araçlar listesinde görünmektedir. Aracın işlevini açıkça gösteren bir ad seçin.

• Açıklama: Aracın açıklaması. Üretken düzenleme, ajanınızın aracı ne zaman kullanması gerektiğini belirlemek için bu açıklamaya dayanır. Aracın ne yaptığı ve ne zaman kullanılması gerektiği de dahil olmak üzere net, belirli açıklamalar yazın.

• Ek ayrıntılar:

  • Aracının ne zaman kullanılacağına dinamik olarak karar vermesine izin ver: Bu seçenek belirlendiğinde aracı, aracın ne zaman kullanılacağını belirlemek için oluşturucu düzenlemeyi kullanabilir. Bu seçenek belirtilmemişse aracı aracıyı yalnızca bir konudan açıkça çağrıldığında kullanır. (Bu seçenek, üretken düzenleme etkinleştirildiğinde varsayılan olarak seçilidir.)
  • Çalıştırmadan önce son kullanıcıya sorun: Son kullanıcı sohbet deneyiminde aracıyı çalıştırmadan önce onay isteyin. Bu seçenek varsayılan olarak Hayır olarak ayarlanır.
  • Kimlik doğrulaması: Araç için kullanıcının (Son kullanıcı) veya oluşturucunun (Oluşturucu tarafından sağlanan) kimlik bilgilerini kullanmayı seçin. Varsayılan olarak, kullanıcı kimlik doğrulaması uygulanır.
  • Açıklama: İsteğe bağlı olarak, aracı çalıştırmak istediğinde aracının kullanıcıya gösterdiği aracın açıklamasını ekleyebilirsiniz. Bu açıklama, kullanıcının kimlik doğrulamasından ne istenmekte olduğunu bilmesini sağlar.

Girişler

Burada, aracınız için girişleri görüntüleyebilir ve yapılandırabilirsiniz. Girişler, araç için gerekli girişleri doldurmak üzere kullanıcıdan bilgi toplamak için kullanılır. Bilgiler, her giriş için bir satır olmak üzere bir tablo olarak görüntülenir.

Varsayılan olarak, her giriş için Kullanarak Doldur sütun değeri Yapay zeka ile dinamik olarak doldur şeklinde ayarlanır. Aracı, değeri kullanılabilir bağlamdan (örneğin, kullanıcının iletisinden) ayıklamaya çalışır. Uygun bir değer bulunamazsa, kullanıcıdan bir değer istemek için bir soru oluşturur. Giriş toplama ve doldurma için daha ayrıntılı özelleştirmelere erişmek için Özelleştir'i seçin:

• Görünen ad ve Açıklama: Girişin kullanıcıya nasıl sunulduğu.
• Şu şekilde tanımlayın: Kullanıcının yanıtının nasıl yorumlandığı, örneğin metin dizesi olarak veya önceden tanımlanmış bir varlığa eşlendiği.
• Yeniden deneme mantığı: Aracı kullanıcının deyimindeki bir varlığı tanımlamazsa soruyu yeniden sorabilir.
• Giriş doğrulama: Kullanıcının girişinde varlık türü için varsayılanın ötesinde ek doğrulama davranışı yapılandırın.

Ayrıca, bir girişi aracının ayıklamasına izin vermek yerine açık bir değerle geçersiz kılmayı da seçebilirsiniz. Bir geçersiz kılma ayarlamak için Şunu kullanarak doldur öğesini Özel değer olarak ayarlayın ve bir değer girin, bir değişken seçin veya bir Power Fx formülü kullanın. Bir giriş geçersiz kılınırsa, aracı kullanıcıdan bir değer istemez.

Completion

Burada, aracın çalışması bittiğinde ne olmasını istediğinizi seçebilirsiniz.

Aracının, sorgusunu ve aracın sonucunu temel alarak kullanıcı için otomatik olarak bağlamsal bir yanıt oluşturmasını sağlayabilirsiniz.

Alternatif olarak, aracının döndürmesi için belirli, biçimlendirilmiş bir yanıt yazmayı seçebilirsiniz. Değişken seçiciyi kullanarak araçtan çıkış değişkenlerine başvurular yerleştirebilirsiniz. Yanıtı biçimlendirmek için Power Fx formüllerini de kullanabilirsiniz.

Çalıştırdıktan sonra altında, araç çalıştırıldıktan sonra aracın kullanıcıya nasıl yanıt vereceğine ilişkin birkaç farklı seçenek arasından birini seçin:

• Yanıt verme (varsayılan): Aracı, araç çıkışını yanıtına dahil eder
• Yanıtı üretken yapay zeka ile yazma: Yapay zekanın araç çıkışlarını kullanarak bağlamsal bir yanıt oluşturmasına izin verin
• Belirli bir yanıt gönder: Değişken ekleme ile şablonlu yanıt yazma
• Uyarlamalı kart gönderme: Düğmeler ve eylemlerle zengin, etkileşimli yanıtlar oluşturma

Aracı ve diğer araçlar için hangi çıkış değişkenlerini kullanılabilir hale getirebileceğinizi de yapılandırabilirsiniz.

Araç seçimi ve giriş koleksiyonu

Copilot Studio'da bir araç tanımladığınızda, amacını açıklayan bilgiler de sağlarsınız. Bu bilgiler, aracının aracı ne zaman kullanacağını belirlemesine olanak tanır. Araç açıklaması, düzenleyicinin gerektiğinde giriş toplamak için üretken yapay zeka kullanarak sorular oluşturmasına da yardımcı olur. Aracınız, aracı kullanmak için gereken girişleri doldurmak üzere bilgi toplamak için soruları kullanabilir. Sonuç olarak, bir akıştaki girişler gibi gereken tüm girişleri toplamak için soru düğümlerini el ile yazmanız gerekmez. Aracı düzenleyici, çalışma zamanında sizin için giriş koleksiyonunu işler.

Aracı, araç seçimini belirlemek için çeşitli faktörleri göz önünde bulundurur:

• Aracın adı ve açıklaması
• Geçerli konuşma bağlamı
• İletilerinden türetilen kullanıcı amacı
• Kullanılabilir girişler ve çıkışlar
• Konuşmada daha önce kullanılan araçlar

Üretken mod kullanıldığında, araçlar varsayılan olarak bilgilerini ajana geri döndürür. Aracı, araç yanıtıyla kullanıcının sorgusuna bağlamsal bir yanıt oluşturabilir. Alternatif olarak, aracınıza her zaman hemen yanıt vermesini ve bir ileti oluşturmasını veya açık bir ileti yazmasını da bildirebilirsiniz.

Tavsiye

Bir araçtan oluşturulan soruları kullanırken kullanıcılarınızı, konuşmanın bir kısmının yapay zeka tarafından oluşturulduğu konusunda bilgilendirin.

Örneğin, Konuşma Başlatma sistemi konusuna ek bir ileti ekleyin. Bu konu, yeni bir görüşme başladığında kullanıcılarınıza gösterilen iletiyi belirler.

Bir konunun içinden mevcut bir aracı çağırma

Bir konudan aracı açıkça çağırabilirsiniz. Kullanım durumunuza bağlı olarak, aracınızı daha geniş bir konunun parçası olarak kullanabilirsiniz; bu konuda birden fazla düğüm var. Ya da, aşağıdaki örnekte olduğu gibi, bir konuya tek bir eylem (araç) düğümü eklemek ihtiyacınız olan tek şey olabilir.

Bir aracı bir konu içinden çağırmak için:

1. Copilot Studio'da, düzenlemek istediğiniz aracının Konular sayfasına gidin.

2. Yeni bir konu oluşturun ve ona bir ad verin, örneğin, Hava durumunu al.

3. Uygun Tetikleme tümcecikleri ekleyin. Önceki adımdaki aynı hava durumu örneğine devam etmek için tetikleme tümcecikleri şunları içerebilir:

   • yağmur yağacak mı
   • bugünün hava tahmini
   • hava durumunu al
   • hava nasıl

4. Düğüm ekle (+) seçeneğini ve ardından Araç ekle seçeneğini seçin.

5. Kullanılabilir araçlardan aracı seçin. Farklı araç türlerini gösteren üç sekme vardır:

   • Temel araçlar
   • Connector
   • Tool

   Eylem düğümünüz artık konunuza eklenir.

6. Kaydetseçeneğini seçin.

MCP bağlayıcı bilgileri

MCP bağlayıcısı için, MCP bağlayıcısı tarafından sağlanan MCP araçlarının ve kaynaklarının adlarını ve açıklamalarını görüntüleyebilirsiniz. Araçlar ve kaynaklara ilişkin bilgiler, her araç için bir satır olmak üzere bir tabloda görüntülenir.

Araçlar için kimlik doğrulamasıyla ilgili dikkat edilmesi gerekenler

Bazı araçlar, Dinamik İstem veya Dataverse API'sini çağıran diğerleri gibi kimlik doğrulamasının düzgün çalışmasını gerektirir. Düzgün kimlik doğrulaması yapılandırması, sorunsuz bir kullanıcı deneyimi sağlarken güvenliği sağlar.

Araçlar her zaman aracının çalışma zamanında kullanıcı bağlamında çalıştırılır ve kimlik doğrulaması etkinleştirilmediği sürece çalıştırılamaz. İki farklı kimlik doğrulaması türü desteklenir:

• Son kullanıcı kimlik bilgileri: Aracı, serviste kimlik doğrulaması yapmak için kullanıcının kimlik bilgilerini kullanır. Bu yöntem kullanıcıların yalnızca görme yetkileri olan verilere erişmesini sağlar.
• Oluşturucu tarafından sağlanan kimlik bilgileri: Aracı, hizmette kimlik doğrulaması yapmak için yazarının kimlik bilgilerini kullanır. Paylaşılan kaynaklar için veya kullanıcıların bireysel erişime ihtiyaç duymaması gerektiğinde bu kimlik doğrulama modunu kullanın.

Aracınızı test edin

Üretici orkestrasyon ile, düzenleyici aracınızı, bir kullanıcı sorgusuyla ilgili olduğunu düşündüğünde seçer.

Alternatif olarak, bir konunun içinden mevcut bir aracı çağırabilirsiniz.

Aracınızda aracı açma veya kapatma

Aracınız için bir aracı, araç yapılandırma sayfasından açabilir veya kapatabilirsiniz. Bir aracı kapatmak, aracının bu aracı kullanmasını engeller, ancak araç yine aracıya bağlıdır ve daha sonra yeniden açılabilir. Bir aracı bir ajana eklediğinizde, araç varsayılan olarak açık olur.

Aracıdaki bir aracı kapatmak için:

1. Aracınıza gidin ve aracınız için Ayarlar sayfasını seçin.
2. Araç yapılandırma sayfasına gitmek için aracı seçin.
3. Yapılandırma sayfasının üst kısmında Etkin geçişini kullanarak aracı kapatın.
4. Değişikliği uygulamak için Kaydet'i seçin .

Araç, aracı araçları listesinde görünmeye devam eder ancak artık açık değildir.

Aracınızdan araç silme

Bir aracın kapatılması aracın kullanılmasını engeller, ancak daha sonra yeniden açma esnekliği de sağlar. Aracınızdan bir aracı, daha kalıcı olarak kaldırabilirsiniz. Aracınızdan araç silmek için:

1. Aracınıza gidin ve aracınız için Ayarlar sayfasını seçin.
2. Araç listesinden aracı bulun ve araç adının üzerine gelin. Üç noktayı (...) seçin.
3. 'ı seçin,'i silin. Bir onay penceresi görüntülenir.
4. Aracı kaldırmak için Sil'i seçin.

Araç, aracı araçları listesinden kaybolur.

Uyarı

Araçları yalnızca aracı araçları sayfasından silebilirsiniz. Araçları, ana Copilot Studio Araçları sayfasından silemezsiniz.

Ajanlarda araç kısıtlamaları

• Üretken orkestrasyon kullanılırken, orkestratör her ajan başına maksimum 128 araç kullanabilir. Ancak en iyi performans ve sonuçlar için, ajanınızdaki araç sayısını 25-30'dan fazla olmamasını öneririz.
• Çocuk ajanlarla çoklu ajan düzenleme kullanılırken, çocuk ajanların kendi orkestrasyonları vardır ve 128'e kadar araç setini yönetebilirler.

İlgili içerik

• Bağlayıcıları kullanma
• İstemleri kullanma
• Aracı akışlarını aracınızla kullanma
• Model bağlam protokolü (MCP)
• REST API'den araç ekleme
• Becerileri kullanma
• İstemci araçları
• Bilgisayar kullanımı (önizleme)