Tutoriel : Créer une compétence dans l’agent Azure SRE

Dans ce tutoriel, vous allez créer une compétence personnalisée qui ajoute des connaissances spécifiques au domaine et des playbooks de tâches à votre agent. Les compétences sont des fonctionnalités modulaires que votre agent charge automatiquement en cas de pertinence, telles que la résolution des problèmes d’un service spécifique ou l’exécution d’une procédure de diagnostic.

Dans ce tutoriel, vous allez apprendre à :

  • Créer une compétence dans le générateur de sous-fonctions
  • Écrire des instructions de compétence dans SKILL.md
  • Ajouter des fichiers et des outils de prise en charge
  • Tester la compétence dans une conversation ou le terrain de jeu
  • Modifier une compétence existante

Durée estimée : 10 minutes

Conseil / Astuce

Les compétences et les documents de connaissances fonctionnent ensemble. Une compétence enseigne à votre agent comment faire quelque chose (procédures, playbooks, instructions pas à pas). Un document de connaissances enseigne à votre agent ce qu’il doit savoir (données de référence, documents d’architecture, runbooks). Vous pouvez également joindre des documents de référence directement à une compétence en tant que fichiers de support. Pour connaître le flux de chargement des connaissances, consultez Charger des documents de connaissances.

Prerequisites

Avant de commencer, vérifiez que les conditions préalables suivantes sont remplies :

  • Agent créé dans le portail de l’agent Azure SRE.
  • Une compréhension claire de la procédure ou des connaissances de domaine que vous souhaitez encoder.

Ouvrez le générateur de sous-agent dans lequel vous créez et gérez des compétences.

  1. Ouvrez le portail de l’agent SRE.
  2. Sélectionner votre agent.
  3. Sélectionnez Générateur dans le volet de navigation gauche.
  4. Sélectionnez Constructeur de sous-agent.

Démarrer la création de compétences

Démarrez le processus de création de compétences à partir de la barre d’outils.

  1. Sélectionnez la liste déroulante Créer dans la barre d’outils.
  2. Sélectionnez Compétence.

La boîte de dialogue de création de compétences s’ouvre avec une disposition à deux colonnes. Champs de formulaire d’un côté et éditeur de code de l’autre affichant SKILL.md.

Entrer le nom et la description

Fournissez un nom et une description qui aident l’agent à décider quand utiliser cette compétence.

Champ Exemple de valeur
Nom high-cpu-troubleshooting
Description « Procédure de résolution des problèmes pour les alertes de processeur élevées sur les applications conteneur. Vérifie les dépendances en amont, le pool de connexions et les déploiements récents. »

Le nom doit être unique parmi vos compétences. La description apparaît dans la liste des compétences et aide l’agent à décider quand utiliser cette compétence.

Conseil / Astuce

Sélectionnez Modifier en regard du texte de description pour passer en mode édition. Sélectionnez Enregistrer lorsque vous avez terminé.

Écrire des directives de compétence

L’éditeur du centre affiche SKILL.md, qui contient les instructions de la compétence. Le fichier commence par un modèle par défaut.

---
name:
description:
---

<!-- Add your skill instructions here -->

L'en-tête YAML (name, description, tools) reste synchronisé avec les champs du formulaire sur la gauche. Écrivez vos instructions dans Markdown en dessous de la première question :

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Ajouter des fichiers de support

La section Fichiers d’un côté affiche un navigateur de fichiers. Au-delà de la valeur par défaut SKILL.md, vous pouvez ajouter des données de référence, des modèles et des exemples de requêtes.

  • Sélectionnez la nouvelle icône de fichier pour ajouter des fichiers.
  • Sélectionnez la nouvelle icône de dossier pour organiser les fichiers en répertoires.
  • Faites glisser et déposez un dossier dans la zone de dépôt, ou sélectionnez le lien Charger le dossier pour charger une structure de dossiers entière.

Sélectionnez un fichier dans le navigateur pour le modifier dans l’éditeur de code. L’éditeur prend en charge la mise en surbrillance de la syntaxe pour les scripts Markdown, JSON, YAML, KQL, Python et shell.

