Partager via

Importer une API d’agent A2A (préversion)

S’applique à : Essentiel v2 | Standard v2 | Premium v2

Gestion des API prend en charge la gestion des API d’agent IA compatibles avec la spécification du protocole Agent2Agent (A2A). Le protocole A2A est une norme open client-server qui permet à différents systèmes d’agent IA de communiquer et de travailler ensemble à l’aide d’un modèle d’interaction partagée. Avec la prise en charge de l’API de l’agent A2A dans Gestion des API, vous pouvez gérer et régir les API de l’agent en même temps que d’autres types d’API, notamment les API de modèle IA, les outils MCP (Model Context Protocol) et les API traditionnelles telles que REST, SOAP et GraphQL.

Note

Cette fonctionnalité est en préversion et présente certaines limitations.

En savoir plus sur la gestion des API IA dans Gestion des API :

Fonctionnalités clés

Lorsque vous importez une API d’agent A2A, Gestion des API fournit les fonctionnalités suivantes :

  • Fait la médiation des opérations d’exécution JSON-RPC sur le backend A2A.
    • Active la gouvernance et le contrôle du trafic à l’aide de stratégies.
    • Lorsque l’observabilité via Application Insights est activée, ajoute les attributs spécifiques à A2A suivants pour se conformer à la convention sémantique OpenTelemetry GenAI :
      • genai.agent.id - Défini sur l’ID d’agent configuré dans les paramètres de l’API
      • genai.agent.name- Définir le nom de l'API dans les paramètres API
  • Expose la carte de l’agent avec les transformations suivantes :
    • Remplace le nom d’hôte par le nom d’hôte de l’instance Gestion des API.
    • Définit le protocole de transport préféré sur JSON-RPC.
    • Supprime toutes les autres interfaces dans additionalInterfaces.
    • Réécrit les exigences de sécurité pour inclure l’exigence de clé d’abonnement Gestion des API.

Prerequisites

  • Une instance existante de gestion d’API. Si vous ne l’avez pas déjà fait, créez-en un.

  • Agent A2A existant avec les opérations JSON-RPC et une carte d’agent.

Importer l’API de l’agent A2A à l’aide du portail

Procédez comme suit pour importer une API d’agent A2A dans Gestion des API.

  1. Dans le portail Azure, accédez à votre instance Gestion des API.

  2. Dans le menu de gauche, sous API, sélectionnez API>+ Ajouter une API.

  3. Sélectionnez la vignette Agent A2A .

    Capture d’écran de la sélection de la vignette API de l’agent A2A dans le portail.

  4. Sous Carte agent, entrez l’URL qui pointe vers le document JSON de la carte d’agent. Cliquez sur Suivant.

  5. Dans la page Créer une API de l’agent A2A , configurez les paramètres de l’API.

    1. Si l’URL du runtime et l’ID de l’agent ne sont pas configurés automatiquement en fonction de la carte de l’agent, fournissez l’URL d’exécution de JSON-RPC opérations à votre agent et l’ID de l’agent utilisé dans les traces OpenTelemetry émises par l’agent (gen_ai.agent.id attribut).
    2. Sous Paramètres d’API généraux, entrez un nom d’affichage de votre choix dans l’instance Gestion des API, puis entrez éventuellement une description.
    3. Sous URL, entrez un chemin de base que votre instance Gestion des API utilise pour accéder à l’API de l’agent A2A. Gestion des API affiche une URL de base que les clients peuvent utiliser pour accéder à l’API JSON-RPC et une URL de carte Agent pour accéder à la carte de l’agent via Gestion des API.

  6. Sélectionnez Créer pour créer l’API.

Capture d’écran de la création d’une API compatible avec un agent A2A dans le portail.

Configurer des stratégies pour l’API de l’agent A2A

Configurez une ou plusieurs stratégies gestion des API pour gérer l’API de l’agent A2A.

Pour configurer des stratégies pour votre API de l’agent A2A :

  1. Dans le portail Azure, accédez à votre instance Gestion des API.
  2. Dans le menu de gauche, sous API, sélectionnez votre API de l’agent A2A.
  3. Dans le menu de gauche, sous A2A, sélectionnez Stratégies.
  4. Dans l’éditeur de stratégie, ajoutez ou modifiez les stratégies que vous souhaitez appliquer à l’API de l’agent A2A. Les stratégies sont définies au format XML.

Note

Gestion des API évalue les stratégies configurées au niveau de l’étendue globale (toutes les API) avant les stratégies au niveau de l’étendue de l’API de l’agent A2A.

Configurer l’authentification par clé d’abonnement

Dans les paramètres de l’API A2A, vous pouvez éventuellement configurer l’authentification par clé d’abonnement via Gestion des API. En savoir plus sur l’authentification par clé d’abonnement.

  1. Sélectionnez l’API que vous avez créée à l’étape précédente.
  2. Dans la page Paramètres , sous Abonnement, sélectionnez (activer) Abonnement requis.

Si vous activez l’authentification par clé d’abonnement, les clients doivent inclure une clé d’abonnement valide dans l’en-tête Ocp-Apim-Subscription-Key ou le paramètre de requête subscription-key lors de l’appel de l’API de l’agent A2A ou de l’accès à la carte de l’agent.

Tester l’API de l’agent A2A

Pour vous assurer que votre API de l’agent A2A fonctionne comme prévu, appelez le back-end via Gestion des API :

  1. Sélectionnez l’API que vous avez créée à l’étape précédente.
  2. Dans la page Vue d’ensemble , copiez l’URL de base runtime. Utilisez cette URL pour appeler l’API de l’agent A2A via Gestion des API.
  3. Configurez un client de test ou utilisez un outil tel que curl pour effectuer une POST demande à l’agent. Si l’authentification par clé d’abonnement est activée, incluez un en-tête de clé d’abonnement valide ou un paramètre de requête dans la demande.

Conseil / Astuce

De même, accédez à la carte de l’agent via Gestion des API en effectuant une GET demande à l’URL de la carte Agent affichée dans la page Vue d’ensemble de votre API de l’agent A2A.

Limites

  • Cette fonctionnalité est actuellement disponible uniquement dans les instances gestion des API dans les niveaux v2.
  • Seules les API d’agent A2A basées sur JSON-RPC sont prises en charge.
  • La désérialisation des corps de réponse sortante n’est pas prise en charge.

Contenu connexe

  • Last updated on