Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Votre agent capture les connaissances institutionnelles pendant les conversations en chargeant des runbooks, des guides de résolution des problèmes et de la documentation directement dans la base de connaissances. Lorsque votre agent découvre un correctif ou résout un incident, il génère des documents structurés et les indexe pour la recherche sémantique, de sorte que chaque investigation future tire parti des résolutions passées.
Conseil / Astuce
Votre agent crée et télécharge des runbooks au cours des conversations sans gestion manuelle des fichiers. Le système indexe les documents pour la recherche sémantique, les rendant disponibles pour toutes les futures enquêtes. Les résolutions des incidents deviennent automatiquement des connaissances institutionnelles.
Comment votre agent capture les connaissances
Votre agent peut charger des documents dans la base 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 the knowledge base.
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
Le tableau suivant compare les flux de travail de capture de connaissances avant et après l’utilisation de l’outil Charger le document de connaissances .
| Domaine | 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 rédiger un guide opérationnel | Secondes : votre agent génère et charge en ligne |
| Actualisation des connaissances | Les Runbooks deviennent obsolètes en l'espace de quelques semaines. | La base de connaissances augmente avec 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. 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 résident directement dans la base de connaissances de votre agent, disponible instantanément sans retards 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 :
- L’agent valide le nom de fichier et le contenu (16 Mo maximum par fichier).
- L’agent stocke le document dans la base de connaissances de votre agent.
- L’agent indexe le contenu de la recherche sémantique.
- L’agent 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. Chargez avec le même nom pour actualiser le contenu.
Formats de fichiers pris en charge
L’outil Charger le document de connaissances prend en charge les formats textuels générés par votre agent en ligne.
| Format | Extension | Idéal pour |
|---|---|---|
| Markdown | .md |
Runbooks, guides de résolution des problèmes avec mise en forme et en-têtes |
| Texte brut | .txt |
Notes simples, journaux d’activité, documentation brute |
Note
Lorsque vous chargez des fichiers via l’API ou l’interface CLI, vous pouvez utiliser d’autres formats de texte, notamment CSV, JSON, YAML et fichiers journaux. L’API de chargement prend en charge les formats binaires (PDF, Word, Excel, PowerPoint) et les images. L’outil agent se concentre sur les formats .md et .txt, car votre agent génère du contenu texte pendant les conversations.
Exemple : capturer les 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 the knowledge base.
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 faire pour examiner
- Étapes de résolution : correctif qui a fonctionné
- Prévention : Comment éviter la récidive
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.
Prerequisites
Avant d’utiliser l’outil Charger le document de connaissances, veillez à répondre aux exigences suivantes.
| Prérequis | Détails |
|---|---|
| Version de l’agent | 26.1.57.0 ou version ultérieure |
| Base de connaissances | Activé sur votre agent |
| Autorisations d’écriture | Votre agent a besoin d’un accès en écriture à la base de connaissances |
| Mode d’exécution | Révision ou autonome (les actions d’écriture nécessitent une approbation en mode Révision) |
Limites
Les limites suivantes s’appliquent aux documents de connaissances chargés.
| Limite | Valeur |
|---|---|
| Taille maximale du fichier | 16 Mo par document |
| Extensions prises en charge |
.md et .txt |
| Caractères de nom de fichier | Lettres, chiffres, traits d’union, traits de soulignement, points (non /, \, ?, #) |
| Longueur maximale du nom de fichier | 1 024 caractères |
Quand utiliser un autre élément
Le tableau suivant décrit les scénarios où une approche différente est plus appropriée.
| Scénario | Meilleure approche |
|---|---|
| Connexion de contenu wiki en direct qui reste synchronisé | Connaissances du wiki Azure DevOps |
| Chargement de fichiers binaires (PDF, Word, images) | Télécharger manuellement via Builder > Base de connaissances > Ajouter un fichier |
| Importation en bloc de nombreux documents à la fois | Utiliser la srectl doc upload --file <path> commande CLI |