Connettori e strumenti MCP nell'agente SRE di Azure

Problema: l'agente non riesce a visualizzare la metà dello stack

L'agente ha accesso predefinito avanzato ai servizi di Azure: Application Insights, Log Analytics, Monitoraggio di Azure, Resource Graph. Ma la toolchain operativa non si ferma a Azure. Le metriche si trovano in Datadog. I log di sicurezza sono in tempo reale in Splunk. Il codice sorgente si trova in GitHub.

Durante un incidente, quel gap ti costringe a collegare manualmente i sistemi interrogando Datadog in una scheda, correlando con Monitoraggio di Azure in un'altra e copiando i risultati tra gli strumenti. L'agente vede solo il lato Azure.

Funzionamento dei connettori MCP

Il protocollo MCP ( Model Context Protocol ) è uno standard aperto per connettere gli agenti di intelligenza artificiale agli strumenti esterni. Un server MCP esegue il wrapping di qualsiasi servizio, ovvero un database, un'API, una piattaforma di monitoraggio, e ne espone le funzionalità come strumenti che l'agente può individuare e richiamare.

Quando connetti un server MCP al tuo agente:

1. Individuazione automatica : l'agente chiama l'elenco degli strumenti del server e sa immediatamente quali strumenti sono disponibili.
2. Registrazione con spazio dei nomi : ogni strumento viene registrato con un nome con prefisso (ad esempio, my-datadog_list_metrics) in modo che gli strumenti di server diversi non siano mai in conflitto.
3. Monitoraggio dell'integrità : l'agente esegue il ping di ogni server ogni 60 secondi, ripristina automaticamente da errori temporanei e mostra lo stato della connessione in tempo reale.
4. Aggiornamenti dinamici : quando un server aggiunge nuovi strumenti, l'agente li rileva automaticamente entro 5 minuti.

Due tipi di trasporto

MCP supporta due modi per connettere l'agente a strumenti esterni:

Streamable-HTTP (servizi remoti)

Connettersi a qualsiasi server MCP accessibile tramite un URL. Fornisci l'endpoint e le credenziali di autenticazione, ovvero un token Bearer o intestazioni personalizzate, oppure l'accesso tramite OAuth per i server che supportano OAuth conforme alle specifiche.

Stdio (processi locali)

Eseguire un server MCP come processo all'interno dell'ambiente cloud dell'agente. Specificare il comando, gli argomenti e le variabili di ambiente facoltative. L'agente gestisce il ciclo di vita del processo, avviandolo al momento della connessione, monitorandone lo stato di salute e riavviandolo al verificarsi di un errore.

Connettori partner

Il tuo agente include connettori per le piattaforme più popolari. Questi connettori hanno URL precompilato, impostazioni di autenticazione predefinite e icone personalizzate. Selezionare la scheda, immettere le credenziali e connettersi.

Per i connettori partner, il metodo di autenticazione viene impostato e bloccato. Inserisci i valori delle credenziali.

Come gli strumenti raggiungono gli agenti

Gli strumenti MCP possono raggiungere l'agente in due modi:

• Strumenti agente: selezionare gli strumenti durante la configurazione o la modifica del connettore. Questi strumenti sono disponibili direttamente nella conversazione principale. Non è necessario alcun agente personalizzato.

• Strumenti agente personalizzati: Assegnare strumenti ad agenti personalizzati specifici per specialisti focalizzati con competenze specialistiche nel dominio.

Strumenti dell'agente

Quando si crea o si modifica un connettore MCP, un passaggio di selezione dello strumento consente di scegliere quali strumenti sono visibili all'agente. Gli strumenti selezionati vengono aggiunti all'elenco degli strumenti dell'agente e rimangono sincronizzati. Quando si aggiungono, rimuovono o aggiornano i connettori, gli strumenti dell'agente vengono aggiornati automaticamente.

Durante la creazione del connettore: Dopo che il connettore si connette correttamente, viene visualizzato un passaggio Seleziona strumenti . Tutti gli strumenti individuati vengono pre-selezionati fino alla capacità rimanente. Selezionare Fine per salvare o Ignorare per aggiungere strumenti in un secondo momento.

Per i connettori esistenti: Modificare qualsiasi connettore MCP per trovare la sezione Strumenti MCP nella parte inferiore della finestra di dialogo. Selezionare o deselezionare gli strumenti per controllare quali può chiamare l'agente.

Strumenti per agenti personalizzati

