Agents personnalisés dans l’agent Azure SRE

Les agents personnalisés sont des agents spécialisés que vous appelez à la demande. Tapez /agent dans le chat, sélectionnez votre spécialiste et posez votre question. Ce processus vous donne accès à un expert en base de données pour les problèmes SQL et un auditeur de sécurité pour l’investigation des menaces.

Contrairement aux compétences (qui sont toujours disponibles), les agents personnalisés nécessitent un appel explicite. Cette exigence limite son expertise à des tâches spécifiques.

Fonctionnement des agents personnalisés

Invoquez un agent personnalisé à l’aide de la commande slash /agent dans la conversation. L’agent personnalisé reçoit le contexte de conversation complet et travaille avec une expertise ciblée.

L’exemple suivant montre une définition d’agent personnalisée de base :

name: database_expert
system_prompt: |
  You are a database specialist. Analyze query performance,
  diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
  - execute_kusto_query
  - azure_cli
connectors:
  - azure_sql
enable_skills: true  # Can use skills for additional expertise

Les propriétés clés sont les suivantes :

• system_prompt : Le rôle d'expert et les instructions.
• handoff_description: ce que voit l’orchestrateur lors de la décision de déléguer.
• tools: fonctionnalités disponibles.
• enable_skills: lorsque vous utilisez cette propriété, l’agent personnalisé peut accéder dynamiquement aux compétences.

Pourquoi utiliser des agents personnalisés

Les agents personnalisés vous permettent de empaqueter l’expertise du domaine, les outils et les connaissances à réutiliser. Au lieu de votre agent principal essayant de tout gérer, il délègue aux spécialistes.

Prenez en compte un problème de base de données : sans agents personnalisés, votre agent principal tente de résoudre les problèmes génériques. Avec un agent personnalisé « Database Expert », vous bénéficiez d’une expertise SQL ciblée, de runbooks spécifiques à la base de données et d’outils paramétrés pour l’analyse des requêtes.

Les agents personnalisés permettent également de créer des chaînes de transfert. Votre agent personnalisé de triage des incidents classe un problème, le transfère à l'expert du domaine approprié qui l'examine, puis le transfère à un routeur de notification. Chaque étape est spécialisée.

Créer un agent personnalisé

Créez des agents personnalisés dans le canevas de l’agent builder>.

1. Accédez à votre agent Azure SRE dans le portail Azure.

2. Sélectionnez l’onglet Canevas de l’agent .

3. Cliquez sur Créer.

4. Sélectionnez Agent personnalisé.

5. Fournissez des valeurs pour les paramètres suivants :

   Propriété	Valeur
   Nom	Entrez un nom descriptif pour votre agent personnalisé.
   Instructions	Fournissez des instructions claires et personnalisées qui définissent le comportement de l’agent personnalisé.
   Description de la procédure de transfert	Expliquez les scénarios où d’autres agents personnalisés doivent transférer le traitement vers cet agent personnalisé et pourquoi.
   Outils personnalisés (facultatif)	Choisissez un ou plusieurs outils personnalisés pour l’agent personnalisé à utiliser pendant ses opérations.
   Outils intégrés (facultatif)	Sélectionnez les outils système intégrés auquel vous souhaitez que l’agent personnalisé ait accès.
   Agents de passage (facultatif)	Spécifiez l’agent personnalisé qui doit prendre le traitement une fois que cet agent personnalisé a terminé ses tâches.

   Si vous le souhaitez, vous pouvez activer la fonctionnalité de base de connaissances . Cette option vous permet de charger des fichiers que votre agent personnalisé peut utiliser comme matériau de référence lors de la réponse aux requêtes.

Gestion des bases de connaissances

Améliorez les connaissances de vos agents personnalisés en chargeant la documentation, les runbooks et les guides de procédure.

Exemples de fichiers que vous pouvez ajouter à votre agent :

• Architecture ou conception du système : diagrammes et documentation qui expliquent les composants système et les flux de données.
• Guides de résolution des problèmes : instructions pas à pas pour diagnostiquer et résoudre les problèmes courants ou récurrents.
• Runbooks et SOPs : flux de travail détaillés pour les opérations de routine, la maintenance et la réponse aux incidents.
• Rapports d’incidents et postmortems : documentation sur les pannes passées, y compris l’analyse de la cause racine et les leçons apprises.
• Notes de publication et journaux des modifications : résumés des mises à jour de produits ou de services, y compris les nouvelles fonctionnalités, les correctifs de bogues et les modifications.

