Esercitazione: Caricare documenti di knowledge base nell'agente SRE di Azure

In questa esercitazione si caricano i documenti delle informazioni nella knowledge base dell'agente SRE di Azure usando due metodi: chiedendo all'agente di creare un runbook da un'indagine e caricando un file tramite l'interfaccia utente del portale.

L'agente può acquisire conoscenze individuate durante le indagini e archiviarla per un uso futuro, creando automaticamente conoscenze istituzionali. Per altre informazioni, vedere Caricamento dei documenti della base di conoscenza.

In questa esercitazione apprenderai a:

Tempo stimato: 15 minuti

Prerequisiti

Prima di iniziare, verificare di disporre di quanto segue:

• Un agente SRE di Azure in stato in esecuzione .
• Autorizzazioni di scrittura per l'agente.
• Modalità di esecuzione agente impostata su Revisione o Autonomo.

Iniziare da un'indagine

I migliori documenti di conoscenza provengono da indagini reali. Invece di creare contenuto da zero, acquisire ciò che l'agente ha già appreso.

1. Passare a sre.azure.com e selezionare l'agente.
2. Nella barra laterale sinistra in Chat trovare un thread di indagine precedente in cui l'agente ha diagnosticato o risolto un problema e selezionarlo.

Se non si ha ancora un thread di indagine, avviare una nuova chat e chiedere all'agente di indagare su qualcosa:

Investigate high memory usage on our container apps

Attendere il completamento dell'indagine, quindi continuare con il passaggio successivo.

Creare una guida operativa dall'indagine

Nello stesso thread di indagine chiedere all'agente di trasformare i risultati in un runbook e salvarlo nella Knowledge Base. Specificare il nome del file.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to the knowledge base as high-memory-runbook.md

L'agente esegue le azioni seguenti:

1. Sintetizza il contesto di indagine in un runbook strutturato.
2. Genera sezioni come l'analisi della causa radice, i passaggi di diagnostica, le mitigazioni e i trigger di escalation.
3. Salva il documento nella Knowledge Base e conferma il caricamento.

L'agente conferma che il documento è stato salvato e fornisce un collegamento di download. Il runbook è ora archiviato nella Knowledge Base e verrà indicizzato per la ricerca.

A questo punto, verificare quanto segue:

• L'agente ha generato un runbook strutturato dall'indagine.
• L'agente ha confermato che il documento è stato salvato.

Verificare il documento nella Knowledge Base

Passare alla Knowledge Base per verificare che il documento sia stato indicizzato.

1. Nella barra laterale sinistra selezionare Generatore per espandere la sezione.
2. Selezionare Knowledge Base.

La pagina della Knowledge Base visualizza i documenti in una tabella con colonne per Nome file, Stato, Tipo e Ultima modifica. La colonna Stato mostra Indicizzato quando il documento viene indicizzato e pronto per la ricerca.

Se lo stato è In sospeso, selezionare Aggiorna. L'indicizzazione viene in genere completata entro pochi secondi.

Caricare un file tramite il portale

È anche possibile caricare direttamente i file. Questo metodo è utile per i runbook, la documentazione o i materiali di riferimento che il tuo team possiede già.

1. Nella pagina Knowledge Base selezionare Aggiungi file.
2. Trascinare un file nella zona di rilascio oppure selezionare Sfoglia file per scegliere.
3. Selezionare Aggiungi un file da caricare.

Il portale accetta i tipi di file seguenti:

• Testo: .md, .txt, .csv, .json, .xml, .yaml, .yml, .log, .ini, .cfg, .conf, .config, .properties
• Documenti: .pdf, .docx, .pptx, .xlsx, .doc, .ppt.xls
• Immagini: .png, .jpg, .jpeg.gif, .bmp, .webp, , .tiff.tif

La dimensione massima del file è di 16 MB per ogni file, con un massimo di 100 MB per caricamento.

Testare il recupero in una nuova conversazione

Verificare che l'agente possa trovare e usare i documenti caricati.

1. Selezionare Nuovo thread di chat nella barra laterale.
2. Porre una domanda a cui devono rispondere i documenti caricati.

Per esempio:

What are the steps for troubleshooting high memory usage on container apps?

L'agente cerca nella knowledge base, trova il runbook caricato e vi fa riferimento nella risposta. Ciò conferma che la conoscenza è indicizzata e recuperabile.

Acquisire informazioni dopo gli eventi imprevisti

Dopo aver risolto un problema, chiedere all'agente di conservare quanto appreso:

Create a runbook from the steps we just used to resolve this incident.
Include the root cause, investigation steps, and the fix.
Save it as incident-12345-resolution.md in the knowledge base.

Nel corso del tempo, si crea una libreria ricercabile di conoscenze istituzionali. Ogni evento imprevisto passato diventa una risorsa per quelli futuri.

Aggiornare i documenti esistenti

Caricare un documento con lo stesso nome file per sostituire la versione precedente:

Update the high-memory-runbook.md document in the knowledge base.
Add a new section about container memory limits as a common cause.

Caricamenti in batch tramite l'interfaccia della riga di comando

Importare più documenti contemporaneamente usando l'interfaccia della riga di comando:

# Upload a single file
srectl doc upload --file ./runbooks/high-memory-guide.md

# Upload all .md and .txt files in a folder (recursive)
srectl doc upload --file ./runbooks

Risoluzione dei problemi

Usare la tabella seguente per risolvere i problemi comuni relativi ai caricamenti dei documenti di knowledge base.

Passo successivo

Contenuti correlati

• Caricare documenti della base di conoscenza (funzionalità)
• Conoscenza wiki di Azure DevOps
• Memoria e conoscenza