Esercitazione: Caricare documenti di conoscenza in SRE Agent di Azure

In questa esercitazione si caricano documenti di conoscenza nell'agente SRE Azure in modo che possa farvi riferimento durante le indagini future. Si apprenderà come salvare i risultati dell'indagine direttamente nelle impostazioni della Knowledge Base tramite chat e come caricare i file esistenti tramite l'interfaccia utente del portale.

In questa esercitazione apprenderai a:

  • Trasforma un'indagine in un runbook riutilizzabile e salvalo nelle impostazioni Knowledge
  • Verificare che il contenuto caricato sia indicizzato e ricercabile
  • Caricare singoli file o cartelle tramite il portale
  • Verificare che l'agente possa recuperare il contenuto caricato in una nuova conversazione

Tempo stimato: 10 minuti

Prerequisiti

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

Passaggio 1: 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, qualsiasi conversazione 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 2.

Passaggio 2: Chiedere all'agente di creare un runbook

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:

  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.

Checkpoint

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

Passaggio 3: Verificare nelle impostazioni della Knowledge Base

  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.

Checkpoint

  • Navigato a Generatore → Impostazioni conoscenza
  • Il documento viene visualizzato con ✓ Stato indicizzato

Passaggio 4: Caricare file tramite il portale

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

Caricare singoli file

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

Caricare una cartella

È anche possibile trascinare un'intera cartella, incluse le sottocartelle annidate, nell'area di rilascio.

  1. Nella pagina Origini informazioni selezionare Aggiungi file.
  2. Trascinare una cartella dal gestore di file direttamente nell'area di rilascio.
  3. Il portale estrae tutti i file supportati dalla cartella e dalle relative sottocartelle, quindi li elenca nella finestra di dialogo.
  4. Esaminare l'elenco di file: rimuovere tutti i file che non si desidera selezionare l'icona di eliminazione accanto a ogni file.
  5. Selezionare Aggiungi file per caricare tutti i file elencati.

Il portale filtra automaticamente i file con estensioni non supportate. Per l'elenco completo delle estensioni e dei limiti di dimensioni supportati, vedere la pagina relativa alla funzionalità Carica documenti delle informazioni.

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

Annotazioni

Quando si carica una cartella, il portale non mantiene la struttura di cartelle: i file delle sottocartelle vengono visualizzati come singoli documenti. Se i file in sottocartelle diverse condividono lo stesso nome, viene caricato solo il primo file.

Checkpoint

  • È stata selezionata l'opzione Aggiungi file ed è stata visualizzata la finestra di dialogo di caricamento.
  • Caricato un file o trascinato correttamente una cartella.
  • I file vengono visualizzati nelle fonti di conoscenza con lo stato ✓ indicizzato.

Passaggio 5: Testare il recupero in una nuova conversazione

Avviare un nuovo thread di chat e porre una domanda a cui devono rispondere i documenti caricati:

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. Questo processo conferma che la conoscenza è indicizzata e recuperabile.

Checkpoint

  • Avviare un nuovo thread di chat
  • È stata posta una domanda relativa al contenuto caricato
  • L'agente ha fatto riferimento al documento caricato nella risposta

Eliminare un documento di conoscenza

  1. Vai a Generatore → Impostazioni della conoscenza.
  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.

Quando si eliminano i documenti, li si rimuove dalle impostazioni di Knowledge dell'agente e non vengono più visualizzati nei risultati di ricerca.

Annotazioni

Non è possibile modificare i documenti di conoscenza sul posto. Per aggiornare un documento, caricare una nuova versione con lo stesso nome file. La nuova versione sostituisce la versione precedente.

Che cosa si è appreso

  • L'agente può trasformare le indagini reali in runbook strutturati e salvarli nelle impostazioni di Knowledge.
  • È possibile caricare manualmente i file tramite l'interfaccia utente del portale in Builder → Impostazioni Conoscenza. Supporta molti formati, tra cui PDF, documenti di Office e immagini.
  • Il sistema indicizza i documenti caricati per la ricerca semantica e sono disponibili in tutte le conversazioni future.
  • Per aggiornare i documenti, caricarli usando lo stesso nome file.

Risoluzione dei problemi

Error Motivo Correzione
"La memoria dell'agente è disabilitata. Impossibile caricare documenti." Le impostazioni di conoscenza non sono attivate sul tuo agente Contattare l'amministratore per abilitare le impostazioni della Knowledge Base
"I don't have write access to your Knowledge settings" (Non ho accesso in scrittura alle impostazioni della Knowledge Base) Agent non è riuscito a individuare lo strumento di caricamento Riformulare la richiesta: "Salvarla nelle impostazioni della Knowledge base come filename.md"
"Estensione di file non valida. Sono consentiti solo i file md e .txt." Il nome file non termina con .md o .txt (caricamento chat) Usare un'estensione .md o .txt quando si chiede all'agente di salvare
"Il contenuto del documento supera le dimensioni massime di 16 MB" Contenuto troppo grande per un singolo documento Suddividere in più documenti più piccoli
"Il nome file non può essere vuoto" Nessun nome del file fornito Includere un nome file nel prompt (ad esempio, runbook.md)
risorsa Cosa imparerai
Caricare documenti di conoscenza Come funziona e perché è importante
Creare una competenza Creare competenze procedurali che integrano i documenti delle conoscenze
Abilità Come interagiscono le competenze e le conoscenze
ADO wiki Knowledge Collega contenuti wiki live come fonti di conoscenza
  • Last updated on