Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure agente SRE è più efficace quando può usare lo stesso contesto usato dal team per risolvere i problemi dei sistemi. Collega runbook, documentazione, pagine web e repository in modo che l'agente possa fare riferimento a queste risorse durante le indagini anziché iniziare da zero.
Suggerimento
- Usare la Knowledge Base di Builder > per gestire file, pagine Web e repository in un'unica posizione.
- Le informazioni indicizzate sono automaticamente disponibili durante le indagini e le chat.
- È possibile caricare i documenti direttamente, allegare file in chat o connettere i repository per l'analisi compatibile con l'origine.
- Le fonti di conoscenza più utili sono quelle da cui il tuo team dipende già, come i runbook, le note di architettura, le guide alla risoluzione dei problemi e il codice sorgente.
Perché le conoscenze sono importanti
L'agente ha già un contesto Azure predefinito tramite strumenti di osservabilità e sistemi connessi. Ciò che non ha per impostazione predefinita sono le conoscenze interne del tuo team. Tali conoscenze includono il runbook che spiega una procedura di ripristino comune, la nota architetturale che identifica una dipendenza condivisa o il repository che rivela quale deploy abbia introdotto una regressione.
Quando colleghi questa knowledge base, il tuo agente può:
- Runbook del team di riferimento durante un incidente.
- Riutilizza le procedure di risoluzione dei problemi che il team ha già documentato.
- Correlare i sintomi con il codice sorgente e il contesto di distribuzione.
- Rispondere alle domande usando gli stessi documenti e i riferimenti usati dagli esseri umani.
Gestire le informazioni nella Knowledge Base
Usare la Knowledge Base di Builder > per gestire le origini delle informazioni dell'agente.
La pagina mostra ogni origine con i relativi:
- Nome
- Stato
- Type
- Data ultima modifica
Sono disponibili tre tipi di origine:
| Tipo di sorgente | Elementi forniti | Come aggiungerlo |
|---|---|---|
| File | Runbook, guide alla risoluzione dei problemi, documenti di architettura e materiale di riferimento | Caricare tramite il portale o chiedere all'agente di salvare un documento durante la chat |
| Pagine Web | Documentazione esterna, URL wiki interni e pagine di stato | Aggiungere l'URL della pagina in modo che l'agente possa indicizzare il contenuto |
| Repository | Codice sorgente, file di distribuzione e definizioni dell'infrastruttura | Collegare repository di GitHub o di Azure DevOps |
Controllare lo stato e la freschezza dell'indicizzazione
Ogni origine della knowledge base mostra uno degli stati seguenti:
| Condizione | Meaning |
|---|---|
| Indicizzato | Il contenuto viene elaborato e ricercabile |
| In sospeso | Il contenuto è ancora in fase di elaborazione |
| Non indicizzato | Elaborazione non riuscita o non è stato possibile indicizzare l'origine |
Quando un'origine dati viene indicizzata, posizionare il puntatore sull'indicatore di stato per visualizzare la data e l'ora Creato il. Questo timestamp è utile quando si desidera confermare l'elaborazione della versione più recente di un runbook o di un documento.
Carica documenti
Caricare documenti quando si desidera che le informazioni rimangano disponibili nelle conversazioni future.
Gli esempi tipici includono:
- Runbook degli eventi imprevisti
- Guide per l'escalation
- Riferimenti all'architettura
- Elenchi di controllo per la risoluzione dei problemi
È possibile caricare file tramite il portale oppure chiedere all'agente di salvare il contenuto da una conversazione nella Knowledge Base.
Per i formati e i limiti di file supportati, vedere Caricare documenti di knowledge base.
Per il flusso di lavoro completo, vedi Caricare documenti della base di conoscenza.
Condividere file nella chat
Usare gli allegati di chat quando si vuole assegnare all'agente un contesto immediato in una singola conversazione. Questo approccio è utile per screenshot, log, file di configurazione e altri materiali utili per la risoluzione dei problemi attivi.
Suggerimento
Se un file allegato nella chat dovrebbe diventare una conoscenza a lungo termine, chiedere all'agente di salvarlo nelle impostazioni della Knowledge Base. L'agente può caricare una copia in modo che il contenuto venga indicizzato e ricercabile nelle conversazioni successive.
La tabella seguente confronta i caricamenti delle conoscenze a lungo termine con gli allegati temporanei delle chat:
| Scenario | Caricare nella Knowledge Base | Condividi in chat |
|---|---|---|
| Ideale per | Runbook, procedure e documenti che vuoi avere disponibili per le conversazioni future | File che si vuole che l'agente analizzi subito |
| Ambito di archiviazione | A livello di agente e ricercabile nelle conversazioni future | A livello di thread e disponibile nella conversazione corrente |
| Come aggiungere | Caricare nel portale o chiedere all'agente di salvare il contenuto | Trascina e rilascia, incolla dagli appunti o usa + nella chat |
| Può diventare una conoscenza a lungo termine | Conoscenza già consolidata | Sì, se si chiede all'agente di salvarlo |
Per altre informazioni, vedere Condividere file nella chat.
Aggiungere pagine Web
Aggiungere pagine Web quando indicazioni importanti si trovano all'esterno di file o repository caricati.
Ecco alcuni candidati appropriati:
- Articoli interni del wiki
- Documentazione del prodotto pubblico
- Pagine di stato del servizio
- Pagine di riferimento gestite dal team
Dopo aver aggiunto un URL, l'agente indicizza il contenuto della pagina in modo che possa fare riferimento a tali informazioni durante le indagini future.
Collegare repository
Connetti i repository GitHub o Azure DevOps quando l'agente ha bisogno di un contesto basato sul codice sorgente.
I repository connessi consentono all'agente di:
- Cercare modelli di errore nel codice sorgente
- Correlare gli eventi imprevisti con le modifiche recenti al codice
- File di distribuzione e configurazione di riferimento
- Usare il contenuto del repository durante l'analisi della causa radice
Per connettere il codice sorgente, vedere Connettere il codice sorgente.
Scegliere l'origine delle informazioni appropriata
Usare il tipo di origine che corrisponde al tipo di contesto necessario:
| Se è necessario connettersi... | Usare... |
|---|---|
| Un runbook o una guida alla risoluzione dei problemi archiviata come file | Caricare documenti di conoscenza |
| Screenshot, log o file per un'indagine attiva | Condividere file nella chat |
| Un repository di GitHub o di Azure DevOps | Connettere il codice sorgente |
| Sistemi esterni come Datadog o Splunk | Connettori MCP |