Dela via

Importera ett A2A-agent-API (förhandsversion)

GÄLLER FÖR: Basic v2 | Standard v2 | Premium v2

API Management stöder hantering av AI-agent-API:er som är kompatibla med protokollspecifikationen Agent2Agent (A2A). A2A-protokollet är en öppen klientserverstandard som gör det möjligt för olika AI-agentsystem att kommunicera och arbeta tillsammans med hjälp av en modell för delad interaktion. Med api-stöd för A2A-agenten i API Management kan du hantera och styra agent-API:er tillsammans med andra API-typer, inklusive AI-modell-API:er, MCP-verktyg (Model Context Protocol) och traditionella API:er som REST, SOAP och GraphQL.

Anmärkning

Den här funktionen är i förhandsversion och har vissa begränsningar.

Läs mer om att hantera AI-API:er i API Management:

Viktiga funktioner

När du importerar ett A2A-agent-API tillhandahåller API Management följande funktioner:

  • Förmedlar JSON-RPC driftoperationer till A2A-serverdelen.
    • Aktiverar styrning och trafikkontroll med hjälp av principer.
    • När observerbarhet via Application Insights är aktiverat lägger du till följande A2A-specifika attribut för att följa OpenTelemetry GenAI-semantikkonventionen:
      • genai.agent.id – Ange till det agent-ID som konfigurerats i API-inställningarna
      • genai.agent.name– Ange API-namnet i API-inställningarna
  • Exponerar agentkortet med följande transformeringar:
    • Ersätter värdnamnet med API Management-instansens värdnamn.
    • Anger det föredragna transportprotokollet till JSON-RPC.
    • Tar bort alla andra gränssnitt i additionalInterfaces.
    • Skriver om säkerhetskrav för att inkludera nyckelkravet för API Management-prenumerationen.

Förutsättningar

  • En befintlig API Management-instans. Skapa en om du inte redan har gjort det.

  • En befintlig A2A-agent med JSON-RPC operationer, och ett agentkort.

Importera A2A-agent-API:et med hjälp av portalen

Använd följande steg för att importera ett A2A-agent-API till API Management.

  1. I Azure-portalen går du till din API Management-instans.

  2. I den vänstra menyn går du till API:er och väljer API:er>+ Lägg till API.

  3. Välj panelen A2A-agent .

    Skärmbild av att välja A2A-agent-API-panelen i portalen.

  4. Under Agentkort anger du url:en som pekar på agentkortets JSON-dokument. Välj Nästa.

  5. På sidan Skapa en A2A-agent-API konfigurerar du API-inställningarna.

    1. Om Runtime-URL och Agent-ID inte automatiskt konfigureras baserat på agentkortet, ange körnings-URL för JSON-RPC-operationer till din agent och agent-ID som används i OpenTelemetry-spårningar som genereras av agenten (gen_ai.agent.id egenskap).
    2. Under Allmänna API-inställningar anger du ett visningsnamn som du väljer i API Management-instansen och anger eventuellt en Beskrivning.
    3. Under URL anger du en bassökväg som API Management-instansen använder för att få åtkomst till A2A-agent-API:et. API Management visar en bas-URL som klienter kan använda för att komma åt JSON-RPC-API:et och en URL för agentkort för att få åtkomst till agentkortet via API Management.

  6. Välj Skapa för att skapa API:et.

Skärmbild av att skapa ett A2A-agentkompatibelt API i portalen.

Konfigurera principer för A2A-agent-API:et

Konfigurera en eller flera API Management-principer för att hantera A2A-agent-API:et.

Så här konfigurerar du principer för A2A-agent-API:et:

  1. I Azure-portalen går du till din API Management-instans.
  2. I den vänstra menyn går du till API:er och väljer ditt A2A-agent-API.
  3. I den vänstra menyn, under A2A, väljer du Principer.
  4. I principredigeraren lägger du till eller redigerar de principer som du vill tillämpa på A2A-agent-API:et. Principerna definieras i XML-format.

Anmärkning

API Management utvärderar principer som konfigurerats i det globala omfånget (alla API:er) före principer i API-omfånget för A2A-agenten.

Konfigurera prenumerationsnyckelautentisering

I A2A API-inställningarna kan du konfigurera prenumerationsnyckelautentisering via API Management. Läs mer om prenumerationsnyckelautentisering.

  1. Välj det API som du skapade i föregående steg.
  2. På sidan Inställningar under Prenumeration väljer du (aktivera) Prenumeration krävs.

Om du aktiverar prenumerationsnyckelautentisering måste klienterna inkludera en giltig prenumerationsnyckel i Ocp-Apim-Subscription-Key rubriken eller subscription-key frågeparametern när de anropar A2A-agent-API:et eller använder agentkortet.

Testa A2A-agent-API:et

För att se till att A2A-agent-API:et fungerar som förväntat anropar du serverdelen via API Management:

  1. Välj det API som du skapade i föregående steg.
  2. På sidan Översikt kopierar du runtime-bas-URL:en. Använd den här URL:en för att anropa A2A-agent-API:et via API Management.
  3. Konfigurera en testklient eller använd ett verktyg som curl för att göra en POST begäran till agenten. Om autentisering av prenumerationsnyckel är aktiverat inkluderar du ett giltigt huvud för prenumerationsnyckeln eller frågeparametern i begäran.

Tips/Råd

På samma sätt kan du komma åt agentkortet via API Management genom att göra en GET begäran till agentkortets URL som visas på sidan Översikt för A2A-agent-API:et.

Begränsningar

  • Den här funktionen är för närvarande endast tillgänglig i API Management-instanser på v2-nivåerna.
  • Endast JSON-RPC-baserade A2A-agent-API:er stöds.
  • Deserialisering av utgående svarskroppar stöds inte.

Relaterat innehåll

  • Last updated on