Types de fichiers pris en charge

Procédures opérationnelles au format Markdown (.md) ou texte (.txt).

Flux de travail de gestion de fichiers

1. Accédez à la base de connaissances en allant dans l'onglet Paramètres > Base de connaissances > Fichiers.
2. Chargez des fichiers en les faisant glisser et déposer ou en parcourant pour sélectionner des fichiers (maximum 50 Mo par fichier).
3. Organisez le contenu en ajoutant des balises et des descriptions pour améliorer la recherche.
4. Activez l’accès aux agents personnalisés en configurant les agents personnalisés qui peuvent accéder à des sources de connaissances spécifiques.
5. Surveillez l’utilisation en suivant la façon dont les agents personnalisés utilisent les connaissances chargées dans leurs réponses.

Vues de l'Agent Canvas

Construisez des agents personnalisés dans Builder>Agent Canvas. Les vues suivantes sont disponibles :

Quand utiliser des agents personnalisés

Le tableau suivant vous aide à déterminer quand les agents personnalisés sont le bon choix :

Pour une configuration complète de l’agent personnalisé, consultez Réponse aux incidents pour l’automatisation des réponses.

Transfert vers un agent personnalisé

Lorsque votre agent principal transfère la conversation à un agent personnalisé, ils partagent un seul contexte de conversation. L’agent de douane de réception voit :

• Historique complet des conversations : tous les messages précédents, appels d’outils et résultats.
• Raisonnement sur la sous-tâche : ce que le transfert demande à cet agent personnalisé de réaliser.
• Question originale de l’utilisateur : conservée tout au long de la chaîne de transfert.

Une fois son travail terminé, l’agent personnalisé passe la main à l’agent suivant ou rend le contrôle à l’orchestrateur. Le contexte de la conversation se construit tout au long de la chaîne.

Modèles d’agent personnalisés

Le tableau suivant décrit les modèles d’agent personnalisés courants :

Comparer les compétences, les agents personnalisés et les fichiers de connaissances

Le tableau suivant compare chaque concept d’extensibilité :

Utilisez les conseils suivants pour choisir la bonne approche :

• Compétence : procédure à l’échelle de l’équipe avec exécution facultative (guide de résolution des problèmes AKS + Azure CLI)
• Agent personnalisé : spécialiste étendu appelé à la demande (Expert PostgreSQL)
• Fichier de connaissances : Contenu de référence pour le contexte (documents d’architecture)

Connecter des agents personnalisés aux déclencheurs

Les incidents ou les tâches planifiées peuvent déclencher automatiquement des agents personnalisés. L’affichage canevas affiche visuellement ces connexions : les déclencheurs apparaissent en tant que nœuds connectés à des agents personnalisés, les outils sont regroupés avec leur agent personnalisé parent et les badges d’état affichent l’état actif ou inactif.

Pour plus d’informations sur l’installation, consultez Réponse aux incidents pour connecter des agents personnalisés à des incidents ou tâches planifiées pour l’automatisation périodique.

Modes d’agent personnalisés

Chaque agent personnalisé s’exécute en mode qui contrôle la quantité d’autonomie qu’il possède. Définissez le mode pour chaque plan de réponse ou tâche planifiée.

Choisissez le mode en fonction du risque :

• Recommandations d’optimisation des coûts ? Utiliser Review (approbation humaine nécessaire).
• Automatisation bien testée ? Utiliser autonome (pour les opérations approuvées).

Configurez les modes pour chaque plan de réponse ou tâche planifiée. Ne définissez pas de modes dans la définition YAML de l’agent personnalisé. Pour plus d’informations, consultez Modes d’exécution.

Tester et développer des agents personnalisés

Testez les agents personnalisés dans le terrain de jeu de test avant de déployer. Accédez à Builder>Canevas de l’agent, puis sélectionnez Terrain de jeu test à partir du bouton bascule d’affichage. La disposition à écran fractionné vous permet de modifier des instructions à gauche et de tester dans une conversation en direct à droite, avec une évaluation basée sur l’IA pour noter votre configuration.

Pour les utilisateurs de VS Code, l’extension de serveur MCP de l’agent SRE vous permet de modifier le YAML de l’agent personnalisé dans votre éditeur, les modifications étant synchronisées avec votre agent.

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

Contenu connexe