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.
Tempo stimato: 5 minuti
Caricate i runbook e la documentazione così che l'agente utilizzi le procedure del vostro team, non informazioni generiche.
Ciò che si ottiene
Al termine di questo passaggio, l'agente:
- Utilizza i manuali operativi durante la risoluzione dei problemi
- Fa riferimento alla documentazione nelle risposte
- Mostra le origini per dimostrare il documento usato
Prerequisiti
| Requisito | dettagli |
|---|---|
| Agente creato | Completare il passaggio 1: Creare prima l'agente . |
| File di documentazione | Runbook, playbook o guide alla risoluzione dei problemi (.md, .txt). |
Annotazioni
Questo passaggio illustra i caricamenti di file, che è il modo più rapido per aggiungere informazioni. L'agente può anche fare riferimento alla documentazione dei repository di Azure DevOps e dei repository GitHub tramite connettori (vedi Builder>Connettori) e alle origini dati non Microsoft tramite connettori MCP.
Aprire la Knowledge Base
Passare alla Knowledge Base nel portale dell'agente.
- Selezionare Builder nella barra laterale sinistra.
- Selezionare Knowledge Base.
Viene visualizzato uno stato vuoto che richiede di aggiungere una fonte di conoscenza.
Caricare i file
Aggiungere i primi file di documentazione alla Knowledge Base.
- Selezionare Aggiungi file.
- Selezionare i file di documentazione, ad esempio runbook, procedure di escalation e riferimenti alle query.
- Attendere il completamento dell'indicizzazione (in genere istantaneo).
| Formati supportati | Dimensioni massime |
|---|---|
Markdown (.md), Testo (.txt) |
16 MB per file, 100 MB per caricamento |
Suggerimento
Carica prima i "runbook" più usati. È sempre possibile aggiungere altri elementi in un secondo momento. Se non si dispone ancora di runbook, l'agente può crearli automaticamente durante le conversazioni. Trasforma automaticamente i risultati dell'indagine in procedure documentate.
Verificare la base di conoscenze
Verificare che l'agente possa accedere alla documentazione caricata.
Chiedere all'agente qualcosa nel file caricato:
What runbooks or procedures do you have in your knowledge base?
Dovresti vedere i seguenti risultati:
- "Indicatore di ricerca in corso nella knowledge base..."
- Origini che mostrano il nome del file caricato.
- Contenuto del documento, non esempi generici.
Comprendere la differenza
Senza una knowledge base, l'agente risponde con risposte generiche:
"Non ho informazioni specifiche sulle procedure del tuo team..."
Con la knowledge base, l'agente fa riferimento alle procedure documentate:
"In base alla knowledge base, ho trovato le procedure seguenti..."
Documenti consigliati
Nella tabella seguente sono elencati i tipi di documento comuni da caricare e il valore specificato.
| Tipo di documento | Esempio | Valore |
|---|---|---|
| Guide alla risoluzione dei problemi | http-500-errors.md |
Primi passaggi di risposta |
| Riferimenti alle query | loki-queries.md |
Query verificate del team |
| Percorsi di escalation | on-call.md |
Chi contattare |
| Runbooks | deployment-rollback.md |
Procedure dettagliate |