Tutoriel : Charger des documents de connaissances dans Azure SRE Agent

Dans ce tutoriel, vous chargez des documents de connaissances dans la base de connaissances de votre agent Azure SRE à l’aide de deux méthodes : en demandant à l’agent de créer un runbook à partir d’une investigation et en chargeant un fichier via l’interface utilisateur du portail.

Votre agent peut capturer les connaissances découvertes lors des enquêtes et les stocker pour une utilisation ultérieure, en créant automatiquement des connaissances institutionnelles. Pour plus d’informations, consultez Charger des documents de connaissances.

Dans ce tutoriel, vous allez apprendre à :

• Transformez une enquête en un runbook structuré et enregistrez-le dans la base de connaissances
• Charger un fichier manuellement via l’interface utilisateur du portail
• Vérifier que les documents chargés sont indexés et disponibles
• Vérifiez que l’agent récupère les connaissances chargées dans les nouvelles conversations

Durée estimée : 15 minutes

Prerequisites

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Agent Azure SRE en cours d’exécution .
• Permissions d'écriture pour l'agent
• Le mode d’exécution de l’agent est défini sur Révision ou autonome.

Commencer à partir d’une enquête

Les meilleurs documents de connaissances proviennent d’enquêtes réelles. Au lieu de créer du contenu à partir de zéro, capturez ce que votre agent a déjà appris.

1. Accédez à sre.azure.com et sélectionnez votre agent.
2. Dans la barre latérale gauche, sous Conversations, recherchez un thread d’investigation précédent où votre agent a diagnostiqué ou résolu un problème, puis sélectionnez-le.

Si vous n’avez pas encore de thread d’investigation, démarrez une nouvelle conversation et demandez à votre agent d’examiner quelque chose :

Investigate high memory usage on our container apps

Attendez que l’enquête se termine, puis passez à l’étape suivante.

Créer un runbook à partir de l’enquête

Dans le même thread d’investigation, demandez à votre agent de transformer ses résultats en runbook et de l’enregistrer dans la base de connaissances. Soyez spécifique au nom de fichier.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to the knowledge base as high-memory-runbook.md

Votre agent effectue les actions suivantes :

1. Synthétise le contexte d’investigation dans un runbook structuré.
2. Génère des sections telles que l’analyse de la cause racine, les étapes de diagnostic, les atténuations et les déclencheurs d’escalade.
3. Enregistre le document dans la base de connaissances et confirme le chargement.

L’agent confirme que le document a été enregistré et fournit un lien de téléchargement. Votre runbook est maintenant stocké dans la base de connaissances et sera indexé pour la recherche.

Conseil / Astuce

Spécifiez un nom de fichier avec une extension .md ou .txt. Cela contrôle la façon dont le document est nommé dans la base de connaissances et facilite la recherche ultérieure.

Note

Si votre agent est en mode Révision , il demande votre approbation avant d’exécuter le chargement. Sélectionnez Approuver pour continuer.

À ce stade, confirmez ce qui suit :

• L’agent a généré un runbook structuré basé sur l’enquête.
• L’agent a confirmé que le document avait été enregistré.

Vérifier le document dans la base de connaissances

Accédez à la base de connaissances pour confirmer que votre document a été indexé.

1. Dans la barre latérale gauche, sélectionnez Générateur pour développer la section.
2. Sélectionnez La base de connaissances.

La page de la base de connaissances affiche vos documents dans une table avec des colonnes pour le nom de fichier, l’état, le type et la dernière modification. La colonne État affiche Indexé lorsque le document est indexé et prêt pour la recherche.

Si l’état indique En attente, sélectionnez Actualiser. L’indexation se termine généralement en quelques secondes.

Charger un fichier via le portail

Vous pouvez également charger des fichiers directement. Cette méthode est utile pour les runbooks, la documentation ou les documents de référence existants dont dispose déjà votre équipe.

1. Dans la page de la base de connaissances , sélectionnez Ajouter un fichier.
2. Faites glisser un fichier dans la zone de déplacement, ou sélectionnez Rechercher les fichiers pour en choisir un.
3. Sélectionnez Ajouter un fichier à charger.

Le portail accepte les types de fichiers suivants :

• Texte : .md, , .txt.csv, .json, .xml.yaml.yml.log.ini.cfg.conf.config.properties
• Documents : .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls
• Images : .png, , .jpg, .jpeg.gif, .bmp.webp, .tiff.tif

La taille maximale du fichier est de 16 Mo par fichier, avec jusqu’à 100 Mo par chargement.

Tester la récupération au sein d'une nouvelle conversation

Vérifiez que l’agent peut rechercher et utiliser les documents chargés.

1. Sélectionnez Nouveau fil de conversation dans la barre latérale.
2. Posez une question à laquelle vos documents téléchargés devraient répondre.

Par exemple:

What are the steps for troubleshooting high memory usage on container apps?

Votre agent interroge la base de connaissances, trouve votre runbook chargé et s'y réfère dans la réponse. Cela confirme que les connaissances sont indexées et récupérables.

Capitaliser le savoir après les incidents

Après avoir résolu un problème, demandez à votre agent de conserver ce qu’il a appris :

Create a runbook from the steps we just used to resolve this incident.
Include the root cause, investigation steps, and the fix.
Save it as incident-12345-resolution.md in the knowledge base.

Au fil du temps, cela crée une bibliothèque pouvant faire l’objet d’une recherche de connaissances institutionnelles. Chaque incident passé devient une ressource pour les futures.

Mettre à jour des documents existants

Chargez un document avec le même nom de fichier pour remplacer la version précédente :

Update the high-memory-runbook.md document in the knowledge base.
Add a new section about container memory limits as a common cause.

Chargements par lots via l’interface CLI

Importez plusieurs documents à la fois à l’aide de l’interface CLI :

# Upload a single file
srectl doc upload --file ./runbooks/high-memory-guide.md

# Upload all .md and .txt files in a folder (recursive)
srectl doc upload --file ./runbooks

Résolution des problèmes

Utilisez le tableau suivant pour résoudre les problèmes courants liés aux chargements de documents de connaissances.

Error	La cause	Réparer
« La mémoire de l’agent est désactivée. Impossible de charger des documents. »	La base de connaissances n’est pas activée sur votre agent.	Contactez votre administrateur pour activer la base de connaissances.
« Je n’ai pas accès en écriture à votre base de connaissances »	L’agent n’a pas pu localiser l’outil de chargement.	Reformulez votre demande : « Enregistrez-la dans la base de connaissances en tant que filename.md »
« Extension de fichier non valide. Seuls les fichiers .md et .txt sont autorisés. »	Le nom de fichier ne se termine pas par .md ou .txt (téléversement de chat).	Utilisez une extension .md ou .txt lorsque vous demandez à l’agent d’enregistrer.
« Le contenu du document dépasse la taille maximale de 16 Mo »	Contenu trop volumineux pour un seul document.	Fractionner en plusieurs documents plus petits.
« Impossible de vider le nom de fichier »	Aucun nom de fichier fourni.	Incluez un nom de fichier dans votre invite (par exemple). runbook.md

Étape suivante

En savoir plus sur la mémoire et les connaissances

Contenu connexe

• Charger des documents de connaissances (fonctionnalité)
• Connaissances du wiki Azure DevOps
• Mémoire et connaissance