Condividi tramite

Usare gli agenti di Foundry Classic e gli strumenti del server MCP in Visual Studio Code (anteprima della versione classica)

Annotazioni

Questo documento fa riferimento al portale di Microsoft Foundry (versione classica).

🔍Per informazioni sul nuovo portale, vedere la documentazione di Microsoft Foundry (nuova).

In questo articolo si aggiungono e si usano gli strumenti server MCP (Model Context Protocol) con gli agenti nel servizio Foundry Agent. Usare l'estensione Microsoft Foundry per Visual Studio Code per configurare e testare gli agenti che chiamano gli strumenti MCP.

Annotazioni

Questo articolo fa riferimento alla versione classica dell'API degli agenti.

Dopo aver compilato un agente nel servizio Agent usando l'estensione Visual Studio Code (VS Code), è possibile aggiungere strumenti MCP all'agente. L'aggiunta di un server MCP consente all'agente di:

  • Accedi alle informazioni aggiornate dalle API e dai servizi.
  • Recuperare il contesto pertinente per migliorare la qualità delle risposte dai modelli di intelligenza artificiale.

Importante

Gli elementi contrassegnati (anteprima) in questo articolo sono attualmente disponibili in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Prerequisiti

Creare un agente nella finestra di progettazione

Per creare un agente, seguire la procedura descritta in Creare un agente nella finestra di progettazione.

Aggiungere uno strumento server MCP all'agente

Dopo aver creato l'agente, è possibile aggiungervi strumenti, inclusi gli strumenti MCP. Per altre informazioni sugli strumenti disponibili, vedere Strumenti per gli agenti.

È possibile portare più server MCP remoti aggiungendoli come strumenti. Per ogni strumento, è necessario specificare un valore univoco di Etichetta server all'interno dello stesso agente e un valore URL server che punta al server MCP remoto.

Avviso

I server MCP remoti usati con lo strumento MCP in questo articolo non sono microsoft. Microsoft non testa o verifica questi server. Per informazioni dettagliate, vedere Considerazioni sull'uso di servizi e server non Microsoft.

Per aggiungere uno strumento server MCP all'agente, seguire questa procedura:

  1. Nella finestra di progettazione, nell'angolo superiore destro della sezione TOOL , selezionare il pulsante Aggiungi strumento . Nell'elenco a discesa selezionare lo strumento Server MCP .

  2. Trovare il server MCP remoto a cui connettersi, ad esempio il server MCP GitHub. Creare o aggiornare un agente Foundry con uno strumento MCP usando le informazioni seguenti:

    1. URL del server: URL del server MCP; ad esempio . https://gitmcp.io/Azure/azure-rest-api-specs

    2. Etichetta server: identificatore univoco del server MCP per l'agente; ad esempio . fetch_rest_api_docs

  3. Nell'elenco a discesa Strumenti consentiti scegliere gli strumenti che il server MCP può usare.

  4. Dopo aver immesso le informazioni necessarie, selezionare il pulsante Crea strumento . Lo strumento MCP viene visualizzato nella sezione TOOL della finestra di progettazione dell'agente.

Distribuire l'agente in Foundry

Dopo aver aggiunto uno strumento MCP, distribuire l'agente in Foundry in modo che sia disponibile per il test e l'uso.

  1. Nella finestra di progettazione selezionare il pulsante Crea agente in Microsoft Foundry .

  2. In VS Code aggiornare la visualizzazione Risorse . L'agente distribuito viene visualizzato nella sottosezione Agenti classici .

Visualizzare i dettagli dell'agente distribuito

Dopo aver distribuito un agente, è possibile esaminarne la configurazione e interagire con esso. Selezionare l'agente distribuito nella visualizzazione Risorse per aprire il riquadro PREFERENZE AGENTE in modalità di sola visualizzazione. È possibile:

  • Selezionare il pulsante Modifica agente per visualizzare la finestra di progettazione dell'agente e la definizione yaml dell'agente per la modifica.
  • Selezionare il pulsante Visualizza codice per creare un file di codice di esempio che usa l'agente.
  • Selezionare il pulsante Apri playground per aprire il playground dell'agente.

Modificare un agente distribuito

Per modificare la configurazione dell'agente dopo la distribuzione, seguire questa procedura:

  1. Nel riquadro PREFERENZE AGENTE selezionare il pulsante Modifica agente . Si apre la finestra di progettazione dell'agente con il file con estensione yaml dell'agente.

  2. Modificare la configurazione dell'agente, ad esempio il modello, gli strumenti e le istruzioni.

  3. Al termine della modifica, selezionare il pulsante Update Agent on Microsoft Foundry (Aggiorna agente in Microsoft Foundry ) per salvare le modifiche. La configurazione aggiornata viene distribuita in Foundry.

