Connettori nell'agente SRE di Azure

L'agente include l'accesso predefinito ai servizi di Azure. Può eseguire query su Monitoraggio di Azure, Application Insights, Log Analytics e Azure Resource Graph. I connettori estendono tale portata ai sistemi esterni: i cluster Kusto, i repository di codice sorgente, gli strumenti di collaborazione e le API personalizzate.

Operazioni che l'agente può eseguire senza connettori

Anche senza aver configurato connettori, l'agente dispone di funzionalità integrate tramite la propria identità gestita e le autorizzazioni del controllo degli accessi in base al ruolo di Azure (Azure RBAC):

Resource Graph e le operazioni di Resource Manager funzionano con qualsiasi tipo di risorsa Azure, tra cui Servizio app di Azure, App contenitore di Azure, macchine virtuali, rete e archiviazione. Se i log e le metriche risiedono in Monitoraggio di Azure e Application Insights, l'agente può iniziare immediatamente a analizzare i problemi, senza che sia necessaria alcuna configurazione del connettore. I connettori diventano utili quando è necessario che l'agente raggiunga i sistemi outside Azure.

Cosa forniscono i connettori

I connettori rientrano in quattro categorie in base a ciò che forniscono all'agente: origini dati, codice sorgente e conoscenze, strumenti di collaborazione e connettori personalizzati.

Origini dati

Queste fonti possono essere log di query, metriche e dati di telemetria dai tuoi archivi dati.

Codice sorgente e conoscenza

Fornire al proprio agente il contesto dei sistemi, ovvero codice, wiki e documentazione.

Con questi connettori, l'agente può cercare i modelli di errore nel codice e leggere la documentazione wiki. L'agente può anche fare riferimento alla documentazione dell'API durante la risoluzione dei problemi e connettere gli eventi imprevisti alle richieste pull correlate.

Strumenti di collaborazione

Consentire all'agente di comunicare i risultati tramite i canali già usati dal team.

Connettori personalizzati (server MCP)

Con i server MCP (Model Context Protocol) è possibile connettere l'agente a qualsiasi sistema, tra cui piattaforme di osservabilità, repository del codice sorgente, sistemi di creazione di ticket e API personalizzate. L'agente rileva automaticamente gli strumenti sui server connessi, monitora lo stato delle connessioni con heartbeat ogni 60 secondi e si ripristina automaticamente dopo errori transitori.

Due tipi di trasporto coprono ogni modello di distribuzione: Streamable-HTTP per i servizi cloud remoti e stdio per i processi locali in esecuzione insieme all'agente. I connettori partner preconfigurati per risorse come GitHub, Datadog, Splunk e New Relic forniscono la configurazione con un clic.

Per una guida completa all'architettura MCP, ai tipi di trasporto, ai connettori partner, al monitoraggio dell'integrità e alla gestione degli strumenti, vedere Connettori e strumenti MCP.

Per configurare il primo connettore MCP, vedere Configurare il connettore MCP.

Esplorare e gestire i connettori

Per visualizzare i connettori organizzati in gruppi di categorie comprimibili, vai a Builder>Connettori. In questa pagina tutti i gruppi vengono espansi per impostazione predefinita.

Ogni intestazione di categoria mostra il numero di connettori in tale gruppo. Quando si comprime una categoria, viene visualizzata una notifica rossa se un connettore in tale gruppo presenta un problema di connessione. È possibile individuare i problemi a colpo d'occhio senza espandere ogni sezione.

Usare i controlli della barra degli strumenti per gestire la visualizzazione:

• Espandi tutto/Comprimi tutto per attivare o disattivare tutti i gruppi di categorie contemporaneamente.
• Filtro categoria per visualizzare solo i connettori in una categoria specifica.
• Cercare i connettori in base al nome (passa a un elenco semplice per la ricerca di parole chiave).

Vengono visualizzate solo le categorie che contengono almeno un connettore. Quando si cerca un connettore in base al nome, la pagina passa a una visualizzazione elenco flat per un filtro più rapido.

