Sdílet prostřednictvím

Import rozhraní API agenta A2A (Preview)

PLATÍ PRO: Basic v2 | Standard v2 | Premium v2

API Management podporuje správu rozhraní API agenta AI kompatibilní se specifikací protokolu Agent2Agent (A2A). Protokol A2A je otevřený standard klientského serveru, který umožňuje různým systémům agenta AI komunikovat a spolupracovat pomocí modelu sdílené interakce. S podporou rozhraní API agenta A2A ve službě API Management můžete spravovat a řídit rozhraní API agenta společně s dalšími typy rozhraní API, včetně rozhraní API modelů AI, nástrojů MCP (Model Context Protocol) a tradičních rozhraní API, jako jsou REST, SOAP a GraphQL.

Poznámka:

Tato funkce je ve verzi Preview a má určitá omezení.

Další informace o správě rozhraní API AI ve službě API Management:

Klíčové funkce

Při importu rozhraní API agenta A2A poskytuje služba API Management následující možnosti:

  • Zprostředkovává operace běhového prostředí JSON-RPC na backend A2A.
    • Umožňuje správu a řízení provozu pomocí zásad.
    • Pokud je povolena pozorovatelnost prostřednictvím Application Insights, přidá následující atributy specifické pro A2A, které vyhovují sémantické konvenci OpenTelemetry GenAI:
      • genai.agent.id – Nastavte na ID agenta nakonfigurované v nastavení rozhraní API.
      • genai.agent.name– Nastavení názvu rozhraní API v nastavení rozhraní API
  • Zpřístupňuje kartu agenta s následujícími transformacemi:
    • Nahradí název hostitele názvem hostitele instance služby API Management.
    • Nastaví upřednostňovaný přenosový protokol na JSON-RPC.
    • Odebere všechna ostatní rozhraní v souboru additionalInterfaces.
    • Přepíše požadavky na zabezpečení tak, aby zahrnovaly požadavek na klíč předplatného služby API Management.

Požadavky

Import rozhraní API agenta A2A pomocí portálu

Pomocí následujícího postupu naimportujte rozhraní API agenta A2A do služby API Management.

  1. Na webu Azure Portal přejděte do vaší instance služby API Management.

  2. V nabídce vlevo v části APIs vyberte APIs>+ Přidat API.

  3. Vyberte dlaždici A2A Agent.

    Snímek obrazovky s výběrem dlaždice rozhraní API agenta A2A na portálu

  4. V části Karta agenta zadejte adresu URL , která odkazuje na dokument JSON karty agenta. Vyberte Další.

  5. Na stránce Vytvořit rozhraní API agenta A2A nakonfigurujte nastavení rozhraní API.

    1. Pokud adresa URL modulu runtime a ID agenta nejsou automaticky nakonfigurované na základě karty agenta, zadejte adresu URL modulu runtime operací JSON-RPC pro vašeho agenta a ID agenta použitého v trasování OpenTelemetry emitované agentem (gen_ai.agent.id atribut).
    2. V části Obecné nastavení rozhraní API zadejte zobrazovaný název podle vašeho výběru v instanci služby API Management a volitelně zadejte popis.
    3. V části Adresa URL zadejte základní cestu , kterou vaše instance SLUŽBY API Management používá pro přístup k rozhraní API agenta A2A. Služba API Management zobrazí základní adresu URL , kterou můžou klienti použít pro přístup k rozhraní JSON-RPC API, a adresu URL karty agenta pro přístup k kartě agenta prostřednictvím služby API Management.

  6. Chcete-li vytvořit rozhraní API, vyberte tlačítko Vytvořit.

Snímek obrazovky s vytvořením rozhraní API kompatibilního s agentem A2A na portálu

Konfigurace zásad pro rozhraní API agenta A2A

Nakonfigurujte jednu nebo více zásad služby API Management, které vám pomůžou se správou rozhraní API agenta A2A.

Konfigurace zásad pro rozhraní API agenta A2A:

  1. Na webu Azure Portal přejděte do vaší instance služby API Management.
  2. V nabídce vlevo v části Rozhraní API vyberte rozhraní API agenta A2A.
  3. V nabídce vlevo v části A2A vyberte Zásady.
  4. V editoru zásad přidejte nebo upravte zásady, které chcete použít pro rozhraní API agenta A2A. Zásady jsou definovány ve formátu XML.

Poznámka:

Služba API Management vyhodnocuje zásady nakonfigurované v globálním rozsahu (všechna rozhraní API) před zásadami v oboru rozhraní API agenta A2A.

Konfigurace ověřování klíče předplatného

V nastavení rozhraní API A2A můžete volitelně nakonfigurovat ověřování klíče předplatného prostřednictvím služby API Management. Přečtěte si další informace o ověřování pomocí klíče předplatného.

  1. Vyberte rozhraní API, které jste vytvořili v předchozím kroku.
  2. Na stránce Nastavení v části Předplatné vyberte (povolit) Požadované předplatné.

Pokud povolíte ověřování klíče předplatného, klienti musí při volání rozhraní API agenta A2A nebo přístupu k kartě agenta zahrnout platný klíč předplatného do Ocp-Apim-Subscription-Key hlavičky nebo subscription-key parametru dotazu.

Testování rozhraní API agenta A2A

Abyste měli jistotu, že rozhraní API agenta A2A funguje podle očekávání, zavolejte back-end prostřednictvím služby API Management:

  1. Vyberte rozhraní API, které jste vytvořili v předchozím kroku.
  2. Na stránce Přehled zkopírujte základní adresu URL modulu runtime. Pomocí této adresy URL můžete přistupovat k rozhraní API agenta A2A prostřednictvím API Management.
  3. ** Nakonfigurujte testovacího klienta nebo použijte nástroj, jako je curl, k zaslání POST požadavku agentovi. Pokud je povolené ověřování klíče předplatného, uveďte do požadavku platnou hlavičku klíče předplatného nebo parametr dotazu.

Návod

Podobně se k kartě agenta dostanete prostřednictvím služby API Management tak, že vytvoříte GET požadavek na adresu URL karty agenta zobrazenou na stránce Přehled vašeho rozhraní API agenta A2A.

Omezení

  • Tato funkce je aktuálně dostupná jenom v instancích služby API Management na úrovních v2.
  • Podporují se pouze rozhraní API agenta A2A založená na PROTOKOLU JSON.RPC.
  • Deserializace odchozích těl odpovědí není podporována.

Související obsah

  • Last updated on