Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article explique comment inscrire des agents IA, y compris des agents A2A, dans le Centre des API, les rendre détectables pour les utilisateurs et les mettre à jour et les gérer.
Prerequisites
- Instance du Centre des API Azure
- Agent décrit par une carte d’agent au format JSON ou une définition d’agent au format Markdown
- Autorisations appropriées pour modifier les API dans votre Centre d’API
Inscrire l’agent
Connectez-vous au portail Azure et accédez à votre centre d’API.
Dans le menu de la barre latérale, sous Inventaire, sélectionnez Ressources.
Sélectionnez + Enregistrer une ressource>Agent.
Dans le formulaire Inscrire un agent , entrez les informations décrites dans le tableau suivant :
Champ Descriptif Titre Entrez un nom descriptif pour l’agent, tel que l’agent du support technique. Identification Le Centre d’API génère automatiquement un identificateur basé sur le titre, tel que help-desk-agent. Vous pouvez modifier cet identificateur si nécessaire. Résumé court Entrez une brève description en une seule ligne de ce que fait l’agent qui s’affiche dans le portail du Centre des API et d’autres emplacements. Description Si vous le souhaitez, entrez une description plus détaillée des fonctionnalités, des cas d’usage et du comportement de la compétence. Version Titre de la version Entrez un titre de version de votre choix, tel que v1. Identification de la version Le Centre d’API génère automatiquement un identificateur en fonction du titre de la version. Vous pouvez modifier cet identificateur si nécessaire. Cycle de vie des révisions Sélectionnez l’étape actuelle du cycle de vie de la version de l’agent dans le menu déroulant. En savoir plus sur les versions dans le Centre API. Détails de l’agent Définition de l’agent Entrez une URL ou sélectionnez un fichier pour charger une définition d’agent. La définition de l’agent doit être au format Markdown et inclure des détails sur les fonctionnalités, les compétences et d’autres informations pertinentes de l’agent. Protocole Le cas échéant, sélectionnez le protocole A2A si l’agent y adhère. Fiche de l’assistant Si vous le souhaitez, entrez une URL ou sélectionnez un fichier pour charger une carte d’agent A2A au format JSON. 
Sélectionnez Créer pour ajouter l’agent.
Après l’inscription, l’agent apparaît dans votre inventaire dans la page Ressources d’inventaire>.
Mettre à jour un agent inscrit
Vous pouvez mettre à jour les informations de l’agent à tout moment.
- Dans le portail Azure, accédez à votre centre d’API.
- Dans le menu de la barre latérale, sous Inventaire, sélectionnez Ressources.
- Dans la table, sélectionnez le nom de l’agent dans la colonne Titre .
- Sélectionnez le bouton Modifier pour ouvrir la page Modifier dans le volet de travail.
- Apportez vos modifications, puis sélectionnez Enregistrer.
Synchroniser des agents à partir de sources d’API
Pour automatiser l’inscription de l’agent et maintenir votre inventaire à jour, vous pouvez intégrer les sources en amont suivantes à votre centre d’API :
Gestion des API Azure : si vous gérez des agents A2A dans Gestion des API Azure, vous pouvez activer la synchronisation automatique pour maintenir votre centre d’API à jour. Pour plus d’informations, consultez Synchroniser les API à partir de l’instance Gestion des API Azure.
Référentiel Git : pour les agents A2A et d’autres ressources IA stockées dans un référentiel Git, vous pouvez activer la synchronisation automatique pour maintenir votre centre d’API à jour. Pour plus d’informations, consultez Synchroniser les ressources d’API à partir d’un référentiel Git.
Découvrir des agents dans le portail du Centre d’API
Configurez votre portail du Centre d’API afin que les développeurs et d’autres parties prenantes de votre organisation puissent découvrir des agents dans votre inventaire des API. À partir du portail du Centre d’API, les utilisateurs peuvent :
- Parcourez et filtrez les agents dans l’inventaire.
- Affichez des informations détaillées sur chaque agent.
Évaluer les ressources d’IA
Le Centre d’API peut évaluer la qualité des ressources IA telles que les compétences et les agents inscrits dans votre centre d’API. API Center inclut par défaut des critères d’évaluation prêts à l’emploi, qui évaluent les actifs selon des dimensions prédéfinies. Les administrateurs de plateforme d’entreprise peuvent étendre ces valeurs par défaut en définissant des critères d’évaluation personnalisés adaptés aux normes, exigences de conformité et stratégies de gouvernance spécifiques de leur organisation.
Pour activer les évaluations automatisées des ressources IA dans votre inventaire :
Dans le portail Azure, accédez à votre centre d’API.
Dans le menu de la barre latérale. accédez à Governance>AI Assessment.
Sélectionnez l’onglet Compétences pour configurer des évaluations pour les compétences, ou sélectionnez l’onglet Agents pour configurer des évaluations pour les agents.
Dans l’état De l’évaluation, sélectionnez Activé.
Entrez une description pour l’évaluation.
Dans les critères d’évaluation, effectuez l’une des opérations suivantes :
- Acceptez les critères par défaut fournis par le Centre d’API. Supprimez éventuellement les critères par défaut qui ne sont pas pertinents pour votre organisation.
La capture d’écran suivante montre les critères par défaut pour les compétences :
- Ajoutez un ou plusieurs critères personnalisés.
- Sélectionnez + Ajouter des critères.
- Entrez un nom et une instruction d’évaluation facultative pour le critère.
- Entrez le score minimal et les valeurs de score maximale pour le score (par exemple, 1 et 5).
- Entrez une valeur de seuil pass (par exemple, 3) qui indique le score minimal acceptable pour le critère.
- Entrez une valeur de poids qui indique la contribution du critère à l’évaluation totale (par exemple, un poids de 0,3 multiple le score de 0,3, contribuant à 30% à l’évaluation totale).
- Répétez les étapes précédentes pour ajouter d’autres critères si nécessaire.
Cliquez sur Enregistrer.
Vous pouvez ensuite afficher les résultats d’évaluation dans le portail du Centre des API. Par exemple, affichez les résultats de l’évaluation pour chaque compétence dans la page détails de la compétence.