Testare l'agente con gli strumenti MCP nell'ambiente di prova

Usa il playground dell'agente per verificare che gli strumenti del server MCP funzionino correttamente con l'agente implementato.

  1. Fare clic con il pulsante destro del mouse sull'agente distribuito con uno strumento server MCP e quindi selezionare l'opzione Apri playground. Questa azione avvia un thread con l'agente in modo da poter inviare messaggi.

  2. Nel riquadro Remote Agent Playground, immettere un prompt come Dammi un esempio per creare un'app contenitore e invialo.

  3. Selezionare il metodo di autenticazione per lo strumento server MCP e procedere. I metodi di autenticazione variano a seconda del server MCP. Le opzioni comuni includono chiave API, OAuth o nessuna autenticazione per i server pubblici.

  4. Selezionare la preferenza di approvazione per lo strumento server MCP e procedere. È possibile scegliere Chiedi ogni volta di esaminare ogni chiamata allo strumento o Consentire sempre di consentire all'agente di richiamare automaticamente gli strumenti MCP.

  5. Se hai scelto Chiedi ogni volta come preferenza, devi approvare o rifiutare ogni richiesta dello strumento prima che l'agente proceda.

  6. L'agente usa il modello e gli strumenti server MCP configurati per recuperare le informazioni. Al termine dell'elaborazione dell'agente, la risposta viene visualizzata nel playground. L'origine delle informazioni viene visualizzata nella sezione per le annotazioni dell'agente.

Risolvere i problemi relativi alle connessioni server MCP

Se si verificano problemi quando si usano gli strumenti server MCP con l'agente, provare le soluzioni seguenti.

Problema Risoluzione
L'URL del server MCP non è raggiungibile Verificare che l'URL sia corretto e che il server sia in esecuzione. Controllare la connessione di rete e le regole del firewall che potrebbero bloccare le richieste in uscita da VS Code.
Errori di autenticazione Verificare di aver selezionato il metodo di autenticazione corretto per il server MCP. Se il server richiede una chiave API o un token OAuth, verificare che le credenziali siano valide e non scadute.
Gli strumenti non vengono visualizzati nell'elenco degli strumenti consentiti Aggiornare l'elenco degli strumenti chiudendo e riaprendo la finestra di dialogo dello strumento MCP. Verificare che il server MCP esponga correttamente i relativi strumenti tramite il protocollo MCP standard.
Agent restituisce errori durante la chiamata di uno strumento MCP Controllare le annotazioni dell'agente nel playground per informazioni dettagliate sull'errore. Il server MCP potrebbe restituire una risposta di errore. Verificare che il server sia integro e che i parametri di chiamata dello strumento siano corretti.

Pulire le risorse

Le risorse di Azure che hai creato in questo articolo vengono addebitate sul tuo abbonamento Azure. Se non si prevede che queste risorse siano necessarie in futuro, eliminarle per evitare di incorrere in costi aggiuntivi.

Eliminare gli agenti

Per rimuovere gli agenti che non sono più necessari:

  1. In VS Code aggiornare la visualizzazione Risorse . Espandere la sottosezione Agenti classici per visualizzare l'elenco degli agenti distribuiti.

  2. Fare clic con il pulsante destro del mouse sull'agente distribuito che si vuole eliminare e quindi scegliere Elimina.

Eliminare i tuoi modelli

Per rimuovere i modelli distribuiti che non sono più necessari:

  1. In VS Code aggiornare la visualizzazione Risorse . Espandere la sottosezione Modelli per visualizzare l'elenco dei modelli distribuiti.

  2. Fare clic con il pulsante destro del mouse sul modello distribuito da eliminare e quindi scegliere Elimina.

Eliminare gli strumenti connessi

Per rimuovere le risorse degli strumenti connessi che non sono più necessarie, eliminarle singolarmente nel portale di Azure:

  1. Apri il portale di Azure.

  2. Passare al gruppo di risorse che contiene il progetto Foundry.

  3. Trovare la risorsa dello strumento specifica che si vuole eliminare e selezionarla.

  4. Selezionare il pulsante Elimina e confermare l'eliminazione.

Avviso

Non eliminare l'intero gruppo di risorse, a meno che non si voglia rimuovere tutte le risorse al suo interno. L'eliminazione di un gruppo di risorse rimuove tutte le risorse contenute, incluso il progetto Foundry e i modelli distribuiti.

Contenuti correlati

  • Last updated on