Inscrire et découvrir des compétences dans votre inventaire d’API

Cet article explique comment utiliser le Centre des API Azure pour inscrire des compétences d’agent dans le cadre de votre inventaire des API. Les compétences sont des fonctionnalités réutilisables que les agents IA peuvent découvrir et consommer pour étendre leurs fonctionnalités.

En inscrivant des compétences dans votre centre d’API, vous créez un registre centralisé qui aide votre organisation :

  • Découvrir les compétences disponibles et leurs capacités
  • Accéder au code source et à la documentation pour les compétences

Prerequisites

  • Un centre d’API. Si vous n’avez pas encore de centre d’API, consultez le guide de démarrage rapide pour créer un centre d’API.
  • Une ou plusieurs compétences que vous souhaitez inscrire, généralement hébergées dans un référentiel de code source tel que GitHub.

Inscrire une compétence

Pour inscrire une compétence dans votre centre d’API :

  1. Connectez-vous au portail Azure et accédez à votre centre d’API.

  2. Dans le menu de la barre latérale, sous Inventaire, sélectionnez Ressources.

  3. Sélectionnez + Enregistrer un actif>Compétence.

    Capture d’écran de l’inscription d’une compétence dans le portail.

  4. Dans le formulaire Inscrire une compétence, fournissez les informations contenues dans le tableau suivant :

    Champ Description
    Titre Entrez un nom descriptif pour la compétence (par exemple, Compétence de révision de code).
    Identification Le Centre d’API génère automatiquement un identificateur basé sur le titre (par exemple, code-review-skill). Vous pouvez le modifier si nécessaire.
    Résumé Fournissez une brève description en une seule ligne de ce que fait la compétence (par exemple, effectue des révisions de code automatisées à l’aide d’une analyse statique).
    Description Entrez une description plus détaillée des fonctionnalités, des cas d’usage et du comportement de la compétence.
    Phase de cycle de vie Sélectionnez l’étape actuelle du cycle de vie de la compétence dans le menu déroulant.
    Source
    Source URL Entrez l’URL du référentiel Git pour le code source de compétence (par exemple, https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
    Compatibilité Décrire les exigences, les dépendances et les prérequis pour l’utilisation de la compétence (par exemple, logiciels ou outils requis tels que git, docker, langages de programmation ; configuration requise ; configuration requise pour l’accès réseau ; Clés API ou exigences d’authentification).
    Outils autorisés Sélectionnez + Ajouter un outil pour spécifier les API ou les serveurs MCP à partir de votre inventaire d’API auquel cette compétence peut accéder. Cette approche permet de garantir une gouvernance et une sécurité appropriées en définissant explicitement les ressources que la compétence peut consommer.
    Licence Sélectionnez + Ajouter pour fournir des informations de licence. Entrez le nom de la licence (par exemple, MIT, Apache 2.0 ou Propriétaire), fournissez éventuellement une URL de licence et ajoutez une description si nécessaire pour clarifier les conditions ou restrictions de licence.
    Informations de contact Sélectionnez + Ajouter pour ajouter des points de contact pour le support ou les demandes de renseignements. Entrez un nom ou un rôle de contact (par exemple, l’équipe d’API ou John Smith), fournissez des coordonnées telles que l’adresse e-mail et ajoutez éventuellement une description pour clarifier quand et pourquoi contacter cette personne ou cette équipe.

  5. Sélectionnez Créer pour inscrire la compétence dans votre centre d’API.

Après l’inscription, la compétence apparaît dans votre inventaire dans la page Ressources d’inventaire>.

Mettre à jour une compétence inscrite

Vous pouvez mettre à jour les informations de compétence à tout moment :

  1. Dans votre centre d’API, accédez à Inventaire>des ressources.
  2. Recherchez et sélectionnez la compétence à mettre à jour.
  3. Sélectionnez Modifier pour modifier les propriétés de la compétence.
  4. Apportez vos modifications, puis sélectionnez Enregistrer.

Synchroniser les compétences à partir d’un référentiel Git

Pour automatiser l’inscription des compétences et maintenir votre inventaire à jour, vous pouvez intégrer un référentiel Git à votre centre d’API. Pour plus d’informations, consultez Synchroniser les ressources d’API à partir d’un référentiel Git.

Découvrir les compétences 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 compétences dans votre inventaire des API. À partir du portail du Centre d’API, les utilisateurs peuvent :

  • Parcourez et filtrez les compétences dans l’inventaire.
  • Affichez des informations détaillées sur chaque compétence.

É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 :

  1. Dans le portail Azure, accédez à votre centre d’API.

  2. Dans le menu de la barre latérale. accédez à Governance>AI Assessment.

  3. 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.

  4. Dans l’état De l’évaluation, sélectionnez Activé.

  5. Entrez une description pour l’évaluation.

  6. 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 :

    Capture d’écran de la configuration de l’évaluation des compétences IA dans le portail.

    • Ajoutez un ou plusieurs critères personnalisés.
      1. Sélectionnez + Ajouter des critères.
      2. Entrez un nom et une instruction d’évaluation facultative pour le critère.
      3. Entrez le score minimal et les valeurs de score maximale pour le score (par exemple, 1 et 5).
      4. Entrez une valeur de seuil pass (par exemple, 3) qui indique le score minimal acceptable pour le critère.
      5. 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).
      6. Répétez les étapes précédentes pour ajouter d’autres critères si nécessaire.

  7. 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.

Capture d’écran de l’évaluation des compétences dans le portail du Centre des API.

Contenu connexe

  • Last updated on