Sélectionner des outils

Si vous le souhaitez, attachez des outils que la fonctionnalité utilise lors de son exécution.

  1. Sélectionnez Choisir des outils dans la section Outils .
  2. Parcourez ou recherchez des outils. Filtrez par type (outil personnalisé, outil MCP) ou recherchez par nom.
  3. Vérifiez les outils dont cette compétence a besoin (par exemple, kusto_query ou azure_resource_health).
  4. Fermez le volet.

Les outils sélectionnés apparaissent sous forme de pilules amovibles. Ces outils sont disponibles dynamiquement lorsque la compétence est activée.

Note

Les outils ajoutés à une compétence sont disponibles dynamiquement lorsque la compétence est activée. Pour un comportement plus cohérent, configurez les outils directement sur le sous-agent à la place.

Pour créer des outils personnalisés, consultez Créer un outil Kusto ou Créer un outil Python. Pour plus d’informations sur les outils, consultez Outils.

Créer la compétence

Sélectionnez Créer pour enregistrer votre compétence.

Votre compétence s’affiche sous l’onglet Compétences du générateur de sous-agent. L’agent peut désormais utiliser automatiquement la compétence lorsqu’il rencontre une situation pertinente.

Tester la compétence

L’agent principal peut utiliser les compétences par défaut. Vous pouvez donc les tester directement dans la conversation sans créer de sous-agent.

Tester dans une nouvelle conversation

Utilisez un nouveau fil de conversation pour vérifier que l’agent active votre compétence.

  1. Sélectionnez Nouveau fil de conversation dans la barre latérale.
  2. Tapez une commande qui doit déclencher votre compétence. Par exemple : « Nous constatons une utilisation élevée du processeur sur notre application conteneurisée, pouvez-vous enquêter ? »
  3. Vérifiez que l’agent active la compétence et suit les procédures que vous avez définies.

Tester dans le terrain de jeu

Utilisez le terrain de jeu pour tester la compétence par le biais d’un sous-agent.

  1. Créez un sous-agent et attribuez-lui cette compétence.
  2. Dans la barre d’outils du générateur de sous-agents, sélectionnez le bouton bascule d’affichage Terrain de jeu test.
  3. Sélectionnez le sous-agent, tapez une commande de test et vérifiez qu’il utilise correctement la compétence.

Pour plus d’informations, consultez Le terrain de jeu de l’agent.

Modifier une compétence

Vous pouvez modifier une compétence existante pour mettre à jour ses instructions, outils ou fichiers de prise en charge.

  1. Sous l’onglet Compétences , sélectionnez le nom de la compétence ou sélectionnez-le, puis choisissez Modifier.

  2. La boîte de dialogue d’édition s’ouvre avec toutes les valeurs actuelles préremplies. Modifiez les champs dont vous avez besoin :

    Nouveautés Où mettre à jour
    Lorsque l’agent l’utilise Description et instructions dans SKILL.md
    Procédures à suivre Contenu de SKILL.md dans l'éditeur
    Quels outils sont disponibles Outils> Choisir des outils
    Données de référence Fichiers> ajouter, modifier ou supprimer des fichiers

  3. Cliquez sur Enregistrer.

Conseils pour l’écriture de compétences efficaces

Utilisez les instructions suivantes pour créer des compétences que votre agent peut utiliser efficacement.

  • Soyez précis sur le moment où l’utiliser. L’agent lit la description et les instructions pour décider de la pertinence.
  • Incluez des procédures pas à pas. Les étapes numérotées donnent à l’agent un playbook clair.
  • Spécifiez la sortie attendue. Indiquez à l’agent quel format les résultats doivent prendre.
  • Ajoutez des données de référence. Chargez des modèles de requête, des bases de référence de configuration ou des valeurs connues comme fichiers de support.
  • Attribuez des outils pertinents. Si la compétence a besoin d’outils spécifiques tels que les requêtes Kusto ou les actions Azure, ajoutez-les.

Étape suivante

En savoir plus sur les compétences

Contenu connexe

  • Last updated on