Tutoriel : Créer un sous-agent dans Azure SRE Agent

Dans ce tutoriel, vous créez un sous-agent spécialisé dans le générateur de sous-composants avec ses propres instructions, outils et compétences. Les sous-agents gèrent des tâches ciblées telles que le rapport de santé, le triage des alertes ou la remise des notifications. Pour plus d’informations sur le fonctionnement des sous-éléments, consultez Sous-éléments.

Durée estimée : 5 minutes

Dans ce tutoriel, vous allez apprendre à :

  • Créer un sous-agent avec des instructions personnalisées dans le générateur de sous-éléments
  • Attribuer des compétences, des outils et des hooks au sous-agent
  • Tester le sous-agent dans le dialogue et le bac à sable
  • Modifier et gérer la configuration de sous-entité à l’aide du formulaire ou du yaML

Prerequisites

  • Agent créé dans le portail de l’agent Azure SRE.
  • Au moins un connecteur configuré, si vous souhaitez que le sous-agent utilise des outils externes.

Créer un sous-agent

Suivez ces étapes pour créer un sous-agent à partir du portail.

  1. Ouvrez le portail de l’agent SRE et sélectionnez votre agent.

  2. Sélectionnez Constructeur>Constructeur de sous-agent.

  3. Sélectionnez la liste déroulante Créer dans la barre d’outils, puis sélectionnez Agent personnalisé.

    La boîte de dialogue de création s’ouvre avec deux onglets : Formulaire et YAML.

  4. Renseignez les champs obligatoires :

    Champ Exemple de valeur
    Nom de l’agent personnalisé (obligatoire) health-check-reporter
    Instructions (obligatoires) « Vous êtes un rapporteur d’intégrité. Vérifiez Azure Resource Health pour les applications conteneur dans le groupe de ressources de production. Résumez les nombres sains, d’avertissements et critiques. Envoyez le résumé par e-mail. »

    Conseil / Astuce

    Sélectionnez Affiner avec l’IA au-dessus du champ instructions pour permettre à l’agent d’améliorer automatiquement vos instructions. Sélectionnez Afficher les suggestions d’IA pour afficher des recommandations pour améliorer les instructions, les outils et les compétences.

  5. (Facultatif) Configurez les sections restantes dans la boîte de dialogue. Si vous ignorez ces sections, le sous-agent hérite de toutes les compétences et outils globaux par défaut.

    • Compétences : sélectionnez Choisir des compétences pour attribuer des compétences spécifiques au sous-groupe. La sélection de compétences spécifiques remplace les valeurs par défaut globales. Laissez la sélection vide pour autoriser toutes les compétences globales. Pour plus d’informations, consultez Compétences.

    • Outils : sélectionnez Choisir des outils pour ouvrir le panneau sélecteur d’outils. Parcourez ou recherchez des outils organisés par catégorie (par exemple, outils Kusto ou outils de notification). Sélectionnez les outils que vous souhaitez utiliser par le sous-agent. Pour créer d’abord des outils personnalisés, consultez Créer un outil Kusto ou Créer un outil Python. Pour plus d’informations, consultez Outils.

    • Hooks : sélectionnez Gérer les hooks pour ajouter des contrôles de sécurité et de gouvernance. Les hooks s’exécutent avant les actions (hooks de prompt) ou après l’utilisation d’un outil (hooks de commande). Pour connaître les étapes de configuration, consultez Créer et gérer des hooks dans le portail. Pour plus d’informations, consultez Hooks d’agent.

  6. Cliquez sur Créer.

Votre sous-agent apparaît sous la forme d’un nœud sur le canevas du générateur de sous-agent avec tous les outils connectés affichés.

Conseil / Astuce

Avant d’attribuer des outils, testez-les individuellement dans le terrain de jeu de test pour vous assurer qu’ils retournent les données attendues.

Tester le sous-agent

Après avoir créé votre sous-composant, testez-le pour vérifier qu’il se comporte comme prévu.

Tester à partir de la boîte de dialogue

Dans la boîte de dialogue de création ou de modification, sélectionnez l’icône de test dans le coin supérieur droit pour ouvrir le panneau Tester l'agent en direct. Saisissez un prompt et observez comment le sous‑agent répond avec ses instructions et outils actuels.

Tester dans le terrain de jeu

Utilisez le terrain de jeu pour une expérience de test interactive avec une disposition à écran fractionné.

  1. Dans la barre d’outils du générateur de sous-agents, sélectionnez le bouton bascule d’affichage Terrain de jeu test.
  2. La disposition à écran fractionné affiche la configuration de votre sous-agent d’un côté et une conversation en direct sur l’autre.
  3. Sélectionnez votre sous-agent, tapez une invite de test et vérifiez qu’il se comporte comme prévu.
  4. Effectuez une itération en modifiant des instructions ou en échangeant des outils, puis testez à nouveau jusqu’à ce que la sortie corresponde à vos attentes.

Pour plus d’informations, consultez le terrain de jeu de l’agent ou tester un outil dans le terrain de jeu.

Modifier un sous-agent

Pour modifier un sous-composant existant, ouvrez sa configuration sur le canevas du sous-générateur.

Sélectionnez le nœud subagent, puis sélectionnez Modifier (ou double-cliquez sur le nœud). La boîte de dialogue d’édition s’ouvre avec toutes les valeurs actuelles préremplies.

Nouveautés Champ à mettre à jour
Qu’est-ce que cela fait ? Instructions
Quelles compétences elle utilise Compétences> Choisir des compétences
Quels outils il utilise Outils> Choisir des outils
Contrôles de sécurité Hooks> Gérer les hooks

Sélectionnez Enregistrer lorsque vous avez terminé.

Modifier avec YAML

Vous pouvez afficher ou modifier la configuration de votre sous-agent en tant que YAML pour copier des configurations ou gérer la configuration en tant que code.

Sélectionnez l’onglet YAML en haut de la boîte de dialogue créer ou modifier pour basculer en mode YAML. Les modifications en mode YAML sont synchronisées avec l’affichage formulaire.

Étape suivante

En savoir plus sur les sous-agents

Contenu connexe

  • Last updated on