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

Dans ce tutoriel, vous créez un sous-agent spécialisé dans Agent Canvas 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éez un sous-agent avec des instructions personnalisées dans Agent Canvas
  • 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 Génération + configuration>Workflows>Agent Canvas.

  3. Sélectionnez Créer>un agent personnalisé.

    Le formulaire Créer un agent personnalisé 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. (Optionnel) Configurez les champs et sections restants dans le dialogue.

    • Compétences : Sélectionnez Choisir des compétences pour remplacer la sélection globale de compétences héritée. Laissez-le tel quel pour hériter des valeurs par défaut. Pour plus d’informations, consultez Compétences.
    • Outils : Sélectionnez Choisir des outils pour remplacer la sélection globale d’outils héritée. Pour créer d’abord des outils personnalisés, consultez Créer un outil Kusto ou Créer un outil Python.
    • Hooks : sélectionnez Gérer les hooks pour ajouter des contrôles de sécurité et de gouvernance. Pour connaître les étapes de configuration, consultez Créer et gérer des hooks dans le portail.
  6. Cliquez sur Créer.

Votre sous-agent apparaît comme un nœud sur Agent Canvas 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 de l’Agent Canvas, sélectionnez le bouton bascule de vue Aire de 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-agent existant, ouvrez sa configuration sur Agent Canvas.

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