Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Ogni incidente risolto dal team genera informazioni preziose: cosa è andato storto, quali comandi hanno risolto il problema e cosa controllare la prossima volta. Ma questa conoscenza vive nei thread di chat, nella memoria degli ingegneri e nei post mortem che nessuno legge alle 3:00.
Il tuo team ha i runbook, ma non sono aggiornati. La correzione scoperta durante l'incidente di ieri sera? È nella testa di qualcuno, o sepolto in una conversazione che scorrerà fuori dalla vista entro la prossima settimana. La volta successiva che si verifica lo stesso problema, un tecnico diverso inizia da zero.
Come l'agente risolve questo problema
L'agente può caricare documenti nelle impostazioni della conoscenza durante le conversazioni usando lo strumento Carica documento conoscenza. Quando l'agente individua una correzione, crea una guida alla risoluzione dei problemi o sintetizza i risultati dell'indagine, archivia direttamente tali informazioni. Questo approccio rende le informazioni ricercabili per ogni conversazione futura.
Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings.
L'agente genera un runbook strutturato e lo carica in pochi secondi. Il documento viene indicizzato automaticamente e diventa ricercabile per indagini future.
Prima e dopo
| Prima | Dopo | |
|---|---|---|
| Acquisizione delle informazioni | Post-evento imprevisto: l'ingegnere scrive un runbook (forse) | L'agente acquisisce la correzione man mano che si verifica |
| Tempo per il documento | Da 30 a 60 minuti per scrivere un runbook | Secondi. L'agente genera e carica in linea. |
| Freschezza delle conoscenze | I runbook diventano obsoleti in poche settimane | Le impostazioni delle informazioni aumentano con ogni risoluzione |
| Accessibilità | Conoscenza confinata nella testa dell'ingegnere o nel thread di chat | Ricercabile dall'agente in tutte le conversazioni future |
| Coerenza del formato | Varia in base all'autore | Documentazione strutturata e coerente ogni volta |
Cosa rende questo diverso
A differenza dei caricamenti manuali, l'agente crea informazioni in modo proattivo. Non è necessario ricordare di documentare ciò che si è appreso perché l'agente lo esegue come parte della conversazione.
A differenza della cronologia delle chat, i documenti caricati vengono indicizzati per la ricerca semantica. Quando si verifica un problema simile mesi dopo, l'agente trova automaticamente il runbook pertinente tramite il recupero intelligente delle informazioni, non scorrendo le vecchie discussioni.
A differenza dei connettori wiki, i documenti caricati non richiedono servizi esterni. Le conoscenze si trovano direttamente nelle impostazioni della Knowledge Base dell'agente, disponibili immediatamente senza ritardi di sincronizzazione.
Come funziona
Lo strumento Carica documento conoscenze accetta tre parametri:
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
| Nome del file | Sì | Nome con .md o .txt estensione (ad esempio, database-pool-runbook.md) |
| Content | Sì | Testo completo del documento in formato Markdown o testo normale |
| Attivare l'indicizzazione | Facoltativo (impostazione predefinita: true) |
Indica se rendere il documento ricercabile immediatamente |
Quando l'agente carica un documento:
- Convalida il nome file e il contenuto (fino a 16 MB per file).
- Archivia il documento nelle impostazioni di conoscenza dell'agente.
- Indicizza il contenuto per la ricerca semantica.
- Conferma il caricamento con un messaggio di operazione riuscita.
Annotazioni
Se esiste già un documento con lo stesso nome file, il nuovo contenuto lo sostituisce. Questo processo semplifica l'aggiornamento delle informazioni da parte dell'agente. Caricare il documento usando lo stesso nome per aggiornare il contenuto.
Formati di file supportati
L'agente gestisce i file tramite tre metodi, ognuno dei quali supporta formati diversi.
Allegati di chat
Trascinare i file in qualsiasi chat per fornire all'agente un contesto immediato per l'analisi: risoluzione dei problemi di script, file di configurazione, tracce di rete e altro ancora.
| Categoria | Estensioni |
|---|---|
| Images |
.png, .jpg, .jpeg, .gif, .webp.svg |
| Documents |
.txt, .md, .pdf, .docx, .pptx.xlsx |
| Dati e configurazione |
.json, .csv, .log, .yaml, .yml.xml, .ini, , .conf.env |
| Web e rete |
.html, .har |
| Codice e script |
.ts, .js, .py, .sh, .sql.kql |
| Infrastruttura |
.bicep, .tf |
Limiti: 10 MB per file · 50 MB totali per messaggio · 5 file per messaggio
Caricamenti delle impostazioni di conoscenza
Per rendere persistenti i documenti a cui fare riferimento l'agente nelle conversazioni future, caricare i file tramite Le impostazioni di Generatore → Knowledge → Aggiungi file. Il sistema indicizza i file caricati per la ricerca semantica.
| Categoria | Estensioni |
|---|---|
| Images |
.png, .jpg, .jpeg, .gif.webp, .bmp, , .tiff.tif |
| Documents |
.txt, .md, .pdf, .docx, .pptx.xlsx, .doc, , .ppt.xls |
| Dati e configurazione |
.json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties |
Limiti: 16 MB per file · 100 MB per caricamento
Caricamenti di cartelle
Per caricare tutti i file supportati contemporaneamente, trascinare un'intera cartella nell'area di rilascio dell'upload. Questo processo include i file nelle sottocartelle annidate. Il portale estrae automaticamente ogni file dalla gerarchia di cartelle e filtra i tipi di file non supportati.
Funzionamento dei caricamenti delle cartelle:
- Il sistema estrae tutti i file dalle sottocartelle annidate in un elenco senza gerarchie.
- Il sistema include solo file con estensioni supportate e filtra silenziosamente i tipi non supportati.
- Il sistema deduplica i file con nomi duplicati di sottocartelle diverse e mantiene solo il primo file.
- Il sistema carica e indicizza ogni file singolarmente per la ricerca.
Annotazioni
I file caricati vengono visualizzati come singoli documenti nelle origini delle informazioni. La gerarchia di cartelle originale non viene mantenuta. Un file in runbooks/networking/dns-troubleshooting.md viene visualizzato come dns-troubleshooting.md.
I caricamenti delle impostazioni delle informazioni accettano formati legacy di Office (.doc, .ppt, .xls) e altri formati di immagine (.bmp, .tiff, .tif) che gli allegati di chat non lo fanno. Gli allegati di chat supportano codice, script, infrastruttura e formati Web che non sono disponibili nelle impostazioni della knowledge base.
Documenti generati dall'agente
Quando il tuo agente crea documenti durante le conversazioni (usando lo strumento Carica documento della conoscenza), genera file .md o .txt e li salva direttamente nelle impostazioni di Knowledge. Questo processo si verifica quando si chiede all'agente di "salvare come runbook".
Esempio: acquisizione delle informazioni sugli eventi imprevisti
Durante un'indagine sugli eventi imprevisti, chiedere all'agente:
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.
L'agente genera una guida alla risoluzione dei problemi strutturata con:
- Procedura di definizione dell'ambito: come identificare il problema
- Mitigazioni rapide: azioni immediate per ridurre l'impatto.
- Analisi della causa radice: cosa analizzare.
- Passaggi di risoluzione: La correzione che ha funzionato.
- Prevenzione: come evitare la ricorrenza.
La volta successiva che si verifica un problema di CPU simile, l'agente fa automaticamente riferimento a questo documento durante l'indagine, trasformando l'esperienza di un tecnico in conoscenze condivise del team.
Elementi necessari
| Requisito | dettagli |
|---|---|
| Versione agente | 26.1.57.0 o versione successiva |
| Impostazioni delle conoscenze | Abilitato nell'agente |
| Autorizzazioni di scrittura | L'agente necessita dell'accesso in scrittura alle impostazioni della Knowledge Base |
| Modalità di esecuzione | Revisione o modalità autonoma. Le azioni di scrittura richiedono l'approvazione in modalità revisione |
Limits
| TIPO | Allegati di chat | Caricamenti delle impostazioni di conoscenza | Strumento dell'agente |
|---|---|---|---|
| Dimensioni massime del file | 10 MB | 16 MB | 16 MB |
| Totale massimo | 50 MB per messaggio | 100 MB per caricamento | Non applicabile |
| Numero massimo di file | 5 per messaggio | Nessun limite (dimensione totale limitata a 100 MB) | 1 per azione |
| Caricamento cartelle | Non supportato | ✓ Trascinare le cartelle per caricare tutti i file contemporaneamente | Non supportato |
| Estensioni supportate | 31 | 28 | 2 (.md, .txt) |
| Caratteri nome file | Non applicabile | Lettere, numeri, trattini, caratteri di sottolineatura, punti | Uguali |
| Lunghezza massima del nome file | Non applicabile | 1.024 caratteri | Uguali |
Quando usare qualcos'altro
| Scenario | Approccio migliore |
|---|---|
| Connessione di contenuti wiki live che rimangono sincronizzati | ADO Wiki Knowledge |
| Caricamento di file binari (PDF, Word, immagini) | Caricare tramite le impostazioni di Generatore → Knowledge → Aggiungi file |
| Importazione bulk di molti documenti contemporaneamente | Caricare più file tramite Le impostazioni di Generatore → Knowledge → Aggiungi file |
| Mantenere aggiornati automaticamente i repository di codice | Connettere un connettore GitHub o ADO |
Funzionalità correlate
| Capability | Elementi aggiunti |
|---|---|
| Conoscenza wiki di ADO | Connetti contenuti live del wiki che si aggiornano automaticamente |
| Analisi della causa radice | Analizzare i problemi e acquisire i risultati |