Aracılığıyla paylaş

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

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ç, ajanınızın gerçekleştirebileceği belirli bir yetkinliği temsil eder. Örneğin, ajanınızı aşağıdakiler gibi işlevleri gerçekleştiren 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ı

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, bir konunun içinden araçları açıkça çağı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.

  • Ö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ı akışı: Gerçekleştirilecek bir veya daha fazla eylem de dahil olmak üzere bir aracı akışı tanımlayın.
  • İstem: Sağladığınız bilgilere başvurabilen tek dönüşlü model tabanlı istem.
  • REST API bağlantısı: 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ü (MCP) aracı: Araçlara erişmek için bir MCP sunucusuna bağlanın.
  • Bilgisayar kullanımı (önizleme) aracısı: 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.

Bu makaledeki araçlardan ve belgelerin bu bölümünden söz ettiğimizde, bu gruptaki mekanizmalardan birini kastediyoruz. Bu araç türleri aracınıza eklenebilir ve benzer yollarla yapılandırılabilir.

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:

    • İstem: Yapay zeka destekli metin oluşturma ve analiz araçları oluşturma
    • Aracı akışı: Koşullu mantık ile çok adımlı işlemler oluşturma
    • Bilgisayar kullanımı: Eski sistemler için GUI otomasyonlarını etkinleştirme
    • Özel bağlayıcı: Özel API'lere ve hizmetlere bağlanma
    • REST API: Web hizmetleriyle doğrudan tümleştirme

  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. Beklendiği gibi çalıştığından emin olmak için önizleme panelini kullanarak araç yapılandırmanızı test edin.

  8. Yeni aracı oluşturmak için Kaydet'i seçin.

  9. Aracınıza aracı eklemek için Aracıya ekle'yi seçin. 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.

Araç ayrıntıları sayfası açılır ve aracının yapılandırmasını gösterir. Ayrıntılar üç bölümde görüntülenir:

  • Ayrıntılar
  • Girişler
  • Tamamlama (MCP bağlayıcıları için araçlar)

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 veya oluşturucunun kimlik bilgilerinin kullanılıp kullanılmayacağını seçin. Varsayılan olarak, kullanıcı kimlik doğrulaması uygulanır.
    • Açıklama: İsteğe bağlı olarak, araç çalıştırıldığında kullanıcıya gösterilen 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.

Tamamlanma

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 ne zaman kullanılacağını belirlemesine ve soru oluşturmak için üretken yapay zeka kullanmasına olanak tanır. Bu sorular, aracı gerçekleştirmek için gereken girişleri doldurmak için bilgi toplamak için kullanılır. Sonuç olarak, bir akıştaki girişler gibi gereken tüm girdileri toplamak için soru düğümlerini el ile yazmanız gerekmez. Giriş toplama, çalışma zamanında sizin için işlenir.

Aracı, araç seçimini belirlemek için çeşitli etmenler kullanır:

  • 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

Varsayılan olarak, oluşturucu modu kullanırken araçlar bilgilerini aracıya geri döndürür, böylece aracı 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.

İpucu

Bir araçtan oluşturulan soruları kullanırken, kullanıcılarınıza konuşmanın bir bölümünün yapay zeka tarafından oluşturulduğunu bildirin.

Ö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 örneğine bağlı olarak, daha fazla düğüm kullanan daha geniş bir konunun parçası olarak aracınızı kullanabilirsiniz. Veya hava durumu örneğinde olduğu gibi, bir konuya düğüm eklemek ihtiyacınız olan tek şey olabilir.

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

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

  2. Yeni bir konu oluşturun ve Hava durumunu al olarak adlandırın.

  3. Aşağıdaki Tetikleme tümcecikleri'ni ekleyin:

    • 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. Kullanılabilir araçlardan aracı 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 eklenir.

  5. Kaydet'i seçin.

Araçlar (yalnızca MCP bağlayıcıları)

Araçlar'ın altında, MCP bağlayıcısı için kullanılabilen araçların adlarını ve açıklamalarını görüntüleyebilirsiniz. Araçlar, her araç için bir satır olmak üzere bir tabloda görüntülenir. Her araç için şunları görebilirsiniz:

  • Araç adı ve sürümü
  • Giriş ve çıkış parametreleri
  • Tahmini yürütme süresi
  • Kullanım istatistikleri

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:

  • Kullanıcı kimlik doğrulaması: Aracı, hizmette 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.
  • Copilot yazar kimlik doğrulaması: Aracı, hizmette kimlik doğrulaması yapmak için kendi 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.

İlgili içerik