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

In questa esercitazione, si caricano i documenti di conoscenza nelle impostazioni di conoscenza dell'agente SRE di Azure usando due metodi: chiedere all'agente di creare un runbook a partire da un'indagine e caricare un file tramite l'interfaccia utente del portale.

L'agente può acquisire conoscenze individuate durante le indagini e archiviarla per un uso futuro, in modo da creare 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 aver soddisfatto le risorse e i prerequisiti seguenti:

• 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 e quindi continuare con il passaggio successivo.

Creare un runbook dall'indagine

Nello stesso thread dell'indagine, puoi chiedere al tuo agente di trasformare i risultati in un runbook e salvarlo nelle impostazioni di Knowledge. 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 Knowledge settings 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 nelle impostazioni della Knowledge Base e conferma il caricamento.

L'agente conferma che il documento è stato salvato e fornisce un collegamento di download. Il runbook è ora archiviato nelle impostazioni della Knowledge Base ed è indicizzato per la ricerca.

A questo punto, verificare le informazioni seguenti:

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

Verificare nelle impostazioni della Knowledge Base

Passare a Impostazioni knowledge per verificare che il documento sia indicizzato.

1. Nella barra laterale sinistra selezionare Generatore per espandere la sezione.
2. Selezionare Impostazioni della conoscenza.

Nella pagina Impostazioni knowledge vengono visualizzati i documenti in una tabella con le colonne 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 delle Impostazioni della conoscenza selezionare Aggiungi file.
2. Trascinare un file nella zona di rilascio oppure selezionare Sfoglia file per scegliere.
3. Selezionare Aggiungi file da caricare.

Il portale accetta molti tipi di file per le impostazioni della Knowledge Base, inclusi file di testo, documenti e immagini. Per l'elenco completo delle estensioni supportate e dei limiti delle dimensioni, vedere Caricare i documenti delle informazioni.

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 le impostazioni delle informazioni, trova il runbook caricato e vi fa riferimento nella risposta. Questa conferma mostra che le informazioni sono indicizzate e recuperabili.

Eliminare un documento di conoscenza

Per rimuovere un documento dalle impostazioni della Knowledge Base, seguire questa procedura.

1. Passare alle impostazioni di conoscenza del Builder.
2. Nell'elenco dei documenti selezionare uno o più documenti usando le caselle di controllo.
3. Selezionare Elimina sulla barra degli strumenti.
4. Una finestra di dialogo di conferma elenca i documenti da rimuovere. Seleziona Elimina per confermare.

I documenti eliminati vengono rimossi dalle impostazioni knowledge dell'agente e non vengono più visualizzati nei risultati della ricerca.

Risoluzione dei problemi

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

Contenuti correlati