Chi può configurare i connettori

Per gestire un connettore, è necessario disporre del permesso di scrittura sull'agente. La tabella seguente illustra il ruolo con questa autorizzazione:

Durante l'installazione, alcuni connettori richiedono il consenso OAuth da un utente che dispone delle autorizzazioni appropriate nel sistema esterno( ad esempio, un membro dell'organizzazione GitHub per i connettori GitHub). Questo consenso riguarda le autorizzazioni nel servizio esterno , non i ruoli dell'agente SRE.

Per i connettori che usano l'identità gestita dell'agente (ad esempio Esplora dati di Azure), un amministratore del sistema esterno deve elencare l'identità come consentita.

Quando si configurano i connettori, tutti gli utenti dell'agente ne traggono vantaggio automaticamente. Si limitano a fare domande all'agente e l'agente usa i connettori disponibili in secondo piano.

Connettori e agenti personalizzati

È possibile assegnare strumenti MCP specifici a agenti personalizzati specializzati. Un agente personalizzato per la risoluzione dei problemi del database potrebbe ottenere gli strumenti Kusto, mentre un agente personalizzato di distribuzione ottiene l'accesso a GitHub. Questo approccio mantiene incentrato ogni agente personalizzato e impedisce di sovraccaricarlo con troppi strumenti.

Assegna gli strumenti singolarmente nel selettore strumenti del portale o usa i modelli wildcard (connection-id/*) in YAML per aggiungere tutti gli strumenti da un server in una sola volta. Per informazioni dettagliate sull'assegnazione degli strumenti e sulla sintassi con caratteri jolly, vedere Connettori e strumenti MCP.

Nel portale, vai a Builder>Generatore di agenti personalizzati. Creare o modificare un agente personalizzato e in Impostazioni avanzate selezionare Scegli strumenti. Lo strumento di selezione visualizza gli strumenti raggruppati per connessione MCP. Selezionare gli strumenti necessari per l'agente personalizzato.

In YAML elencare ogni strumento in base al nome completo:

mcp_tools:
  - azure-data-explorer_kusto_query
  - azure-data-explorer_kusto_table_list
  - azure-data-explorer_kusto_table_schema

Aggiungere tutti gli strumenti da un server MCP (wildcard)

Quando un server MCP espone molti strumenti e l'agente personalizzato richiede tutti questi strumenti, usare il modello wildcard anziché elencare singolarmente ogni strumento.

mcp_tools:
  - azure-data-explorer/*

Il {connection-id}/* modello aggiunge ogni strumento dalla connessione MCP. L'agente espande il carattere jolly all'avvio. Ad esempio, azure-data-explorer/* corrisponde a tutti gli strumenti registrati in una connessione chiamata azure-data-explorer (predefinito per il connettore Azure MCP con Kusto a partire dalla versione 26.4.16.0). Sostituire il nome assegnato al connettore.

È possibile combinare caratteri jolly con singoli nomi di strumenti:

mcp_tools:
  - azure-data-explorer/*  # All tools from the Kusto connection
  - grafana-mcp_dashboard  # One specific tool from Grafana

La tabella seguente confronta la selezione dei singoli strumenti e l'approccio generico.

Perché usare il carattere jolly? Quando un server MCP aggiunge nuovi strumenti, la wildcard li rileva automaticamente, senza dover riconfigurare il tuo agente personalizzato. La selezione di singoli strumenti ti offre un controllo preciso. Il wildcard offre una protezione automatica.

Quando gli strumenti MCP non sono ancora pronti

Se un server MCP non è pronto all'avvio dell'agente, l'agente non può accedere a strumenti da tale server. L'agente gestisce questa condizione normalmente. Rinvia gli agenti personalizzati con caratteri jolly non risolti o strumenti mancanti e li carica automaticamente dopo che l'agente stabilisce la connessione MCP. Non è necessario eseguire alcuna azione manuale.

Per altre informazioni, vedere Agenti personalizzati.

Passo successivo

Contenuti correlati