Tutoriel : Charger des documents de connaissances dans Azure Agent SRE

Dans ce tutoriel, vous chargez des documents de connaissances dans votre agent SRE Azure afin qu’il puisse les référencer lors des enquêtes futures. Vous allez apprendre à enregistrer les résultats d’investigation directement dans les paramètres de connaissances par le biais d’une conversation et comment charger des fichiers existants via l’interface utilisateur du portail.

Dans ce tutoriel, vous allez apprendre à :

  • Transformez une enquête en un livre de fonctionnement réutilisable et enregistrez-la dans les paramètres de Connaissances
  • Vérifier que le contenu chargé est indexé et pouvant faire l’objet d’une recherche
  • Charger des fichiers ou dossiers individuels via le portail
  • Testez que votre agent peut récupérer le contenu chargé dans une nouvelle conversation

Durée estimée : 10 minutes

Prerequisites

  • Un agent SRE Azure dans l’état En cours d'exécution
  • Autorisations d’écriture sur l’agent
  • Mode d’exécution de l’agent défini sur Révision ou Autonome

Étape 1 : Démarrer à 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 Chats, trouvez un fil d'investigation précédent, une conversation dans laquelle 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 2.

Étape 2 : Demander à votre agent de créer un runbook

Dans le même thread d’enquête, demandez à votre agent de transformer ses résultats en runbook et de l’enregistrer dans les paramètres de connaissance. 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 Knowledge settings as high-memory-runbook.md

Votre agent :

  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 les paramètres 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 désormais stocké dans les paramètres de connaissance et est indexé pour la recherche.

Point de contrôle

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

Étape 3 : Vérifier dans les paramètres de connaissances

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

La page Paramètres des connaissances affiche vos documents dans un tableau 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 à être recherché.

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

Point de contrôle

  • Accédez aux paramètres du Générateur → Connaissances
  • Le document s’affiche avec l'état « ✓ Indexé »

Étape 4 : Charger des fichiers via le portail

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

Charger des fichiers individuels

  1. Dans la page Sources 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.

Charger un dossier

Vous pouvez également faire glisser un dossier entier( y compris les sous-dossiers imbriqués) sur la zone de dépôt.

  1. Dans la page Sources de connaissances , sélectionnez Ajouter un fichier.
  2. Faites glisser un dossier de votre gestionnaire de fichiers directement vers la zone de dépôt.
  3. Le portail extrait tous les fichiers pris en charge du dossier et de ses sous-dossiers, puis les répertorie dans la boîte de dialogue.
  4. Passez en revue la liste des fichiers : supprimez les fichiers que vous ne souhaitez pas en sélectionnant l’icône de suppression en regard de chaque fichier.
  5. Sélectionnez Ajouter un fichier pour charger tous les fichiers répertoriés.

Le portail filtre automatiquement les fichiers avec des extensions non prises en charge. Pour obtenir la liste complète des extensions et limites de taille prises en charge, consultez la page de fonctionnalité Charger des documents de connaissances.

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

Note

Lorsque vous chargez un dossier, le portail ne conserve pas la structure des dossiers : les fichiers des sous-dossiers apparaissent sous forme de documents individuels. Si les fichiers dans différents sous-dossiers partagent le même nom, seul le premier fichier est chargé.

Point de contrôle

  • Sélectionnez Ajouter un fichier et voyez la boîte de dialogue de chargement.
  • Chargement d’un fichier ou déplacement d’un dossier avec succès.
  • Les fichiers apparaissent dans les sources de connaissances avec l’état ✓ Indexé.

Étape 5 : Tester la récupération dans une nouvelle conversation

Démarrez un nouveau fil de conversation et posez une question à laquelle vos documents téléchargés doivent répondre :

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

Votre agent recherche dans les paramètres de connaissance, trouve le runbook que vous avez chargé et s’y réfère dans sa réponse. Ce processus confirme que les connaissances sont indexées et récupérables.

Point de contrôle

  • Démarrage d’un nouveau fil de conversation
  • Poser une question relative au contenu chargé
  • L’agent a mentionné le document téléchargé dans sa réponse

Supprimer un document de connaissances

  1. Accédez aux paramètres du Générateur → Connaissances.
  2. Dans la liste des documents, sélectionnez un ou plusieurs documents à l’aide des cases à cocher.
  3. Sélectionnez Supprimer dans la barre d’outils.
  4. Une boîte de dialogue de confirmation répertorie les documents à supprimer. Sélectionnez Supprimer pour confirmer.

Lorsque vous supprimez des documents, vous les supprimez des paramètres De connaissances de l’agent et ils n’apparaissent plus dans les résultats de recherche.

Note

Vous ne pouvez pas modifier les documents de connaissances en place. Pour mettre à jour un document, chargez une nouvelle version avec le même nom de fichier. La nouvelle version remplace la version précédente.

Ce que vous avez appris

  • Votre agent peut transformer des enquêtes réelles en runbooks structurés et les enregistrer dans les paramètres de connaissances.
  • Vous pouvez charger manuellement des fichiers via l’interface utilisateur du portail dans les paramètres du Générateur → Connaissances. Il prend en charge de nombreux formats, notamment pdf, documents Office et images.
  • Le système indexe les documents chargés pour la recherche sémantique, et ils sont disponibles dans toutes les conversations futures.
  • Pour mettre à jour les documents, chargez-les à l’aide du même nom de fichier.

Résolution des problèmes

Error La cause Réparer
« La mémoire de l’agent est désactivée. Impossible de charger des documents. » Les paramètres de connaissances ne sont pas activés sur votre agent Contactez votre administrateur pour activer les paramètres de connaissances
« Je n’ai pas accès en écriture à vos paramètres de connaissances » L’agent n’a pas pu localiser l’outil de chargement Reformulez votre demande : « Enregistrer dans les paramètres de la base de connaissances en tant que fichier filename.md »
« Extension de fichier non valide. Seuls les fichiers .md et .txt sont autorisés. » Le nom de fichier ne se termine ni par .md ni par .txt (téléversement de conversation) 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 Inclure un nom de fichier dans votre invite (par exemple, runbook.md)
Ressource Ce que vous apprenez
Charger des documents de connaissances Comment cela fonctionne et pourquoi cela importe
Créer une compétence Développer des compétences procédurales qui complètent les documents de connaissances
Compétences Comment les compétences et les connaissances travaillent ensemble
Connaissances wiki ADO Connecter du contenu wiki dynamique comme source de connaissances
  • Last updated on