Per gli specialisti specializzati, assegnare gli strumenti MCP a specifici agenti personalizzati tramite il portale o YAML.

Portale: In Builder > Agent Canvas modifica un agente → Strumenti Impostazioni avanzate > → Seleziona gli strumenti.

Caratteri jolly YAML:

mcp_tools:
  - datadog-mcp/*        # All tools from this connection
  - github_search_code   # One specific tool

Il {connection-id}/* modello aggiunge ogni strumento da tale server, inclusi gli strumenti aggiunti in un secondo momento. La barra è obbligatoria.

Per una procedura dettagliata completa, vedere Configurare gli strumenti MCP.

Selezione e capacità degli strumenti

Ogni agente - sia esso il tuo agente o un agente personalizzato - può usare fino a 80 strumenti (combinati in modalità nativa e MCP). L'interfaccia utente di selezione degli strumenti consente di gestire questo budget tra i connettori.

Indicatore della capacità

La selezione degli strumenti mostra una barra di avanzamento con il conteggio degli strumenti corrente.

Un suggerimento sotto la barra legge: "Massimo di 80 strumenti consentiti per evitare una riduzione delle prestazioni dell'agente".

Comportamento al raggiungimento della capacità

Quando gli strumenti selezionati raggiungono il limite di 80 strumenti:

• Gli strumenti deselezionati diventano disabilitati : non è possibile aggiungere altro fino a quando non si rimuovono alcuni
• Gli strumenti già controllati rimangono abilitati: è sempre possibile deselezionarli per liberare capacità
• Selezionare tutti i limiti di capacità rimanente: se si dispone di spazio per altri 10 strumenti e selezionare Seleziona tutto, vengono selezionati solo 10

Il numero di strumenti si estende su tutti i connettori. Se il connettore A ha 60 strumenti visibili all'agente, il connettore B può aggiungere fino a 20 altri.

Monitoraggio dell'integrità della connessione

L'agente monitora continuamente ogni connessione MCP:

L'agente esegue il ping di ogni server ogni 60 secondi. Gli errori temporanei vengono recuperati automaticamente all'heartbeat riuscito successivo. Prima di richiamare qualsiasi strumento MCP, l'agente convalida la connessione e tenta di riconnettersi, se necessario.

Riconnessione automatica

L'agente esegue automaticamente il ripristino da errori di connessione MCP usando due meccanismi:

• Prima di ogni chiamata allo strumento, l'agente controlla lo stato della connessione. Se la connessione è disconnessa, si riconnette in modo trasparente prima di eseguire lo strumento, senza attendere il ciclo di heartbeat successivo.

• Ogni 60 secondi, l'agente esegue il ping di ogni server MCP Streamable-HTTP. Se un server disconnesso risponde al ping, la connessione viene ripristinata. Questo meccanismo rileva gli errori che si verificano tra le chiamate degli strumenti. Le connessioni Stdio vengono ripristinate nella chiamata successiva dello strumento anziché tramite ping heartbeat.

Quando una connessione si riconnette:

• L'agente stabilisce una nuova sessione con il server MCP.
• L'agente individua nuovamente tutti gli strumenti disponibili dal server.
• L'agente aggiorna i riferimenti allo strumento in modo che ogni chiamata successiva usi la connessione dinamica.
• Le assegnazioni di strumenti esistenti (strumenti agente e strumenti agente personalizzati) rimangono intatte.

Autenticazione

Ogni server MCP ha requisiti di autenticazione specifici. Il portale supporta i metodi seguenti:

Per i connettori partner, imposta il metodo di autenticazione e inserisci le credenziali.

Cosa rende questo diverso

• A differenza delle integrazioni personalizzate, i connettori MCP usano uno standard aperto. Non scrivi codice adattatore perché il protocollo gestisce la scoperta, l'invocazione e la gestione degli errori.

• A differenza delle configurazioni degli strumenti statici, l'agente individua gli strumenti in modo dinamico. Quando un server MCP aggiunge un nuovo strumento, l'agente lo preleva automaticamente. I modelli con caratteri jolly (datadog-mcp/*) assicurano che i nuovi strumenti siano disponibili senza riconfigurazione.

• A differenza degli script e dei runbook, le connessioni MCP si autoriparano. L'agente monitora ogni connessione con un heartbeat di 60 secondi, recupera automaticamente dagli errori temporanei e rinvia il caricamento dell'agente personalizzato finché le connessioni non vengono ristabilite.

Prima e dopo

Funzionalità correlate