Özel aracılara araçlar ekleyin

Araçlar, aracınızın dış sistemlerle etkileşim kurmasını sağlayan yapı taşlarıdır. Araçlar, aracınızın işlevselliğini genişleterek kullanıcı isteklerine veya otonom tetikleyicilere yanıt olarak çeşitli eylemler gerçekleştirmesini sağlar. Her araç, aracınızın gerçekleştirebileceği belirli bir yeteneği temsil eder. Örneğin, aracınızı aşağıdaki gibi şeyler yapan 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

Araç ekleme mekanizmaları

Özel aracınızın yeteneklerini bir veya daha fazla araç ekleyerek 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, bir konunun içinden araçları açıkça çağırabilirsiniz.

Üretken düzenleme (varsayılan olarak etkin) ile aracınız bir kullanıcıya yanıt vermek için en uygun aracı veya konuyu otomatik olarak seçebilir ya da bilgiler arasında arama yapabilir. Bu düzenleme modu daha dinamik ve akıllı bir konuşma deneyimi oluşturur.

Klasik modda (üretken düzenleme kapalı), bir aracı 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.

Aracınıza araç 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'tan hem de Microsoft hizmetleri olmayan 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.

Aracınıza araç benzeri davranışlar eklemek için kullanabileceğiniz iki mekanizma daha vardır:

• Beceriler: Bir dizi ilgili araç için kap.
• İstemci aracı: İstemcinin bir eylem gerçekleştirmesi ve bir yanıt döndürmesi için istemciye bir olay aktivitesi 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.

Aracın seviyesinde yeni bir araç oluşturma ve ekleme

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 düzenleme 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. Aracınızın 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:

   • İstem
   • 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çerseniz aşağıdaki adımları gerçekleştirmeniz gerekir:

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

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.

Yeni aracı, aracının Araçlar sayfasında görebilirsiniz.

Araç yapılandırmanızı görüntüleyin ve değişiklik yapın

İ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ı 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
• Tamamlama

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:

• Name: Aracın adı. Bu ad, aracınız için araçlar listesinde görünür. Aracın işlevini açıkça gösteren bir ad seçin.

• Açıklama: Aracın açıklaması. Üretken düzenleme, aracı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 aracı 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 üretken düzenlemeyi kullanabilir. Bu seçenek belirtilmemişse aracı, yalnızca bir konudan açıkça çağrıldığında aracı 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ı çalıştırmadan önce aracıdan onay isteyin. Bu seçenek varsayılan olarak Hayır olarak ayarlanmıştı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 girdi için Şunu kullanarak doldur sütun değeri AI ile dinamik olarak doldur olarak 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. Özelleştir'i seçin: Giriş toplama ve doldurma için daha ayrıntılı özelleştirmelere erişmek iç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ığı: Eğer aracı, kullanıcının ifadesinde bir varlık tanımlayamazsa soruyu tekrar 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.

Tamamlama

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ızın iadesi 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, aracın çalıştırıldıktan sonra kullanıcıya nasıl yanıt vermesi gerektiğine ilişkin birkaç farklı seçenekten birini seçin:

• Yanıt verme (varsayılan): Aracı, araç çıkışını yanıtına dahil eder
• Yanıtı üretici AI ile yazın: AI'nın araç çıktılarıyla bağlamsal bir yanıt oluşturmasına izin verin
• Belirli bir yanıt gönder: Değişken ekleme ile şablonlu bir yanıt yazın
• Uyarlamalı kart gönderme: Düğmeler ve eylemlerle zengin, etkileşimli yanıtlar oluşturun

Ayrıca, aracu ve diğer araçlar için hangi çıkış değişkenlerinin kullanılabilir hale getirileceğini de yapılandırabilirsiniz.

Araç seçimi ve giriş toplama

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ı
• Mevcut konuşma bağlamı
• İletilerinden türetilen kullanıcı amacı
• Mevcut girişler ve çıkışlar
• Konuşmada önceki araç kullanımı

Üretici mod kullanıldığında, varsayılan olarak, araçlar bilgilerini aracıya geri döndürür. Aracı, araç yanıtıyla kullanıcının sorgusuna bağlamsal bir yanıt oluşturabilir. Alternatif olarak, bir ileti oluşturarak veya açık bir ileti yazarak aracınıza her zaman hemen yanıt vermesi talimatını verebilirsiniz.

Bahşiş

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 sistem konusuna ek 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 araç, bir konu içinden açıkça çağrılabilir. Kullanım durumunuza bağlı olarak, aracınızı daha fazla düğüm kullanan daha geniş bir konunun parçası olarak kullanabilirsiniz. Veya hava durumu örneğinde olduğu gibi, ihtiyacınız olan tek şey bir konuya düğüm eklemek 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. Mevcut araçlardan birini seçin. Farklı araç türlerini gösteren üç sekme vardır:

   • Temel araçlar
   • Bağlayıcı
   • Araç

   Eylem düğümünüz artık konunuza eklenmiştir.

5. Kaydet'i seçin.

MCP bağlayıcısı 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

Dinamik İstem veya Dataverse API'sini çağıran diğerleri gibi bazı araçların düzgün çalışması için kimlik doğrulaması gerekir. Düzgün kimlik doğrulaması yapılandırması, sorunsuz bir kullanıcı deneyimi sunarken güvenliği de 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ştirilmedikçe ç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 yetkisine sahip oldukları 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

Üretken düzenleme ile düzenleyici, bir kullanıcı sorgusu ile alakalı olduğunu düşündüğü zaman aracınızı seçer.

Alternatif olarak, bir konu 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. Aracıya bir araç eklediğinizde araç, varsayılan olarak açılır.

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. Sil'i seçin. Bir onay penceresi görüntülenir.
4. Aracı kaldırmak için Sil'i seçin.

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

Not

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

İ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çlar ekleme
• Becerileri kullanma
• İstemci araçları
• Bilgisayar kullanımı (önizleme)