Condividi tramite

Estendi il tuo agente con Model Context Protocol

Un altro modo per estendere l'agente con gli strumenti consiste nell'usare il protocollo MCP (Model Context Protocol).

Che cos'è Model Context Protocol?

Il protocollo MCP (Model Context Protocol) consente agli utenti di connettersi ai server di conoscenza e alle origini di dati esistenti direttamente all'interno di Copilot Studio. La connessione a un server MCP consente di accedere a:

  • Risorse: dati simili a file che possono essere letti dalle applicazioni client (ad esempio risposte API o contenuto di file)
  • Strumenti: funzioni che un modello linguistico può chiamare
  • Sollecitazioni: modelli di richieste predefinite per eseguire attività specifiche

Nota

Copilot Studio attualmente supporta solo gli strumenti.

Come funziona MCP?

Ogni strumento pubblicato dal server MCP viene aggiunto automaticamente come strumento in Copilot Studio. Nome, descrizione, input e output vengono ereditati dal server. Man mano che gli strumenti vengono aggiornati o rimossi sul server MCP, Copilot Studio riflette dinamicamente queste modifiche, assicurando che gli utenti dispongano sempre delle versioni più recenti e che gli strumenti obsoleti vengano rimossi. Un singolo server MCP può integrare e gestire più strumenti, ognuno accessibile come strumento all'interno di Copilot Studio.

Quando ci si connette a un prodotto non Microsoft, incluso un server MCP esterno, si è responsabili degli strumenti e dei dati a cui si accede da Copilot Studio.

Nota

L'orchestrazione generativa deve essere abilitata per l'uso di MCP.

Qual è il processo per estendere un agente usando MCP in Copilot Studio?

Per l'integrazione di MCP in Copilot Studio:

  1. Crea un server MCP.
  2. Creare un connettore MCP personalizzato basato sul modello di schema YAML fornito di seguito.
  3. Utilizza tramite Copilot Studio aggiungendo strumenti da un connettore MCP esistente a un agente.
  4. (Facoltativo) Pubblicare il connettore MCP per consentire l'uso del connettore tra tenant.

Crea un server MCP

È possibile usare GLI SDK (Software Development Kit) MCP per configurare un server MCP in uno dei linguaggi supportati.

Creare un connettore MCP personalizzato

Trasmissioni supportate

In MCP, le trasmissioni sono la base per la comunicazione client-server. Le trasmissioni gestiscono i meccanismi di invio e ricezione dei messaggi. Attualmente, Copilot Studio supporta i tipi di trasporto seguenti:

  • Streamable - Consigliato (disponibile a livello generale)
  • eventi Server-Sent (SSE) (anteprima pubblica)

Nota

Dato che il trasporto SSE è in via di deprecazione, il supporto del trasporto SSE in MCS rimane in anteprima pubblica. Copilot Studio non supporterà più SSE per MCP a partire da agosto 2025.

Configurare un connettore personalizzato

Una volta configurato il server MCP, è necessario configurare un connettore personalizzato (tramite Power Apps o Power Automate) per il server MCP. Per eseguire questa procedura, è necessario un file di schema per il server MCP. Il file dello schema è un file YAML per la specifica OpenAPI che descrive l'API del server MCP.

Per indicazioni sull'aspetto del file di specifica, vedere alcuni degli esempi di schema del server MCP forniti.

  1. Nel riquadro di spostamento sinistro, seleziona Agenti.

  2. Seleziona il tuo agente dall'elenco degli agenti.

  3. Vai alla pagina Strumenti per il tuo agente.

  4. Selezionare Aggiungi uno strumento.

  5. Selezionare Nuovo strumento.

  6. Selezionare Connettore personalizzato. Viene reindirizzato a Power Apps per creare un nuovo connettore personalizzato.

  7. Seleziona Nuovo connettore personalizzato.

  8. Seleziona Importa file OpenAPI.

  9. Accedi al file dello schema e selezionare Importa per importare il file.

  10. Selezionare Continua per completare la configurazione in Power Apps. Ulteriori informazioni sul processo di configurazione sono disponibili nella documentazione di Power Apps in Importare la definizione OpenAPI.

Esempi di schema del server MCP

Ecco due file di schema OpenAPI di esempio per i server MCP che usano dati fittizi, in formato YAML. Gli esempi illustrano ognuno dei trasporti supportati. È necessario immettere i dettagli per il proprio server MCP.

Di seguito è riportato un esempio di YAML per Streamable (scelta consigliata):

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Di seguito è riportato un esempio di YAML per SSE:


swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for SSE MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp/sse:
    get:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-sse-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

Connettori Microsoft MCP disponibili in Copilot Studio

Microsoft offre diversi connettori MCP predefiniti per connettersi ai servizi Microsoft in Copilot Studio. Di seguito sono riportati i connettori Microsoft MCP disponibili in Copilot Studio:

  • Dataverse
  • Dynamics 365
    • Vendite
    • Dati finanziari
    • Catena di approvvigionamento
    • Servizio
  • Tessuto

Aggiungere strumenti da un connettore MCP esistente a un agente

È possibile connettersi ai server MCP esistenti direttamente dall'interno di Copilot Studio. Il processo di aggiunta di strumenti è lo stesso, sia per i connettori McP Microsoft predefiniti che per i connettori MCP creati manualmente.

Per aggiungere un connettore MCP esistente a un agente, seguire questa procedura:

  1. Nel riquadro di spostamento sinistro, seleziona Agenti.

  2. Seleziona l'agente dall'elenco.

  3. Vai alla pagina Strumenti per il tuo agente.

  4. Selezionare Aggiungi uno strumento.

  5. Selezionare Model Context Protocol (Protocollo contesto modello). Viene visualizzato un elenco di connettori MCP.

  6. Seleziona il connettore MCP desiderato dall'elenco.

  7. Autorizza la connessione, inserendo le informazioni necessarie.

  8. Al termine, selezionare Aggiungi all'agente o Aggiungi e configura per continuare.

    La prima opzione aggiunge semplicemente il connettore MCP e i relativi strumenti all'agente, mentre il secondo aggiunge il connettore e i relativi strumenti, offrendo anche la possibilità di configurare i dettagli per il connettore.

Lo strumento MCP viene aggiunto all'agente in Strumenti.

Visualizzare l'elenco degli strumenti forniti con il connettore MCP

Per visualizzare l'elenco degli strumenti forniti con il server MCP aggiunto all'agente:

  1. Passare alla scheda Strumenti per l'agente.

  2. Selezionare il connettore MCP dall'elenco degli strumenti.

    Viene visualizzata una pagina di impostazione per il connettore MCP.

  3. Passare alla sezione Strumenti per visualizzare un elenco degli strumenti supportati dal server MCP.

Problemi noti e miglioramenti pianificati

Di seguito sono riportati i problemi identificati di cui il team di prodotto è a conoscenza e su cui sta lavorando:

Problemi Risoluzione/Soluzione alternativa
Attualmente, l'endpoint restituito nella chiamata di Connessione Open SSE deve essere un URI completo. Non applicabile

Contenuto correlato