Condividi tramite

Importare un'API dell'agente A2A (anteprima)

SI APPLICA A: Basic v2 | Standard v2 | Premium v2

La Gestione delle API supporta la gestione delle API dell'agente di intelligenza artificiale compatibili con la specifica del protocollo Agent2Agent (A2A). Il protocollo A2A è uno standard client-server aperto che consente a diversi sistemi dell'agente di intelligenza artificiale di comunicare e collaborare usando un modello di interazione condivisa. Con il supporto dell'API dell'agente A2A in Gestione API, è possibile gestire e gestire le API agente insieme ad altri tipi di API, incluse le API del modello di intelligenza artificiale, gli strumenti MCP (Model Context Protocol) e le API tradizionali, ad esempio REST, SOAP e GraphQL.

Annotazioni

Questa funzionalità è in anteprima e presenta alcune limitazioni.

Altre informazioni sulla gestione delle API di intelligenza artificiale in Gestione API:

Funzionalità chiave

Quando si importa un'API agente A2A, Gestione API offre le funzionalità seguenti:

  • Mediare operazioni di runtime JSON-RPC per il back-end A2A.
    • Abilita la gestione e il controllo del traffico usando le politiche.
    • Quando l'osservabilità tramite Application Insights è abilitata, aggiunge gli attributi specifici di A2A seguenti per essere conformi alla convenzione semantica OpenTelemetry GenAI:
      • genai.agent.id - Impostare sull'ID agente configurato nelle impostazioni dell'API
      • genai.agent.name- Impostare il nome dell'API nelle impostazioni dell'API
  • Espone la scheda agente con le trasformazioni seguenti:
    • Sostituisce il nome host con il nome host dell'istanza di Gestione API.
    • Imposta il protocollo di trasporto preferito su JSON-RPC.
    • Rimuove tutte le altre interfacce in additionalInterfaces.
    • Riscrive i requisiti di sicurezza per includere il requisito della chiave di sottoscrizione di Gestione API.

Prerequisiti

  • Un'istanza di API Management esistente. Crearne una se non è già stato fatto.

  • Un agente A2A esistente con operazioni JSON-RPC e una scheda agente.

Importare l'API dell'agente A2A usando il portale

Seguire questa procedura per importare un'API dell'agente A2A in Gestione API.

  1. Nel portale di Azure passare all'istanza di Gestione API.

  2. Nel menu a sinistra, in API, selezionare >.

  3. Selezionare il riquadro Agente A2A .

    Screenshot di selezione del riquadro dell'API dell'agente A2A nel portale.

  4. In Scheda agente immettere l'URL che punta al documento JSON della scheda dell'agente. Seleziona Avanti.

  5. Nella pagina Crea un'API dell'agente A2A configurare le impostazioni dell'API.

    1. Se l'URL di runtime e l'ID agente non vengono configurati automaticamente in base alla scheda dell'agente, specificare l'URL di runtime delle operazioni di JSON-RPC all'agente e l'ID agente usato nelle tracce OpenTelemetry generate dall'agente (gen_ai.agent.id attributo).
    2. In Impostazioni API generali immettere un nome visualizzato a scelta nell'istanza di Gestione API e, facoltativamente, immettere una descrizione.
    3. In URL immettere un percorso di base usato dall'istanza di Gestione API per accedere all'API dell'agente A2A. Gestione API visualizza un URL di base che i client possono usare per accedere all'API JSON-RPC e un URL della scheda agente per accedere alla scheda agente tramite Gestione API.

  6. Selezionare Crea per creare l'API.

Screenshot della creazione di un'API compatibile con l'agente A2A nel portale.

Configurare i criteri per l'API dell'agente A2A

Configurare uno o più criteri di Gestione API per gestire l'API dell'agente A2A.

Per configurare i criteri per l'API dell'agente A2A:

  1. Nel portale di Azure passare all'istanza di Gestione API.
  2. Nel menu a sinistra, in API, selezionare l'API dell'agente A2A.
  3. Nel menu a sinistra, in A2A, selezionare Criteri.
  4. Nell'editor dei criteri aggiungere o modificare i criteri da applicare all'API dell'agente A2A. I criteri sono definiti in formato XML.

Annotazioni

Gestione API valuta i criteri configurati nell'ambito globale (tutte le API) prima dei criteri nell'ambito dell'API dell'agente A2A.

Configurare l'autenticazione della chiave di sottoscrizione

Nelle impostazioni dell'API A2A è possibile configurare facoltativamente l'autenticazione della chiave di sottoscrizione tramite Gestione API. Altre informazioni sull'autenticazione della chiave di sottoscrizione.

  1. Selezionare l'API creata nel passaggio precedente.
  2. Nella pagina Impostazioni , in Sottoscrizione selezionare (abilita) Sottoscrizione obbligatoria.

Se si abilita l'autenticazione della chiave di sottoscrizione, i client devono includere una chiave di sottoscrizione valida nell'intestazione Ocp-Apim-Subscription-Key o subscription-key nel parametro di query quando si chiama l'API dell'agente A2A o si accede alla scheda agente.

Testare l'API dell'agente A2A

Per assicurarsi che l'API dell'agente A2A funzioni come previsto, chiamare il back-end tramite Gestione API:

  1. Selezionare l'API creata nel passaggio precedente.
  2. Nella pagina Panoramica, copiare l'URL di base del runtime. Usare questo URL per chiamare l'API dell'agente A2A tramite Gestione API.
  3. Configurare un client di test o usare uno strumento come curl per effettuare una POST richiesta all'agente. Se l'autenticazione della chiave di sottoscrizione è abilitata, includere un'intestazione di chiave di sottoscrizione o un parametro di query valido nella richiesta.

Suggerimento

Analogamente, accedere alla scheda dell'agente tramite Gestione API effettuando una GET richiesta all'URL della scheda Agente visualizzato nella pagina Panoramica dell'API dell'agente A2A.

Limitazioni

  • Questa funzionalità è attualmente disponibile solo nelle istanze di Gestione API nei livelli v2.
  • Sono supportate solo le API dell'agente A2A basate su JSON RPC.
  • La deserializzazione dei corpi di risposta in uscita non è supportata.

Contenuti correlati

  • Last updated on