Condividi tramite

Connettere le informazioni nell'agente SRE di Azure

L'agente è dotato di osservabilità predefinita di Azure, ma ogni team ha un contesto univoco: runbook, documentazione dell'architettura, wiki interni e repository di codice. Usando la Knowledge Base, è possibile gestire tutte queste origini di informazioni in un'unica posizione in modo che l'agente possa farvi riferimento durante le indagini.

Suggerimento

Punti chiave

  • Builder > Knowledge Base è la posizione centrale per gestire tutte le origini della conoscenza, inclusi file, pagine Web e repository.
  • Caricare runbook e documenti, aggiungere pagine Web in base all'URL o connettere repository di codice sorgente.
  • L'agente fa riferimento automaticamente alle informazioni indicizzate durante le indagini.
  • Più conoscenza rilevante ha il tuo agente, più veloci e accurate saranno le sue risposte.

Perché le conoscenze sono importanti

Il tuo agente è potente fin da subito grazie all'osservabilità di Azure e agli strumenti connessi. Tuttavia, ogni team ha un contesto univoco: runbook, documentazione dell'architettura, wiki interni e repository di codice che contengono le conoscenze istituzionali necessarie per risolvere rapidamente gli eventi imprevisti.

Quando l'agente ha accesso a queste informazioni, può:

  • Fare riferimento ai runbook del team durante gli eventi imprevisti anziché iniziare da zero.
  • Correlare i problemi di produzione a modifiche di codice specifiche nei repository.
  • Applicare i passaggi per la risoluzione dei problemi già documentati dal team.

Base di Conoscenza

Usare la pagina Knowledge Base nel portale (Knowledge Base>) per gestire le informazioni dell'agente. È possibile caricare file, aggiungere pagine Web e visualizzare i repository connessi.

Nella tabella seguente vengono descritti i tre tipi di origini delle conoscenze.

Tipo di sorgente Elementi forniti Come aggiungere
File Runbook, guide alla risoluzione dei problemi, documentazione dell'architettura, riferimenti alla configurazione Caricare tramite il portale, trascinare e rilasciare o consentire all'agente di crearli durante le conversazioni
Pagine Web Documentazione esterna, pagine di stato, URL wiki interni Aggiungi tramite URL. L'agente indicizza il contenuto dell'URL specificato.
Repository Codice sorgente per l'analisi della causa radice, le configurazioni di distribuzione, l'infrastruttura come codice Connettere GitHub o Azure DevOps repository

Ogni voce mostra il nome, lo stato di indicizzazione (indicizzato, in sospeso o non indicizzato), il tipo e la data dell'ultima modifica .

Carica documenti

L'agente può creare e caricare informazioni durante le conversazioni. Chiedere di salvare un runbook da quanto è stato risolto e il documento viene archiviato automaticamente. È anche possibile caricare file direttamente tramite il portale.

Per i formati di file supportati e i limiti delle dimensioni, vedere Caricare i documenti delle informazioni: Formati di file supportati. Per informazioni dettagliate sui tipi di file, i limiti e i documenti generati dall'agente, vedere Caricare documenti di knowledge base.

Condividere file nella chat

È possibile allegare file direttamente in un thread di chat usando il trascinamento della selezione, l'operazione incolla dagli Appunti o il pulsante +. Il thread archivia gli allegati di chat e fornisce all'agente un contesto immediato per l'analisi.

Suggerimento

Vuoi mantenere un file in modo permanente?

Dopo aver allegato un file in chat, chiedere all'agente: "Salva questo in impostazioni di knowledge base". L'agente legge il file dal thread e carica una copia nella Knowledge Base, rendendolo indicizzato e ricercabile in tutte le conversazioni future. Anche il file originale rimane nel thread.

La tabella seguente confronta il caricamento di documenti di knowledge base e la condivisione di file nella chat.

Caricamento della conoscenza Condividere file nella chat
Where Generatore > Knowledge base o chiedere nella chat Input del messaggio chat (+, trascinamento selezione, incolla)
Spazio di archiviazione Livello agente: indicizzato, ricercabile in tutti i thread Livello di discussione: disponibile in quella conversazione
Ideale per Runbook, documentazione sull'architettura, procedure a cui l'agente deve fare riferimento in tutte le future conversazioni Screenshot, log, file di configurazione da analizzare immediatamente
Promuovere le conoscenze Già lì Chiedere all'agente: "Salvare nelle impostazioni delle informazioni" che copia il contenuto nell'archiviazione a livello di agente
Formati 28 tipi, tra cui documenti, dati, immagini 31 tipi che includono codice, script, infrastruttura, Web
Limiti di dimensioni 16 MB per file, 100 MB per caricamento 10 MB per file, 50 MB totale, 5 file

Connettere il codice sorgente

Connettere GitHub o Azure DevOps repository in modo che l'agente possa cercare codice, correlare gli errori con le modifiche recenti e fare riferimento alle configurazioni di distribuzione durante le indagini.

Aggiungi repository

In Generatore>Knowledge Base selezionare Aggiungi repository per aprire una procedura guidata che illustra tre passaggi:

Passo Cosa fai
1. Scegliere una piattaforma Selezionare GitHub o Azure DevOps. Per Azure DevOps immettere il nome dell'organizzazione.
2. Autenticare Accedere con OAuth o immettere un token di accesso personale (PAT). Azure DevOps supporta anche l'identità gestita.
3. Aggiungere repository Esplorare i repository disponibili dall'elenco a discesa o immettere manualmente gli URL. Aggiungere un nome di visualizzazione e una descrizione facoltativa per ogni voce. Per Azure DevOps, selezionare prima un progetto per filtrare l'elenco dei repository.

È possibile aggiungere più repository in una singola sessione. Selezionare questa opzione + per aggiungere righe, quindi selezionare Salva al termine.

Dopo il salvataggio, i repository vengono visualizzati nell'elenco della Knowledge Base con stato di indicizzazione. Dopo l'indicizzazione, l'agente può fare riferimento al codice nelle conversazioni.

Piattaforme e autenticazione supportate

Piattaforma Metodi di autenticazione Elementi necessari
GitHub OAuth, token di accesso personale Account GitHub con accesso al repository. Per PAT, creare un token con ambito repo.
Azure DevOps OAuth, token di accesso personale, identità gestita Azure DevOps accesso all'organizzazione. Per l'identità gestita, assegnare un'identità gestita assegnata dall'utente alla risorsa agente.

Passo successivo

Esercitazione: Caricare documenti informativi

Contenuti correlati

  • Last updated on