Condividi tramite


Caricare documenti di knowledge base nell'agente SRE di Azure

L'agente acquisisce informazioni istituzionali durante le conversazioni caricando runbook, guide alla risoluzione dei problemi e documentazione direttamente nella Knowledge Base. Quando l'agente individua una correzione o risolve un evento imprevisto, genera documenti strutturati e li indicizza per la ricerca semantica, quindi ogni analisi futura trae vantaggio dalle risoluzioni precedenti.

Suggerimento

L'agente crea e carica i runbooks durante le conversazioni senza gestione manuale dei file. Allegare 31 tipi di file in chat, tra cui .kql, .bicep.tf, .har.py, , e .xlsx, per il contesto di analisi immediata. Caricare 28 tipi di file nelle impostazioni knowledge per l'archiviazione persistente indicizzata in tutte le conversazioni future. Le risoluzioni degli incidenti diventano automaticamente conoscenze istituzionali.

Come l'agente acquisisce le conoscenze

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 le informazioni direttamente e lo rende ricercabile 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.

Generazione e caricamento di una guida alla risoluzione dei problemi durante una conversazione

Prima e dopo

Nella tabella seguente vengono confrontati i flussi di lavoro di acquisizione delle informazioni prima e dopo l'uso dello strumento Carica documento knowledge .

Area 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 30-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 approccio diverso

A differenza dei caricamenti manuali, l'agente crea in modo proattivo informazioni. Non è necessario ricordare di documentare ciò che si è appreso. 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. L'agente convalida il nome file e il contenuto (massimo 16 MB per file).
  2. L'agente archivia il documento nelle impostazioni di conoscenza dell'agente.
  3. L'agente indicizza il contenuto per la ricerca semantica.
  4. L'agente 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. Caricare usando lo stesso nome per aggiornare i contenuti.

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, inclusi gli script di risoluzione dei problemi, i file di configurazione, le 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

Caricare file tramiteLe impostazioni> della Knowledge Base di Builder>Aggiungere file per rendere persistenti i documenti a cui fare riferimento l'agente nelle conversazioni future. 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

Annotazioni

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 non supportati dalle impostazioni della Knowledge Base.

Documenti generati dall'agente

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

Finestra di dialogo Aggiungi file nelle impostazioni delle informazioni che mostra i formati supportati e il caricamento con trascinamento della selezione

Esempio: acquisire 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 una conoscenza condivisa del team.

Prerequisiti

Prima di usare lo strumento Carica documento conoscenze , assicurarsi di soddisfare i requisiti seguenti.

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 autonoma (le azioni di scrittura richiedono l'approvazione in modalità di revisione)

Limits

I limiti seguenti si applicano ai documenti di knowledge base caricati.

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 -
Numero massimo di file 5 per messaggio - 1 per azione
Estensioni supportate 31 28 2 (.md, .txt)
Caratteri nome file - Lettere, numeri, trattini, caratteri di sottolineatura, punti Uguali
Lunghezza massima del nome file - 1.024 caratteri Uguali

Quando usare qualcos'altro

La tabella seguente descrive gli scenari in cui un approccio diverso è più appropriato.

Scenario Approccio migliore
Connessione di contenuti wiki live che rimangono sincronizzati Conoscenza wiki di Azure DevOps
Caricamento di file binari (PDF, Word, immagini) Caricare tramite Generatore>Impostazioni delle informazioni>Aggiungi file
Importazione bulk di molti documenti contemporaneamente Usare il comando CLI srectl doc upload --file <path>
Mantenere aggiornati automaticamente i repository di codice Connettere un connettore GitHub o Azure DevOps

Inizia subito

risorsa Cosa imparerai
Caricare documenti di conoscenza Aggiungere runbook e documenti alle impostazioni delle informazioni dell'agente
Capability Elementi aggiunti
Conoscenza wiki di Azure DevOps Connetti contenuti live del wiki che si aggiornano automaticamente
Analisi della causa radice Analizzare i problemi, quindi acquisire i risultati