Azure AI aracısına araç ekleme

Tamamlandı

Tip

Daha fazla ayrıntı için Metin ve resimler sekmesine bakın!

Aracınızın eylem gerçekleştirmesine olanak sağlayan araçlardır: API'leri çağırma, kod yürütme, dosya arama veya dış hizmetlerle etkileşim kurma. Araçlar olmadan bir ajan, yalnızca halihazırda bildiklerine dayanarak metin üretebilir. Araçlar sayesinde, dünya üzerinde eylemde bulunma yeteneği kazanır.

Microsoft Agent Framework iki geniş araç kategorisini destekler: sağlayıcı tarafından barındırılan ve yönetilen hizmet tarafından sağlanan araçlar ve kendiniz yazıp aracıya kaydettiğiniz özel işlev araçları.

Hizmet tarafından sağlanan araçlar

Foundry sağlayıcısı kullanılırken, ek uygulama olmadan bir dizi barındırılan araç kullanılabilir. Bunları ajan yapılandırmasına ekleyerek etkinleştirirsiniz; asıl yürütmeyi sağlayıcı gerçekleştirir.

Hizmet tarafından sağlanan en yaygın araçlar şunlardır:

Araç	Ne işe yarıyor?
Kod Yorumlayıcısı	Hesaplamalar ve veri analizi için korumalı bir ortamda Python kodu yürütür
Dosya Arama	Yüklenen belgelerde arama yapar ve bu belgelerden bilgi getirir
Web Araması	İnternetten güncel bilgileri alır
Barındırılan MCP Araçları	Doğrudan sağlayıcı çalışma zamanı tarafından çağrılan MCP (Model Bağlam Protokolü) sunucuları
Azure AI Arama Hizmeti	Foundry bağlantısı aracılığıyla bir Azure Yapay Zeka Arama dizinini sorgular
Foundry Araç Kutuları	Foundry projesinde yönetilen barındırılan araç yapılandırmalarının adlandırılmış, sürümlenmiş paketleri

Note

Azure Yapay Zeka Arama, Bing Topraklama, SharePoint ve diğerleri gibi bazı araçlar önizleme aşamasında veya deneyseldir. Bunlar Foundry ajanları için kullanılabilir, ancak diğer sağlayıcılarda destekleri sınırlı olabilir.

Özel işlev araçları

Özel işlev araçları, iç API'leri çağırma, veritabanlarını sorgulama, hesaplamalar yapma veya bir Python işlevinin gerçekleştirebileceği diğer işlemler gibi ihtiyacınız olan tüm mantıklarla aracınızı genişletmenize olanak tanır.

Bir işlevi araç olarak kaydetmek için, oluşturulurken doğrudan aracıya iletirsiniz. Çerçeve işlevin imzasını inceler ve modele işlevin ne yaptığını, hangi parametreleri beklediğini ve ne döndürdüğünü bildiren bir şema oluşturur.

Modelin bir aracı güvenilir bir şekilde çağırması için işlevinizin açıkça açıklanması gerekir. Aracı Çerçevesi iki yaklaşımı destekler:

• Açıklamalarla ek açıklamalar yazın; her parametrede bir alan açıklamasıyla Python Annotated türünü kullanın. İşlevin docstring'i, araç açıklaması olarak kullanılır.
• Dekoratör@tool, aracın adını ve açıklamasını açıkça dekoratör bağımsız değişkenleri olarak belirterek modelin gördükleri üzerinde tam denetim sahibi olmanıza izin verir. Giriş yapısı üzerinde kesin denetime ihtiyacınız varsa Pydantic modeli kullanarak açık bir şema da sağlayabilirsiniz.

Her iki durumda da çerçeve şema oluşturmayı ve araç çağırmayı otomatik olarak işler. Model bir aracın çağrılması gerektiğini belirlediğinde, çerçeve işlevi yürütür ve son yanıt oluşturulmadan önce sonucu modele geri döndürür.

Birden çok araç ekleme

Birden çok aracıyı tek bir aracıya kaydedebilirsiniz. Aracıyı oluştururken işlevlerin listesini geçirin ve model konuşmanın her bölümü için otomatik olarak en uygun aracı seçer. Herhangi bir yönlendirme mantığı yazmanız gerekmez; çerçeve, konuşma bağlamını ve sağladığınız araç açıklamalarını temel alarak araç düzenlemesini işler.

Araç onayı

Araç çağrılarının yürütmeden önce insan incelemesi gerektirmesi gereken senaryolar için, Aracı Çerçevesi bir araç onay desenini destekler. Bir araçta onay modu etkinleştirildiğinde, ajan bu işlevi çağırmadan önce duraklar ve onay ister. Bu, geri alınamaz, pahalı olan veya hassas veriler içeren eylemler için kullanışlıdır. Onay davranışı, dekoratördeki approval_mode@tool parametresi kullanılarak araç başına yapılandırılabilir.

Bir aracı araç olarak kullanmak

Aracılar, bir aracı başka bir aracının aracı olarak kullanarak oluşturulabilir. bir iç aracıyı bir işlev aracısına dönüştürür ve bir dış aracıya geçirirsiniz; bu da belirli görevleri ona devredebilir. Bu, özel aracıların belirli etki alanlarını işlediği modüler tasarımlara olanak tanır ve bir eşgüdümlü aracı istekleri aralarında yönlendirir. Bu, çok aracılı modülde daha ayrıntılı bir şekilde incelenen bir desendir.

Özel araçlar için en iyi yöntemler

• Net açıklamalar yazın; modelin doğru aracı seçebilmesi tamamen sağladığınız açıklamalara bağlıdır. İşlevin ne yaptığını ve ne zaman kullanılması gerektiğini açıklayın.
• Her parametreye açıklama ekleyin; modelin geçerli çağrılar oluşturabilmesi için her girişi açıklayın; özellikle parametre adları tek başına açıklayıcı olmadığında.
• Anlamlı veriler döndürün; araçlar yapılandırılmış, yorumlanabilir çıkış döndürmelidir. Model, yanıtını oluştururken doğrudan dönüş değerini kullanır.
• Araçları odaklanmış tutun; her araç tek bir şeyi iyi yapmalıdır. Birden çok sorumluluğu tek bir işlevde birleştirmek, modelin doğru şekilde çağırmasını zorlaştırır.
• Hataları düzgün bir şekilde işleyin; bir araç beklenmeyen bir girişle karşılaşırsa veya bir dış hizmet başarısız olursa, modelin yararlı bir şekilde yanıt verebilmesi için özel durum oluşturmak yerine bilgilendirici bir hata iletisi döndürün.