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.
L'agente acquisisce informazioni istituzionali durante le conversazioni caricando runbook, guide alla risoluzione dei problemi e documentazione direttamente nella Knowledge Base. Quando l'agente individua una correzione o risolve un evento imprevisto, genera documenti strutturati e li indicizza per la ricerca semantica, quindi ogni analisi futura trae vantaggio dalle risoluzioni precedenti.
Suggerimento
L'agente crea e carica i runbooks durante le conversazioni senza gestione manuale dei file. Il sistema indicizza i documenti per la ricerca semantica, rendendoli disponibili per tutte le indagini future. Le risoluzioni degli incidenti diventano automaticamente conoscenze istituzionali.
Come l'agente acquisisce le conoscenze
L'agente può caricare documenti nella Knowledge Base durante le conversazioni usando lo strumento Carica documento knowledge . Quando l'agente individua una correzione, crea una guida alla risoluzione dei problemi o sintetizza i risultati dell'indagine, archivia le informazioni direttamente e lo rende ricercabile 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 the knowledge base.
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
Nella tabella seguente vengono confrontati i flussi di lavoro di acquisizione delle informazioni prima e dopo l'uso dello strumento Carica documento knowledge .
| Area | 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 | 30-60 minuti per scrivere un runbook | Secondi: l'agente genera e carica in linea |
| Freschezza delle conoscenze | I runbook diventano obsoleti in poche settimane. | La Knowledge Base cresce 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. 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 libretto operativo pertinente tramite il recupero intelligente delle informazioni, non scorrendo le vecchie discussioni.
A differenza dei connettori wiki, i documenti caricati non richiedono servizi esterni. La conoscenza risiede direttamente nella knowledge base dell'agente, disponibile 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:
- L'agente convalida il nome file e il contenuto (massimo 16 MB per file).
- L'agente archivia il documento nella Knowledge Base dell'agente.
- L'agente indicizza il contenuto per la ricerca semantica.
- L'agente 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. Caricare con lo stesso nome per aggiornare il contenuto.
Formati di file supportati
Lo strumento Carica documento conoscenze supporta formati basati su testo che l'agente genera in linea.
| Formato | Extension | Ideale per |
|---|---|---|
| Markdown | .md |
Runbook, guide alla risoluzione dei problemi con formattazione e intestazioni |
| Testo normale | .txt |
Note semplici, log, documentazione non elaborata |
Annotazioni
Quando si caricano file tramite l'API o l'interfaccia della riga di comando, è possibile usare più formati di testo, tra cui CSV, JSON, YAML e file di log. L'API di caricamento supporta formati binari (PDF, Word, Excel, PowerPoint) e immagini. Lo strumento agente si concentra sui formati .md e .txt perché l'agente genera contenuto di testo durante le conversazioni.
Esempio: acquisire 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 the knowledge base.
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 una conoscenza condivisa del team.
Prerequisiti
Prima di usare lo strumento Carica documento conoscenze, assicurarsi di soddisfare i requisiti seguenti.
| Requisito | dettagli |
|---|---|
| Versione agente | 26.1.57.0 o versione successiva |
| Base di Conoscenza | Abilitato nell'agente |
| Autorizzazioni di scrittura | L'agente deve accedere in scrittura alla Knowledge Base |
| Modalità di esecuzione | Revisione o autonoma (le azioni di scrittura richiedono l'approvazione in modalità di revisione) |
Limits
I limiti seguenti si applicano ai documenti di knowledge base caricati.
| Limit | Valore |
|---|---|
| Dimensione massima dei file | 16 MB per documento |
| Estensioni supportate |
.md e .txt |
| Caratteri del nome del file | Lettere, numeri, trattini, caratteri di sottolineatura, punti (no /, \?, , #) |
| Lunghezza massima del nome file | 1.024 caratteri |
Quando usare qualcos'altro
La tabella seguente descrive gli scenari in cui un approccio diverso è più appropriato.
| Scenario | Approccio migliore |
|---|---|
| Connessione di contenuti wiki live che rimangono sincronizzati | Conoscenza wiki di Azure DevOps |
| Caricamento di file binari (PDF, Word, immagini) | Caricare manualmente tramite Generatore > Knowledge Base > Aggiungi file |
| Importazione bulk di molti documenti contemporaneamente | Usare il comando CLI srectl doc upload --file <path> |