Connecter des connaissances dans Azure Agent SRE

Azure agent SRE est plus efficace lorsqu’il peut utiliser le même contexte que celui utilisé par votre équipe pour résoudre les problèmes liés aux systèmes. Connectez des runbooks, de la documentation, des pages web et des référentiels afin que votre agent puisse les référencer pendant les enquêtes au lieu de commencer à partir de zéro.

Conseil / Astuce

• Utilisez la base de connaissances Builder > pour gérer des fichiers, des pages web et des référentiels à un seul endroit.
• Les connaissances indexées sont automatiquement disponibles pendant les enquêtes et les conversations.
• Vous pouvez charger des documents directement, joindre des fichiers dans une conversation ou connecter des référentiels pour l’analyse source.
• Les sources de connaissances les plus utiles sont celles dont dépend déjà votre équipe, comme les runbooks, les notes d’architecture, les guides de résolution des problèmes et le code source.

Pourquoi les connaissances sont importantes

Votre agent dispose déjà d’un contexte intégré Azure par le biais d’outils d’observabilité et de systèmes connectés. Ce qu’il n’a pas par défaut est la connaissance interne de votre équipe. Ces connaissances incluent le runbook qui explique une étape de récupération courante, l’architecture note qui identifie une dépendance partagée ou le référentiel qui révèle quel déploiement a introduit une régression.

Lorsque vous connectez ces connaissances, votre agent peut :

• Consulter les procédures opérationnelles de l’équipe pendant un incident.
• Réutilisez les étapes de résolution des problèmes que votre équipe a déjà documentées.
• Mettre en corrélation les symptômes avec le code source et le contexte de déploiement.
• Répondez aux questions à l’aide des mêmes documents et références que les humains utilisent.

Gérer les connaissances dans la base de connaissances

Utilisez la base de connaissances Builder > pour gérer les sources de connaissances de votre agent.

La page affiche chaque source avec ses éléments suivants :

• Name
• État
• Type
• Date de dernière modification

Trois types sources sont disponibles :

Type de source	Ce qu’il fournit	Comment l’ajouter
Files	Procédures d’exploitation, guides de dépannage, documents d’architecture et documents de référence	Charger via le portail ou demander à l’agent d’enregistrer un document pendant la conversation
Pages Web	Documentation externe, URL wiki internes et pages d’état	Ajouter l’URL de la page afin que l’agent puisse indexer le contenu
Dépôts	Code source, fichiers de déploiement et définitions d’infrastructure	Connecter des référentiels GitHub ou Azure DevOps

Vérifier l’état et l’actualisation de l’indexation

Chaque source de connaissances affiche l’un des états suivants :

État	Signification
Indexé	Le contenu est traité et pouvant faire l’objet d’une recherche
En attente	Le contenu est toujours en cours de traitement
Non indexé	Échec du traitement ou impossible d’indexer la source

Lorsqu’une source est indexée, survolez l’indicateur d’état pour voir l’horodatage Date de création. Cet horodatage est utile lorsque vous souhaitez confirmer que la dernière version d’un runbook ou d’un document est traitée.

Chargement de documents

Chargez des documents lorsque vous souhaitez que les connaissances restent disponibles dans les conversations futures.

Voici quelques exemples typiques :

• Runbooks d’incident
• Guides d’escalade
• Références d’architecture
• Listes de contrôle de résolution des problèmes

Vous pouvez charger des fichiers via le portail ou demander à l’agent d’enregistrer du contenu à partir d’une conversation dans la base de connaissances.

Pour connaître les formats et limites de fichiers pris en charge, consultez Charger des documents de connaissances.

Pour obtenir le flux de travail complet, consultez Charger des documents de connaissances.

Partager des fichiers dans la conversation

Utilisez les pièces jointes dans le chat lorsque vous souhaitez fournir à l’agent un contexte immédiat au sein d’une seule conversation. Cette approche est utile pour les captures d’écran, les fichiers journaux, les fichiers de configuration et d’autres éléments qui facilitent le dépannage en cours.

Conseil / Astuce

Si un fichier que vous joignez dans la conversation doit devenir une connaissance à long terme, demandez à l’agent de l’enregistrer dans les paramètres de connaissances. L’agent peut charger une copie afin que le contenu devienne indexé et pouvant faire l’objet d’une recherche dans les conversations ultérieures.

Le tableau suivant compare les chargements de connaissances à long terme avec les pièces jointes de conversation temporaires :

Scénario	Charger dans la base de connaissances	Partager dans la conversation
Idéal pour	Guides d’exploitation, procédures et documents que vous souhaitez rendre disponibles dans les conversations futures	Fichiers que vous souhaitez que l’agent analyse en ce moment
Étendue de stockage	Au niveau de l’agent et avec recherche possible dans les futures conversations	Au niveau du fil et disponible dans la conversation en cours
Guide pratique pour ajouter	Charger dans le portail ou demander à l’agent d’enregistrer du contenu	Glissez-déposez, collez depuis le presse-papiers ou utilisez + dans le chat
Peut devenir une connaissance à long terme	Connaissances à long terme existantes	Oui, si vous demandez à l’agent de l’enregistrer

Pour plus d’informations, consultez Partager des fichiers dans la conversation.

Ajouter des pages web

Ajoutez des pages web lorsque des conseils importants résident en dehors des fichiers ou référentiels chargés.

Les candidats parfaits sont :

• Articles wiki internes
• Documentation sur les produits publics
• Pages d’état du service
• Pages de référence gérées par l’équipe

Une fois que vous avez ajouté une URL, l’agent indexe le contenu de la page afin qu’il puisse référencer ces informations pendant les prochaines enquêtes.

Connecter des référentiels

Connectez des dépôts GitHub ou Azure DevOps lorsque votre agent a besoin d’un contexte tenant compte du code source.

Les référentiels connectés aident l’agent :

• Rechercher des modèles d’erreur dans le code source
• Mettre en corrélation les incidents avec les modifications récentes du code
• Référencer les fichiers de déploiement et de configuration
• Utiliser le contenu du référentiel pendant l’analyse de la cause racine

Pour connecter du code source, consultez Connecter le code source.

Choisir la source de connaissances appropriée

Utilisez le type de source qui correspond au type de contexte dont vous avez besoin :

Si vous avez besoin de vous connecter...	Utilisez...
Un runbook ou un guide de résolution des problèmes stocké en tant que fichier	Charger des documents de connaissances
Capture d’écran, journal ou fichier pour une investigation active	Partager des fichiers dans la conversation
Référentiel de GitHub ou de Azure DevOps	Connecter le code source
Systèmes externes tels que Datadog ou Splunk	Connecteurs MCP