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.
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,.pyet.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 :
- Valide le nom de fichier et le contenu (jusqu’à 16 Mo par fichier).
- Stocke le document dans les paramètres de connaissances de votre agent.
- Indexe le contenu de la recherche sémantique.
- 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 :
- Le système extrait tous les fichiers des sous-dossiers imbriqués dans une liste plate.
- Le système inclut uniquement des fichiers avec des extensions prises en charge et filtre silencieusement les types non pris en charge.
- Le système déduplique les fichiers avec des noms en double provenant de sous-dossiers différents et conserve uniquement le premier fichier.
- 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 |
Fonctionnalités connexes
| 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 |