Charger des documents de connaissances dans Azure Agent SRE

Conseil / Astuce

  • Votre agent crée et télécharge des runbooks au cours des conversations sans nécessiter de gestion manuelle des fichiers.
  • Joignez 31 types de fichiers dans la conversation, notamment .kql, .bicep, .tf, .har, .py et .xlsx, pour le contexte d’analyse immédiate.
  • Charger 28 types de fichiers dans les paramètres de connaissances pour un stockage persistant et indexé dans toutes les conversations futures
  • Les résolutions d’incident deviennent automatiquement des connaissances institutionnelles

Le problème : les connaissances meurent avec la conversation

Chaque incident résolu par votre équipe génère des connaissances précieuses : ce qui s’est passé mal, quelles commandes l’ont résolu et ce qu’il faut vérifier la première fois à la prochaine fois. Mais cette connaissance vit dans les threads de conversation, la mémoire de l’ingénieur et les postmortems que personne ne lit à 3h00.

Votre équipe a des runbooks, mais ils deviennent lassants. Le correctif découvert pendant l’incident de la nuit dernière ? C'est dans la tête de quelqu'un, ou enfoui dans une conversation qui disparaît de la vue la semaine prochaine. La prochaine fois que le même problème se produit, un ingénieur différent commence à partir de zéro.

Comment votre agent résout ce problème

Votre agent peut charger des documents dans les paramètres de connaissances pendant les conversations à l’aide de l’outil Charger le document de connaissances . Lorsque votre agent découvre un correctif, crée un guide de résolution des problèmes ou synthétise les résultats d’investigation, il stocke ces connaissances directement et les rend accessibles à la recherche pour chaque conversation future.

"Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings."

Votre agent génère un runbook structuré et le charge en secondes. Le document est indexé automatiquement et devient pouvant faire l’objet d’une recherche pour les futures enquêtes.

Avant et après

Avant Après
Capture des connaissances Après l'incident : l'ingénieur rédige un manuel d'exploitation (peut-être) Votre agent capture le correctif tel qu’il se produit
Durée du document 30 à 60 minutes pour écrire un runbook Secondes. Votre agent génère et télécharge en ligne.
Actualisation des connaissances Les Runbooks deviennent obsolètes en l'espace de quelques semaines. Les paramètres de connaissance s’enrichissent à chaque résolution
Accessibilité Connaissance bloquée dans un fil de discussion ou dans la tête de l'ingénieur Pouvant faire l’objet d’une recherche par votre agent dans toutes les conversations futures
Cohérence du format Varie selon l’auteur Documentation structurée et cohérente à chaque fois

Ce qui rend cela différent

Contrairement aux chargements manuels, votre agent crée des connaissances de manière proactive. Vous n’avez pas besoin de vous rappeler de documenter ce que vous avez appris, car votre agent le fait dans le cadre de la conversation.

Contrairement à l’historique des conversations, les documents chargés sont indexés pour la recherche sémantique. Lorsqu’un problème similaire se produit plusieurs mois plus tard, votre agent trouve automatiquement le runbook pertinent par le biais d’une récupération intelligente, et non en faisant défiler les anciens threads.

Contrairement aux connecteurs wiki, les documents chargés ne nécessitent pas de services externes. Les connaissances se trouvent directement dans les paramètres de connaissances de votre agent, disponibles instantanément sans délai de synchronisation.

Fonctionnement

L’outil Charger le document de connaissances accepte trois paramètres :

Paramètre Obligatoire Description
Nom de fichier Oui Nom avec .md ou .txt extension (par exemple, database-pool-runbook.md)
Contenu Oui Texte intégral du document au format Markdown ou texte brut
Déclencher l’indexation Facultatif (valeur par défaut : true) Indique s’il faut rendre le document pouvant faire l’objet d’une recherche immédiate

Lorsque votre agent charge un document :

  1. Valide le nom de fichier et le contenu (jusqu’à 16 Mo par fichier).
  2. Stocke le document dans les paramètres de connaissances de votre agent.
  3. Indexe le contenu de la recherche sémantique.
  4. Confirme le chargement avec un message de réussite.

Note

Si un document portant le même nom de fichier existe déjà, le nouveau contenu le remplace. Ce processus facilite la mise à jour des connaissances de votre agent. Chargez avec le même nom pour actualiser le contenu.

Formats de fichiers pris en charge

Votre agent gère les fichiers via trois méthodes, chacune prenant en charge des formats différents.

Pièces jointes du chat

Faites glisser des fichiers dans n’importe quelle conversation pour donner à votre agent un contexte immédiat pour l’analyse : résolution des problèmes de scripts, fichiers de configuration, traces réseau, etc.

Catégorie Extensions
Images .png, , .jpg, .jpeg.gif, , .webp.svg
Documents .txt, , .md, .pdf.docx, , .pptx.xlsx
Données et configuration .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .env
Web et réseau .html, .har
Code et scripts .ts, , .js, .py.sh, , .sql.kql
Infrastructure .bicep, .tf

