Aracılığıyla paylaş

A2A aracı API'sini içeri aktarma (önizleme)

ŞUNLAR IÇIN GEÇERLIDIR: Temel v2 | Standart v2 | Premium v2

API Management , Agent2Agent (A2A) protokol belirtimi ile uyumlu yapay zeka aracısı API'lerinin yönetilmesini destekler. A2A protokolü, farklı yapay zeka aracı sistemlerinin paylaşılan bir etkileşim modeli kullanarak iletişim kurmasını ve birlikte çalışmasını sağlayan açık bir istemci-sunucu standardıdır. API Management'taki A2A aracı API'si desteğiyle, aracı API'lerini yapay zeka modeli API'leri, Model Bağlam Protokolü (MCP) araçları ve REST, SOAP ve GraphQL gibi geleneksel API'ler gibi diğer API türleriyle birlikte yönetebilir ve yönetebilirsiniz.

Uyarı

Bu özellik önizleme aşamasındadır ve bazı sınırlamaları vardır.

API Management'ta yapay zeka API'lerini yönetme hakkında daha fazla bilgi edinin:

Önemli özellikler

A2A aracı API'sini içeri aktardığınızda, API Management aşağıdaki özellikleri sağlar:

  • A2A arka ucuna JSON-RPC çalışma zamanı işlemlerine aracılık eder.
    • İlkeleri kullanarak idare ve trafik denetimini etkinleştirir.
    • Application Insights aracılığıyla gözlemlenebilirlik etkinleştirildiğinde, OpenTelemetry GenAI anlam kuralına uymak için aşağıdaki A2A'ya özgü öznitelikleri ekler:
      • genai.agent.id - API ayarlarında yapılandırılan aracı kimliğine ayarlayın
      • genai.agent.name- API ayarlarında, API adını ayarlayın
  • Aracı kartını aşağıdaki dönüştürmelerle kullanıma sunar:
    • Konak adını, API Yönetimi örneğinin ana bilgisayar adıyla değiştirir.
    • Tercih edilen aktarım protokollerini JSON-RPC olarak ayarlar.
    • içindeki additionalInterfacesdiğer tüm arabirimleri kaldırır.
    • API Management abonelik anahtarı gereksinimini içerecek şekilde güvenlik gereksinimlerini yeniden yazar.

Önkoşullar

  • Mevcut bir API Management örneği. Henüz oluşturmadıysanız bir tane oluşturun.

  • JSON-RPC işlemleri ve aracı kartı olan mevcut bir A2A aracısı.

Portalı kullanarak A2A aracı API'sini içeri aktarma

A2A aracı API'sini API Management'a aktarmak için aşağıdaki adımları kullanın.

  1. Azure portalında API Management örneğine gidin.

  2. Soldaki menüde, API'ler'in altında API'ler>+ API Ekle'yi seçin.

  3. A2A Agent kutucuğunu seçin.

    Portalda A2A aracı API kutucuğunu seçme işleminin ekran görüntüsü.

  4. Aracı kartı altında, aracı kartı JSON belgesine işaret eden URL'yi girin. sonrakiseçin.

  5. A2A aracısı API'sini oluştur sayfasında API ayarlarını yapılandırın.

    1. Çalışma Zamanı URL'si ve Aracı Kimliği aracı kartına göre otomatik olarak yapılandırılmamışsa aracınıza JSON-RPC işlemlerinin çalışma zamanı URL'sini ve aracı (gen_ai.agent.id özniteliği) tarafından yayılan OpenTelemetry izlemelerinde kullanılan aracı kimliğini sağlayın.
    2. Genel API ayarları'nın altında, API Management örneğine seçtiğiniz bir Görünen ad girin ve isteğe bağlı olarak bir Açıklama girin.
    3. URL'nin altında, API Management örneğinizin A2A aracı API'sine erişmek için kullandığı bir Temel yol girin. API Management, istemcilerin JSON-RPC API'sine erişmek için kullanabileceği bir Temel URL ve API Management aracılığıyla aracı kartına erişmek için bir Aracı kartı URL'si görüntüler.

  6. API'yi oluşturmak için Oluştur'u seçin.

Portalda A2A aracı uyumlu API oluşturma işleminin ekran görüntüsü.

A2A aracı API'sine yönelik ilkeleri yapılandırma

A2A aracı API'sini yönetmeye yardımcı olmak için bir veya daha fazla API Management ilkesi yapılandırın.

A2A aracı API'niz için ilkeleri yapılandırmak için:

  1. Azure portalında API Management örneğine gidin.
  2. Sol taraftaki menüde , API'ler altında A2A aracı API'nizi seçin.
  3. Soldaki menüde, A2A altında Politikalar'ı seçin.
  4. İlke düzenleyicisinde, A2A aracı API'sine uygulamak istediğiniz ilkeleri ekleyin veya düzenleyin. İlkeler XML biçiminde tanımlanır.

Uyarı

API Management, A2A aracı API kapsamındaki ilkelerden önce genel (tüm API'ler) kapsamında yapılandırılan ilkeleri değerlendirir.

Abonelik anahtarı kimlik doğrulamayı yapılandırma

A2A API ayarlarında, isteğe bağlı olarak API Management aracılığıyla abonelik anahtarı kimlik doğrulamasını yapılandırabilirsiniz. Abonelik anahtarı kimlik doğrulaması hakkında daha fazla bilgi edinin.

  1. Önceki adımda oluşturduğunuz API’yi seçin.
  2. Ayarlar sayfasındaki Abonelik'in altında Abonelik gerekli'yi (etkinleştir) seçin.

Abonelik anahtarı kimlik doğrulamasını etkinleştirirseniz, istemciler A2A aracı API'sini Ocp-Apim-Subscription-Key başlığı ekleyerek çağırırken veya aracı kartına erişmek için subscription-key sorgu parametresine geçerli bir abonelik anahtarı dahil etmek zorundadır.

A2A aracı API'sini test edin

A2A aracı API'nizin beklendiği gibi çalıştığından emin olmak için API Management aracılığıyla arka ucu çağırın:

  1. Önceki adımda oluşturduğunuz API’yi seçin.
  2. Genel Bakış sayfasında Çalışma Zamanı temel URL'sini kopyalayın. API Management aracılığıyla A2A aracı API'sini çağırmak için bu URL'yi kullanın.
  3. Bir test istemcisi yapılandırın veya aracıya istekte bulunmak için curl gibi bir POST araç kullanın. Abonelik anahtarı kimlik doğrulaması etkinleştirildiyse, isteğe geçerli bir abonelik anahtarı üst bilgisi veya sorgu parametresi ekleyin.

Tavsiye

Benzer şekilde, A2A aracı API'nizin GET sayfasında görüntülenen Aracı kartı URL'sine istekte bulunarak API Management aracılığıyla aracı kartına erişin.

Sınırlamalar

  • Bu özellik şu anda yalnızca v2 katmanlarındaki API Management örneklerinde kullanılabilir.
  • Yalnızca JSON-RPC tabanlı A2A aracı API'leri desteklenir.
  • Giden yanıt gövdelerinin seri durumdan çıkarılması desteklenmez.

İlgili içerik

  • Last updated on