Del via

Utvide agenten med Model Context Protocol

En annen måte å utvide agenten med verktøy på, er via Model Context Protocol (MCP).

Hva er modellkontekstprotokoll?

Modellkontekstprotokoll (MCP) gjør det mulig for brukere å koble til eksisterende kunnskapsservere og datakilder direkte innenfor Copilot Studio. Tilkobling til en MCP-server gir deg tilgang til:

  • Ressurser: Fillignende data som klientprogrammer kan lese (for eksempel API-svar eller filinnhold)
  • Verktøy: Funksjoner en språkmodell kan kalle opp
  • Spørringer: Forhåndsdefinerte spørringer for å utføre bestemte oppgaver

Notat

Copilot Studio støtter foreløpig bare verktøy.

Hvordan fungerer MCP?

Hvert verktøy som publiseres av MCP-serveren, legges automatisk til som et verktøy i Copilot Studio. Navn, beskrivelse, inndata og utdata arves fra serveren. Etter hvert som verktøy oppdateres eller fjernes på MCP-serveren, gjenspeiler Copilot Studio disse endringene dynamisk, slik at brukerne alltid har de nyeste versjonene, og foreldede verktøy fjernes. En enkelt MCP-server kan integrere og administrere flere verktøy, hver tilgjengelig som et verktøy i Copilot Studio.

Når du kobler til et ikke-Microsoft-produkt, inkludert en ekstern MCP-server, er du ansvarlig for verktøyene og dataene du får tilgang til fra Copilot Studio.

Notat

Generativ orkestrering må være aktivert for å bruke MCP.

Hva er prosessen med å utvide en agent ved hjelp av MCP i Copilot Studio?

Slik integrerer du MCP i Copilot Studio:

  1. Opprett en MCP-server.
  2. Opprett en egendefinert MCP-kobling basert på YAML-skjemamalen nedenfor.
  3. Bruk via Copilot Studio ved å legge til verktøy fra en eksisterende MCP-kobling til en agent.
  4. (Valgfritt) Publiser MCP-koblingen slik at koblingen kan brukes på tvers av leiere.

Opprett en MCP-server

Du kan bruke MCP software development kits (SDKs) til å konfigurere en MCP-server på ett av de støttede språkene.

Opprett en egendefinert MCP-kobling

Støttede transporter

I MCP er transporter grunnlaget for kommunikasjon mellom klient og server. Transporter håndterer mekanikken for å sende og motta meldinger. Copilot Studio støtter for øyeblikket følgende transporttyper:

  • Streamable – anbefalt (generelt tilgjengelig)
  • Server-Sent Hendelser (SSE) (offentlig forhåndsvisning)

Notat

Gitt at SSE transport blir utfaset, vil SSE transport-støtte i MCS forbli i offentlig forhåndsvisning. Copilot Studio vil ikke lenger støtte SSE for MCP fra august 2025.

Konfigurere en egendefinert kobling

Når MCP-serveren er konfigurert, må du konfigurere en egendefinert kobling (via Power Apps eller Power Automate) for MCP-serveren. Hvis du vil utføre denne prosedyren, trenger du en skjemafil for MCP-serveren. Skjemafilen er en OpenAPI YAML-spesifikasjonsfil som beskriver API-en til MCP-serveren din.

Hvis du vil ha veiledning om hvordan spesifikasjonsfilen skal se ut, kan du se noen av de angitte eksemplene på MCP-serverskjema.

  1. Velg Agenter i venstre navigasjonsrute.

  2. Velg agenten din fra listen over agenter.

  3. Gå til Verktøy-siden for agenten din.

  4. Velg Legg til et verktøy.

  5. Velg Nytt verktøy.

  6. Velg Egendefinert kobling. Du omdirigeres til Power Apps for å opprette en ny egendefinert kobling.

  7. Velg Ny egendefinert kobling.

  8. Velg Importer OpenAPI-fil.

  9. Naviger til skjemafilen, og velg Importer for å importere filen.

  10. Velg Fortsett for å fullføre installasjonen i Power Apps. Du kan lese mer om installasjonsprosessen i Power Apps-dokumentasjonen under Importer OpenAPI-definisjonen.

Eksempler på MCP-serverskjema

Her er to Eksempel på OpenAPI-skjemafiler for MCP-servere som bruker fiktive data, i YAML-format. Eksemplene viser hver av de støttede transportene. Du må fylle ut detaljene for din egen MCP-server.

Her er et eksempel på YAML for Streamable (anbefales):

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

Her er et eksempel yaml for 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

Microsoft MCP-koblinger tilgjengelig i Copilot Studio

Microsoft tilbyr en rekke forhåndsbygde MCP-koblinger for å koble til Microsoft-tjenester i Copilot Studio. Følgende er Microsoft MCP-koblinger tilgjengelig i Copilot Studio:

  • Datavers
  • Dynamics 365
    • Salg
    • Finans
    • Forsyningskjede
    • Tjeneste
  • Stoff

Legge til verktøy fra en eksisterende MCP-kobling til en agent

Du kan koble til eksisterende MCP-servere direkte fra Copilot Studio. Prosessen for å legge til verktøy er den samme, enten du oppretter for forhåndsbygde Microsoft MCP-koblinger eller for MCP-koblinger du oppretter selv.

Følg disse trinnene for å legge til en eksisterende MCP-kobling til en agent:

  1. Velg Agenter i venstre navigasjonsrute.

  2. Velg agenten fra listen.

  3. Gå til Verktøy-siden for agenten din.

  4. Velg Legg til et verktøy.

  5. Velg Modellkontekstprotokoll. En liste over MCP-koblinger vises.

  6. Velg den ønskede koblingen fra listen.

  7. Autoriser tilkoblingen, skriv inn all informasjon som trengs.

  8. Når du er ferdig, velger du Legg til i agent eller Legg til og konfigurer for å fortsette.

    Det første alternativet legger ganske enkelt til MCP-koblingen og dens verktøy til agenten, mens den andre legger til koblingen og dens verktøy samtidig som du får mulighet til å konfigurere detaljer for koblingen.

MCP-verktøyet legges til agenten din under Verktøy.

Vis listen over verktøy som følger med MCP-koblingen

Slik viser du listen over verktøy som følger med MCP-serveren som er lagt til agenten:

  1. Gå til Verktøy-fanen for agenten din.

  2. Velg MCP-koblingen fra listen over verktøy.

    En setingsside for MCP-koblingen vises.

  3. Gå til Verktøy-delen for å se en liste over verktøyene som støttes av MCP-serveren.

Kjente problemer og planlagte forbedringer

Følgende er identifiserte problemer som produktteamet kjenner til og arbeider med:

Problemer Løsning/omgåelse
For øyeblikket må endepunktet som returneres i kallet Åpne SSE-tilkobling, være en fullstendig URI. Ikke aktuelt

Relatert innhold