Limites : 10 Mo par fichier · Total de 50 Mo par message · 5 fichiers par message

Téléchargement des paramètres de connaissances

Pour conserver les documents de votre agent à référencer dans les conversations futures, chargez des fichiers via les paramètres du Générateur → Connaissances → Ajouter un fichier. Le système indexe les fichiers téléchargés pour la recherche sémantique.

Catégorie Extensions
Images .png, .jpg, .jpeg, .gif, .webp, .bmp, .tiff, .tif
Documents .txt, .md, .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls
Données et configuration .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Limites : 16 Mo par fichier · 100 Mo par chargement

Chargements de dossiers

Pour télécharger tous les fichiers pris en charge en même temps, glissez un dossier entier dans la zone de téléchargement. Ce processus inclut des fichiers dans des sous-dossiers imbriqués. Le portail extrait automatiquement chaque fichier de la hiérarchie de dossiers et filtre les types de fichiers non pris en charge.

Fonctionnement du chargement du dossier :

  1. Le système extrait tous les fichiers des sous-dossiers imbriqués dans une liste plate.
  2. Le système inclut uniquement des fichiers avec des extensions prises en charge et filtre silencieusement les types non pris en charge.
  3. Le système déduplique les fichiers avec des noms en double provenant de sous-dossiers différents et conserve uniquement le premier fichier.
  4. Le système charge et indexe chaque fichier individuellement pour la recherche.

Note

Les fichiers chargés apparaissent sous forme de documents individuels dans les sources de connaissances. La hiérarchie de dossiers d’origine n’est pas conservée. Un fichier apparaît runbooks/networking/dns-troubleshooting.md sous la forme dns-troubleshooting.md.

Les chargements des paramètres de connaissance acceptent les formats Office hérités (.doc, .ppt, .xls) et des formats d’image supplémentaires (.bmp, .tiff, .tif) que les pièces jointes de conversation ne prennent pas en charge. Les pièces jointes de chat prennent en charge le code, les scripts, l'infrastructure et les formats web que les paramètres de connaissances ne prennent pas en charge.

Documents générés par l’agent

Lorsque votre agent crée des documents pendant les conversations (à l’aide de l’outil Charger le document de connaissances), il génère .md ou .txt fichiers et les enregistre directement dans les paramètres de Connaissances. Ce processus se produit lorsque vous demandez à votre agent d’« enregistrer ceci en tant que runbook ».

Exemple : capture des connaissances sur les incidents

Lors d’une enquête sur les incidents, demandez à votre agent :

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to Knowledge settings.

Votre agent génère un guide de résolution des problèmes structuré avec :

  • Étapes exploratoires : Comment identifier le problème.
  • Atténuations rapides : actions immédiates pour réduire l’impact.
  • Analyse de la cause racine : Que faut-il examiner ?
  • Étapes de résolution : correctif qui a fonctionné.
  • Prévention : Comment éviter la récurrence.

La prochaine fois qu’un problème de processeur similaire se produit, votre agent fait automatiquement référence à ce document lors de l’examen, ce qui transforme l’expérience d’un ingénieur en connaissances d’équipe partagées.

Ce dont vous avez besoin

Prérequis Détails
Version de l’agent 26.1.57.0 ou version ultérieure
Paramètres de connaissances Activé sur votre agent
Autorisations d’écriture Votre agent a besoin d’un accès en écriture aux paramètres de connaissances
Mode d’exécution Réviser ou Autonome. Les actions d’écriture nécessitent une approbation en mode Révision.

Limites

Caractéristique Pièces jointes du chat Téléchargement des paramètres de connaissances Outil d'agent
Taille de fichier maximale 10 Mo 16 Mo 16 Mo
Total maximal 50 Mo par message 100 Mo par chargement N/A
Nombre maximal de fichiers 5 par message Aucune limite (taille totale limitée à 100 Mo) 1 par action
Chargement du dossier Non pris en charge • Faire glisser des dossiers pour charger tous les fichiers en même temps Non pris en charge
Extensions prises en charge 31 28 2 (.md, .txt)
Caractères de nom de fichier N/A Lettres, chiffres, traits d’union, traits de soulignement, points Identique
Longueur maximale du nom de fichier N/A 1 024 caractères Identique

Quand utiliser un autre élément

Scénario Meilleure approche
Connexion de contenu wiki en direct qui reste synchronisé Connaissances wiki ADO
Chargement de fichiers binaires (PDF, Word, images) Charger via les paramètres du Générateur → Connaissances → Ajouter un fichier
Importation en bloc de nombreux documents à la fois Charger plusieurs fichiers via les paramètres De connaissances du Générateur → → Ajouter un fichier
Mise à jour automatique des référentiels de code Connecter un connecteur GitHub ou ADO
Capacité Ce qu’il ajoute
Connaissances wiki ADO Connecter du contenu wiki en direct qui est mis à jour automatiquement
Analyse des causes profondes Examiner les problèmes et capturer les résultats