Foundry aracısında OpenAPI olarak App Service aracı

OpenAPI kullanarak özelliklerini Foundry Agent Service'e sunarak mevcut web uygulamalarınızı güçlendirin. Birçok web uygulaması zaten REST API'leri sağlayarak REST API'lerini araç olarak çağırabilen aracılarla tümleştirme için ideal adaylar haline getirir. Foundry Agent Service'i bu API'lere bağlayarak, az kodla hızlı bir şekilde güçlü, zengin özelliklere sahip aracılar oluşturabilirsiniz.

Genel Bakış

OpenAPI belirtimleri REST API'lerini standartlaştırılmış, makine tarafından okunabilir bir biçimde açıklar. Foundry Agent Service, web uygulamanızın özelliklerini yapay zeka aracıları içindeki araçlar olarak otomatik olarak bulmak ve çağırmak için bu belirtimleri kullanabilir. Bu yaklaşım şunları yapmanızı sağlar:

  • Mevcut API'lerden yararlanma: Geçerli REST uç noktalarınızı kod değişikliği olmadan yapay zekayla erişilebilir araçlara dönüştürün
  • API standartlarını koruma: Hem insan hem de yapay zeka tüketicilerine hizmet veren endüstri standardı OpenAPI belirtimlerini kullanın
  • Hızlı tümleştirmeyi etkinleştirme: OpenAPI belirtiminizi güncelleştirerek aracılara yeni özellikler ekleme
  • İş mantığını koruma: Mevcut uygulama kodunuzu, güvenliğinizi ve veri erişim desenlerinizi değişmeden tutun
  • Yönetilen hizmetlerle ölçeklendirme: Foundry Agent Service'in yerleşik ölçeklenebilirliğini ve güvenilirliğini kullanma

Çoğu modern web uygulaması temel işlevleri için REST API'lerini kullanıma sağladığından bu düzen özellikle güçlüdür. Bu API'leri OpenAPI belirtimleriyle belgeleyerek, akıllı aracılar için yapı taşları olarak hemen kullanılabilir hale getirirsiniz.

OpenAPI araçları ne zaman kullanılır?

Aşağıdaki durumlarda App Service uygulamanızı Foundry aracıları için bir OpenAPI aracı olarak kullanıma sunmayı göz önünde bulundurun:

  • Mevcut REST API'leriniz var: Uygulamanız zaten iyi tanımlanmış HTTP uç noktaları sağlıyor
  • Hızlı aracı geliştirmesi istiyorsunuz: En az özel kodla hızlı bir şekilde işlevsel aracılar oluşturmanız gerekir
  • Bildirim temelli araç tanımlarına ihtiyacınız var: Özellikleri programlama yerine belirtimler aracılığıyla açıklamayı tercih ediyorsunuz
  • Birden çok aracıyı desteklemek istiyorsunuz: Aynı API'ler farklı düzenlemeye sahip birden çok aracı senaryosuna hizmet verebilir
  • Net API sözleşmelerine ihtiyacınız var: OpenAPI belirtimleri hem aracılar hem de insan geliştiriciler için belge ve doğrulama sağlar

Bu yaklaşım özellikle IŞ kolu uygulamaları, iç araçlar ve REST API'lerinin bileşenler arasındaki doğal sınırı oluşturduğu mikro hizmet mimarileri için iyi çalışır.

OpenAPI araçları aracılarla nasıl çalışır?

Tümleştirme basit bir akışı izler:

  1. API'nizi Tanımlayın: App Service REST uç noktalarınız için OpenAPI belirtimi oluşturma veya üretme
  2. Araç olarak kaydetme: OpenAPI belirtim konumunu belirterek API'nizi Foundry Temsilci Hizmeti'ne ekleyin
  3. Aracı bulma: Aracı kullanılabilir işlemleri, parametreleri ve yanıt biçimlerini otomatik olarak anlar
  4. Çalışma zamanı çağrısı: Kullanıcılar aracıyla etkileşime geçtiğinde, gerektiğinde App Service uç noktalarınızı çağırır
  5. Sonuç işleme: Aracı API yanıtlarını yorumlar ve sonuçları konuşmaya ekler

App Service, yönetilen kimlikler ve Microsoft Entra Id tümleştirmesi dahil olmak üzere güvenli araç çağırma için gereken kimlik doğrulama desenleri için yerleşik destek sağlar.

Eğitimlere başlayın

İlgili içerik

  • Last updated on