Tilføj en Model Context Protocol (MCP)-server til din agent som et værktøj (forhåndsvisning)

[Denne artikel er foreløbig dokumentation og kan ændres.]

Model Context Protocol (MCP) er en standard til at eksponere værktøjer for en agent. Når du tilføjer en MCP-server til din agent, bliver alle de værktøjer, serveren eksponerer, tilgængeligt for agenten at aktivere under en samtale.

Note

Funktionerne i denne artikel drives af GitHub Copilot-harnessen, som bruger Copilot Credits til brugsbaseret fakturering. Lær mere om Copilot Credits i Oversigt over fakturering for agenter drevet af GitHub Copilot-harnesset.

Brugsbaseret fakturering gælder for brug, opbygning, test og evaluering af agenter. Disse handlinger kan forbruge Copilot-kreditter.

Brug denne vejledning, når du vil tilføje en MCP-server til en agent i den nye oplevelse. For et overblik over værktøjstyper i den nye oplevelse, se Tilgængelige værktøjer for agenter.

Forudsætninger

  • En agent skabt i den nye oplevelse. Se Opret en agent.
  • URL'en til en MCP-server, som kan nås fra Copilot Studio. Hvis du ikke har en endnu, se Opret en ny Model Context Protocol (MCP) server.
  • Alle legitimationsoplysninger, som serveren kræver (for eksempel en API-nøgle eller et klient-ID og hemmelighed for en understøttet autentificeringsordning).

Tilføj en MCP-server fra fanen Byg.

  1. Log ind på Copilot Studio og åbn din agent.

  2. I agentens navigationslinje skal du vælge fanen Byg.

  3. I komponentpanelet til højre skal du vælge Værktøjer.

  4. I dialogen Tilføj et værktøj vælger du Tilføj ved siden af søgefeltet, og vælg derefter Model Context Protocol (MCP).

  5. På siden Tilføj MCP-server indtast følgende oplysninger:

    • Navn: et kort, beskrivende navn, der hjælper agenten med at beslutte, hvornår serverens værktøjer skal bruges. Dette er det navn, agenten ser.
    • Beskrivelse: et ét- eller to-sætnings resumé af, hvad serveren gør, og hvornår agenten bør bruge det.
    • Server-URL: HTTPS-endepunktet for MCP-serveren.
    • Autentificering: vælg den autentificeringsmetode, serveren kræver, og indtast de legitimationsoplysninger eller konfigurationsværdier, som metoden kræver.

  6. Vælg Tilføj for at forbinde.

    Copilot Studio kontakter MCP-serveren, forhandler protokollens håndtryk og lister derefter de værktøjer, serveren eksponerer.

  7. Gennemgå listen over værktøjer, der dukker op.

    For hvert værktøj skal du tjekke navn og beskrivelse. Hvis et værktøj ikke har en klar beskrivelse, er agentens svar, der involverer værktøjet, mindre pålidelige. Bed MCP-serverens forfatter om at forbedre beskrivelsen, før du stoler på værktøjet i produktion.

  8. Vælg Save for at færdiggøre tilføjelsen af serveren.

Serveren vises i agentens værktøjsliste under fanen Byg.

Test serveren

Når du har tilføjet serveren, skal du teste den, før du offentliggør agenten.

  1. Vælg fanen Forhåndsvisning .

  2. Stil agenten et spørgsmål, der kræver et af serverens værktøjer.

  3. Gennemgå agentens svar. Åbn aktivitetssporet for at verificere, hvilket værktøj der blev kaldt, hvilke argumenter der blev sendt, og hvad værktøjet returnerede. Se Brug aktivitetssporet til at fejlfinde din agent.

Hvis agenten ikke aktiverer værktøjet, som du forventer, så forfin værktøjsnavnet, værktøjsbeskrivelsen eller agentens instruktioner. Se Konfigurer agentdetaljer og instruktioner.

Administrer serveren efter tilføjelse

For at fjerne en MCP-server eller midlertidigt slukke en, brug det standard værktøjsstyringsflow. Se Administrer og slet værktøjer i en agent.

Hvis en servers URL, autentificering eller eksponerede værktøjer ændres efter tilføjelsen, skal du redigere serverposten i samme Tools-dialog for at opdatere forbindelsen og læse værktøjslisten igen.

Grænser

  • Hver agent kan forbinde til flere MCP-servere, men det samlede antal MCP-serverinstanser, der kan køre samtidig i en enkelt samtale, er begrænset. Hvis du tilknytter flere MCP-servere end cap'en tillader, og agenten prøver at bruge dem alle i samme tur, springer de ekstra servere over, og deres værktøjer er ikke tilgængelige i den tur.
  • Hold antallet af MCP-servere tilknyttet en enkelt agent lille, og fjern servere, du ikke længere bruger, så agenten har plads til at aktivere de servere, du går op i.
  • Hver MCP-server tæller med i det samlede antal værktøjer, en agent kan hoste.
  • Last updated on