Megosztás a következőn keresztül:

A2A-ügynök API importálása (előzetes verzió)

A KÖVETKEZŐRE VONATKOZIK: Alapszintű v2 | Standard v2 | Prémium v2

Az API Management támogatja az Agent2Agent (A2A) protokoll specifikációjával kompatibilis AI-ügynök API-k kezelését. Az A2A protokoll egy nyílt ügyfél-kiszolgáló szabvány, amely lehetővé teszi a különböző AI-ügynökrendszerek számára, hogy egy megosztott interakciós modell használatával kommunikáljanak és működjenek együtt. Az API Management A2A-ügynök API-támogatásával más API-típusok mellett kezelheti és szabályozhatja az ügynök API-kat, például az AI-modell API-kat, a Model Context Protocol (MCP) eszközöket és a hagyományos API-kat, például a REST-et, a SOAP-t és a GraphQL-t.

Megjegyzés:

Ez a funkció előzetes verzióban érhető el, és bizonyos korlátozásokkal rendelkezik.

További információ az AI API-k kezeléséről az API Managementben:

Főbb képességek

Az A2A-ügynök API importálásakor az API Management a következő képességeket biztosítja:

  • Közvetíti JSON-RPC futtatókörnyezeti műveleteket az A2A háttérrendszerbe.
    • Engedélyezi a szabályozást és a forgalomvezérlést szabályzatok használatával.
    • Ha engedélyezve van az Application Insightson keresztüli megfigyelhetőség, a következő A2A-specifikus attribútumokat adja hozzá az OpenTelemetria GenAI szemantikai konvenciójának való megfeleléshez:
      • genai.agent.id – Állítsa be az API-beállításokban konfigurált ügynökazonosítót
      • genai.agent.name- Állítsa be az API nevét az API-beállításokban
  • Az ügynökkártyát a következő átalakításokkal teszi elérhetővé:
    • A gazdagépnevet az API Management-példány állomásnevére cseréli.
    • Az előnyben részesített átviteli protokollt JSON-RPC-re állítja.
    • Eltávolítja az összes többi felületet a fájlból additionalInterfaces.
    • Írja át a biztonsági követelményeket az API Management-előfizetés kulcskövetelményének belefoglalásához.

Előfeltételek

A2A-ügynök API importálása a portál használatával

Az alábbi lépésekkel importálhat egy A2A-ügynök API-t az API Managementbe.

  1. Az Azure Portalon nyissa meg az API Management-példányt.

  2. A bal oldali menü API-k alatt válassza az hozzáadása lehetőséget.

  3. Válassza ki az A2A Agent csempét.

    Képernyőkép az A2A-ügynök API csempéjének kiválasztásáról a portálon.

  4. Az Ügynökkártya területen adja meg az ügynökkártya JSON-dokumentumára mutató URL-címet . Válassza a Következőlehetőséget.

  5. Az A2A-ügynök API-jának létrehozása lapon konfigurálja az API-beállításokat.

    1. Ha a futtatókörnyezet URL-címe és ügynökazonosítója nincs automatikusan konfigurálva az ügynökkártya alapján, adja meg az ügynöknek JSON-RPC műveletek futtatókörnyezeti URL-címét és az ügynök által kibocsátott OpenTelemetry-nyomkövetésekben használt ügynökazonosítót (gen_ai.agent.id attribútum).
    2. Az Általános API-beállítások területen adja meg a kívánt megjelenítendő nevet az API Management-példányban, és opcionálisan adjon meg egy leírást.
    3. Az URL-cím alatt adja meg azt a Base útvonalat, amelyet az API Management példány használ az A2A agent API eléréséhez. Az API Management megjelenít egy alap URL-címet , amellyel az ügyfelek hozzáférhetnek a JSON-RPC API-hoz, valamint egy ügynökkártya URL-címét az ügynökkártya API Managementen keresztüli eléréséhez.

  6. Az API létrehozásához válassza a Létrehozás lehetőséget .

Képernyőkép egy A2A-ügynökkel kompatibilis API portálon való létrehozásáról.

Szabályzatok konfigurálása az A2A-ügynök API-hoz

Konfiguráljon egy vagy több API Management-szabályzatot az A2A-ügynök API kezeléséhez.

Az A2A-ügynök API szabályzatainak beállítása:

  1. Az Azure Portalon nyissa meg az API Management-példányt.
  2. A bal oldali menü API-k alatt válassza ki az A2A-ügynök API-ját.
  3. A bal oldali menü A2A területén válassza a Szabályzatok lehetőséget.
  4. A szabályzatszerkesztőben adja hozzá vagy szerkessze az A2A-ügynök API-ra alkalmazni kívánt szabályzatokat. A szabályzatok XML formátumban vannak definiálva.

Megjegyzés:

Az API Management az A2A-ügynök API-hatókörében lévő szabályzatok előtt a globális (az összes API) hatókörben konfigurált szabályzatokat értékeli ki.

Előfizetési kulcs hitelesítésének konfigurálása

Az A2A API beállításaiban opcionálisan konfigurálhatja az előfizetési kulcs hitelesítését az API Management használatával. További információ az előfizetési kulcs hitelesítéséről.

  1. Válassza ki az előző lépésben létrehozott API-t.
  2. A Beállítások lap Előfizetés területén válassza a Szükséges előfizetés (engedélyezés) lehetőséget.

Ha engedélyezi az előfizetési kulcs hitelesítését, az ügyfeleknek érvényes előfizetési kulcsot kell tartalmazniuk a fejlécben vagy Ocp-Apim-Subscription-Key a subscription-key lekérdezési paraméterben, amikor meghívják az A2A-ügynök API-t, vagy hozzáférnek az ügynökkártyához.

Az A2A-ügynök API tesztelése

Annak érdekében, hogy az A2A-ügynök API a várt módon működjön, hívja meg a háttérrendszert az API Management használatával:

  1. Válassza ki az előző lépésben létrehozott API-t.
  2. Az Áttekintés lapon másolja ki a futtatókörnyezet alap URL-címét. Ezzel az URL-címvel meghívhatja az A2A-ügynök API-t az API Managementen keresztül.
  3. Konfiguráljon egy tesztügyfélt, vagy használjon olyan eszközt, mint a curl , hogy kérést POST küldjön az ügynöknek. Ha az előfizetési kulcs hitelesítése engedélyezve van, adjon meg érvényes előfizetésikulcs-fejlécet vagy lekérdezési paramétert a kérelemben.

Jótanács

Hasonlóképpen, az API Managementen GET keresztül is elérheti az ügynökkártyát az A2A-ügynök API Áttekintés lapján megjelenő ügynökkártya URL-címére irányuló kéréssel.

Korlátozások

  • Ez a funkció jelenleg csak a v2 szintű API Management-példányokban érhető el.
  • Csak JSON-RPC-alapú A2A-ügynök API-k támogatottak.
  • A kimenő választestek deszerializálása nem támogatott.

Kapcsolódó tartalom

  • Last updated on