Caricare documenti della base di conoscenze nell'agente SRE di Azure

Ogni incidente risolto dal team genera informazioni preziose: cosa è andato storto, quali comandi hanno risolto il problema e cosa controllare la prossima volta. Ma questa conoscenza vive nei thread di chat, nella memoria degli ingegneri e nei post mortem che nessuno legge alle 3:00.

Il tuo team ha i runbook, ma non sono aggiornati. La correzione scoperta durante l'incidente di ieri sera? È nella testa di qualcuno, o sepolto in una conversazione che scorrerà fuori dalla vista entro la prossima settimana. La volta successiva che si verifica lo stesso problema, un tecnico diverso inizia da zero.

Come l'agente risolve questo problema

L'agente può caricare documenti nelle impostazioni della conoscenza durante le conversazioni usando lo strumento Carica documento conoscenza. Quando l'agente individua una correzione, crea una guida alla risoluzione dei problemi o sintetizza i risultati dell'indagine, archivia direttamente tali informazioni. Questo approccio rende le informazioni ricercabili 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 Knowledge settings.

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

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 Da 30 a 60 minuti per scrivere un runbook Secondi. L'agente genera e carica in linea.
Freschezza delle conoscenze I runbook diventano obsoleti in poche settimane Le impostazioni delle informazioni aumentano 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 perché 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 runbook pertinente tramite il recupero intelligente delle informazioni, non scorrendo le vecchie discussioni.

A differenza dei connettori wiki, i documenti caricati non richiedono servizi esterni. Le conoscenze si trovano direttamente nelle impostazioni della Knowledge Base dell'agente, disponibili immediatamente senza ritardi di sincronizzazione.

Come funziona

Lo strumento Carica documento conoscenze accetta tre parametri:

Parametro Obbligatorio Descrizione
Nome del file Nome con .md o .txt estensione (ad esempio, database-pool-runbook.md)
Content 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:

  1. Convalida il nome file e il contenuto (fino a 16 MB per file).
  2. Archivia il documento nelle impostazioni di conoscenza dell'agente.
  3. Indicizza il contenuto per la ricerca semantica.
  4. 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. Questo processo semplifica l'aggiornamento delle informazioni da parte dell'agente. Caricare il documento usando lo stesso nome per aggiornare il contenuto.

Formati di file supportati

L'agente gestisce i file tramite tre metodi, ognuno dei quali supporta formati diversi.

Allegati di chat

Trascinare i file in qualsiasi chat per fornire all'agente un contesto immediato per l'analisi: risoluzione dei problemi di script, file di configurazione, tracce di rete e altro ancora.

Categoria Estensioni
Images .png, .jpg, .jpeg, .gif, .webp.svg
Documents .txt, .md, .pdf, .docx, .pptx.xlsx
Dati e configurazione .json, .csv, .log, .yaml, .yml.xml, .ini, , .conf.env
Web e rete .html, .har
Codice e script .ts, .js, .py, .sh, .sql.kql
Infrastruttura .bicep, .tf

Limiti: 10 MB per file · 50 MB totali per messaggio · 5 file per messaggio

Caricamenti delle impostazioni di conoscenza

Per rendere persistenti i documenti a cui fare riferimento l'agente nelle conversazioni future, caricare i file tramite Le impostazioni di Generatore → Knowledge → Aggiungi file. Il sistema indicizza i file caricati per la ricerca semantica.

Categoria Estensioni
Images .png, .jpg, .jpeg, .gif.webp, .bmp, , .tiff.tif
Documents .txt, .md, .pdf, .docx, .pptx.xlsx, .doc, , .ppt.xls
Dati e configurazione .json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Limiti: 16 MB per file · 100 MB per caricamento

Caricamenti di cartelle

Per caricare tutti i file supportati contemporaneamente, trascinare un'intera cartella nell'area di rilascio dell'upload. Questo processo include i file nelle sottocartelle annidate. Il portale estrae automaticamente ogni file dalla gerarchia di cartelle e filtra i tipi di file non supportati.

Funzionamento dei caricamenti delle cartelle:

  1. Il sistema estrae tutti i file dalle sottocartelle annidate in un elenco senza gerarchie.
  2. Il sistema include solo file con estensioni supportate e filtra silenziosamente i tipi non supportati.
  3. Il sistema deduplica i file con nomi duplicati di sottocartelle diverse e mantiene solo il primo file.
  4. Il sistema carica e indicizza ogni file singolarmente per la ricerca.

Annotazioni

I file caricati vengono visualizzati come singoli documenti nelle origini delle informazioni. La gerarchia di cartelle originale non viene mantenuta. Un file in runbooks/networking/dns-troubleshooting.md viene visualizzato come dns-troubleshooting.md.

I caricamenti delle impostazioni delle informazioni accettano formati legacy di Office (.doc, .ppt, .xls) e altri formati di immagine (.bmp, .tiff, .tif) che gli allegati di chat non lo fanno. Gli allegati di chat supportano codice, script, infrastruttura e formati Web che non sono disponibili nelle impostazioni della knowledge base.

Documenti generati dall'agente

Quando il tuo agente crea documenti durante le conversazioni (usando lo strumento Carica documento della conoscenza), genera file .md o .txt e li salva direttamente nelle impostazioni di Knowledge. Questo processo si verifica quando si chiede all'agente di "salvare come runbook".

Esempio: acquisizione delle 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 Knowledge settings.

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 conoscenze condivise del team.

Elementi necessari

Requisito dettagli
Versione agente 26.1.57.0 o versione successiva
Impostazioni delle conoscenze Abilitato nell'agente
Autorizzazioni di scrittura L'agente necessita dell'accesso in scrittura alle impostazioni della Knowledge Base
Modalità di esecuzione Revisione o modalità autonoma. Le azioni di scrittura richiedono l'approvazione in modalità revisione

Limits

TIPO Allegati di chat Caricamenti delle impostazioni di conoscenza Strumento dell'agente
Dimensioni massime del file 10 MB 16 MB 16 MB
Totale massimo 50 MB per messaggio 100 MB per caricamento Non applicabile
Numero massimo di file 5 per messaggio Nessun limite (dimensione totale limitata a 100 MB) 1 per azione
Caricamento cartelle Non supportato ✓ Trascinare le cartelle per caricare tutti i file contemporaneamente Non supportato
Estensioni supportate 31 28 2 (.md, .txt)
Caratteri nome file Non applicabile Lettere, numeri, trattini, caratteri di sottolineatura, punti Uguali
Lunghezza massima del nome file Non applicabile 1.024 caratteri Uguali

Quando usare qualcos'altro

Scenario Approccio migliore
Connessione di contenuti wiki live che rimangono sincronizzati ADO Wiki Knowledge
Caricamento di file binari (PDF, Word, immagini) Caricare tramite le impostazioni di Generatore → Knowledge → Aggiungi file
Importazione bulk di molti documenti contemporaneamente Caricare più file tramite Le impostazioni di Generatore → Knowledge → Aggiungi file
Mantenere aggiornati automaticamente i repository di codice Connettere un connettore GitHub o ADO
Capability Elementi aggiunti
Conoscenza wiki di ADO Connetti contenuti live del wiki che si aggiornano automaticamente
Analisi della causa radice Analizzare i problemi e acquisire i risultati