Administrer værktøjer til agenter i Microsoft 365 Administration

Agent Tools i Microsoft 365 Administration giver en central visning af alle AI-drevne værktøjer og MCP-servere (Model Context Protocol), der er tilgængelige i din organisation. Disse værktøjer definerer, hvordan en AI-model interagerer med brugerdata, værktøjer og arbejdsprocesser. Agent Tools giver dig mulighed for at håndtere anmodninger, svar og handlinger på en konsistent, sikker, sikker og gennemsigtig måde.

Hvert af de viste værktøjer repræsenterer en tjeneste, der understøtter Copilot-oplevelser på tværs af Microsoft 365-apps. Du kan overvåge tilgængelighed, administrere adgang og sikre overholdelse af organisationens politikker. Brug fanen Registreringsdatabase til at få vist og administrere de værktøjer, der er tilgængelige i din lejer, og fanen Anmodninger til at gennemse og godkende værktøjsanmodninger fra brugere i din organisation.

Vis registreringsdatabasen Agent Tools

1. Log på Microsoft 365 Administration.

2. Vælg Agents>Tools>Registry i navigationsruden til venstre.

   

Nøglekomponenter i Agent Tools

Listen Agentværktøjer under fanen Registreringsdatabase og fanen Anmodning indeholder filter, kolonner og handlinger, der kan hjælpe dig med at administrere dine agentværktøjer.

Handlinger

Du kan vælge de tilgængelige handlinger direkte på listen eller vælge den angivne agent for at få vist en oversigt over et agentværktøj. Agentværktøjer omfatter følgende handlinger:

Filtre

Registreringsdatabasen over agentværktøjer kan indeholde en stor og forskelligartet oversigt over værktøjer. Du kan filtrere listen, så du kan indsnævre visningen til de agentværktøjer, du vil fokusere på i øjeblikket.

Filtre er baseret på følgende kriterier:

Kolonner

I følgende tabel beskrives de kolonner, der er tilgængelige i registreringsdatabasen for agentværktøjer:

Almindelige MCP-servere

Du bruger en MCP-server som en tjeneste til at vise data, handlinger og forretningslogik for agenter.

Følgende er eksempler på MCP-servere:

• Dataverse MCP-server.
• Windows 365 for Agents MCP-server.
• Microsoft MCP management MCP-server.
• Administration værktøjer MCP Server til Microsoft 365 Administration.

Du kan få relaterede oplysninger under Microsoft Agent 365 SDK og kommandolinjegrænsefladen.

Byo-server (Bring Your Own) MCP

BYO-serverfunktionen (Bring Your Own) MCP gør det muligt for organisationer at registrere deres egne eksterne MCP-servere med Microsoft Agent 365 til central styring og observabilitet.

Store virksomheder bygger og driver ofte interne MCP-servere for at styrke deres agenter på tværs af forskellige forretningsarbejdsprocesser. Disse servere kører typisk uden for enhver organisationsstyringsgrænse uden administratorsynlighed i, hvilke værktøjer der eksponeres, ingen håndhævelse af politikker over, hvordan de aktiveres, og ingen brug af telemetri til sikkerheds- og overholdelsesteams. BYO MCP-serveren løser dette problem ved at dirigere registrerede servere via Agent 365 Tooling Gateway, hvilket giver it-administratorer kontrol via Microsoft 365 Administration og sikkerhedsteams de observability-data, de har brug for.

Sådan fungerer en BYO MCP-server

En BYO MCP-server følger et struktureret flow for udviklere og administratorer for at sikre, at alle eksterne MCP-servere gennemses og styres, før de gøres tilgængelige for agenter.

BYO MCP-serverens flow for udviklere og administratorer:

1. Udvikler registrerer en ekstern MCP-server via Agent 365 kommandolinjegrænsefladen, hvilket giver serverens URL-adresse, godkendelsestype og de værktøjer, der skal vises. Du kan få flere oplysninger under Registrer en ekstern MCP-server.

2. It-administratoren gennemser serveroplysningerne og deklarerede værktøjer i Microsoft 365 Administration og godkender eller afviser anmodningen. Ved godkendelse tildeler administratoren de nødvendige Microsoft Entra tilladelser til serveren. Du kan få flere oplysninger under Gennemse og godkend værktøjsanmodninger.

3. Godkendt MCP-server bruges af de understøttede klienter, f.eks. Copilot Studio og Visual Studio Code, til at bygge og teste agenter mod virkelige aktiveringer af værktøjer. Du kan få flere oplysninger under Brug en godkendt MCP-server.

4. Sikkerhedsteamet overvåger MCP-serveraktiviteten og værktøjsaktiveringerne gennem Microsoft Defender avanceret søgning efter overholdelse og registrering af uregelmæssigheder. Du kan få flere oplysninger under Overvåg og overvåg MCP-serveraktivitet.

Registrer en ekstern MCP-server

Du eller en udvikler kan registrere din egen eksterne MCP-server med Agent 365. I dette afsnit gennemgås de trin, der kræves for at registrere en ekstern MCP-server med Agent 365 ved hjælp af kommandolinjegrænsefladen, så it-administratorer kan gennemse og godkende den til brug i agentbygningsoverflader.

Dette afsnit indeholder de trin, der er nødvendige (ofte implementeret af en udvikler) for at registrere en ekstern MCP-server:

• Forstå forudsætninger for udviklere.
• Installér Agent 365 kommandolinjegrænsefladen.
• Registrer din MCP-server.

Forudsætninger for udviklere

Før du registrerer en ekstern MCP-server, skal du sørge for, at du har følgende forudsætninger:

• Installér Agent 365 kommandolinjegrænsefladen (eller opdater til den nyeste version). Hvis dette flow skal fungere, skal du have version 1.1.165-prøveversion eller nyere.

• Sørg for, at den Agent 365 tjenesteprincipal er klargjort i din lejer. Hvis du ikke kan finde den tjenesteprincipal, der er knyttet til appId ea9ffc3e-8a23-4a7d-836d-234d7c7565c1, klargøres tjenesteprincipalen ikke for din lejer. Hvis du vil konfigurere en tjenesteprincipal for Agent 365 i din lejer, skal du se:

  • Konfigurer tjenesteprincipal.
  • Få mere at vide om, hvem der kan klargøre en tjenesteprincipal.

• Et offentligt tilgængeligt MCP-serverslutpunkt, som du kan oprette forbindelse til fra internettet.

• Serveren er konfigureret med en af de understøttede godkendelsestyper:

  • NoAuth.
  • APIKey (header eller forespørgsel).
  • Ekstern godkendelse.
  • EntraOAuth.

Installér Agent 365-kommandolinjegrænsefladen

Hvis du vil installere Agent 365 kommandolinjegrænsefladen, skal du følge vejledningen i Installér Agent 365 kommandolinjegrænsefladen.

Registrer din MCP-server

Du er klar til at registrere din MCP-server med Agent 365, når du har:

• Installér Agent 365 kommandolinjegrænsefladen.
• Sørg for, at dit MCP-serverslutpunkt er offentligt tilgængeligt.
• Konfigureret med en understøttet godkendelsestype.

It-administratorer kan gennemse og godkende det til brug i agentopbygningsoverflader.

Du har et par muligheder for at registrere din MCP-server med Agent 365:

• Manuel registrering via kommandolinjegrænsefladena365 develop-mcp register-external-mcp-server: Kør kommandoen fra kommandolinjegrænsefladen, og angiv serveroplysninger, godkendelsestype og de værktøjer, som MCP-serveren fremviser.

• Registrering via JSON-fil: Bruges a365 develop-mcp register-external-mcp-server -f <path-to-file.json> til at registrere MCP-serveren ved at angive en JSON-fil, der indeholder alle serveroplysninger, godkendelsestype og værktøjsdefinitioner i en enkelt fil i stedet for at angive dem enkeltvist på kommandolinjen.

Se eksemplerne i følgende afsnit for at få oplysninger om, hvordan du registrerer en MCP-server med Agent 365 ved hjælp af kommandolinjegrænsefladen til forskellige godkendelsestyper.

NoAuth

For MCP-servere, der ikke kræver godkendelse:

a365 develop-mcp register-external-mcp-server \
--server-name "ZavaServer" \
--server-url "https://mcp.zava.com/mcp" \
--publisher "Contoso" \
--description "My external MCP server for document search" \
--auth-type "NoAuth" \
--tools "tool1,tool2"

{
  "serverName": "ext_DocsSearch",
  "serverUrl": "https://docs.contoso.com/api/mcp",
  "authType": "NoAuth",
  "description": "Documentation search MCP Server for Contoso developer docs.",
  "publisherName": "Contoso",
  "tools": [
    {
      "name": "search_docs",
      "description": "Search Contoso developer documentation and code samples."
    }
  ],
  "remoteScopes": null,
  "externalOAuth": null,
  "apiKey": null
}

APIKey (forespørgselsparameter)

For servere, der sender API-nøglen som en forespørgselsparameter:

a365 develop-mcp register-external-mcp-server \
--server-name "ZavaServer" \
--server-url "https://mcp.zava.com/mcp" \
--publisher "Contoso" \
--description "My external MCP server for document search" \
--auth-type APIKey \
--api-key-location Query \
--api-key-name apiKey \
--tools "tool1,tool2"

{
  "serverName": "ext_MarketData",
  "serverUrl": "https://api.contoso.com/market/mcp",
  "authType": "APIKey",
  "description": "Real-time stock market data and search from Contoso Market Services.",
  "publisherName": "Contoso",
  "tools": [
    {
      "name": "stock-market-data",
      "description": "Get real-time stock market data and financial information."
    },
    {
      "name": "real-time-search",
      "description": "Search the web for real-time information and news."
    }
  ],
  "remoteScopes": null,
  "externalOAuth": null,
  "apiKey": {
    "location": "Query",
    "name": "apiKey"
  }
}

APIKey (header)

For servere, der sender API-nøglen i en anmodningsheader:

a365 develop-mcp register-external-mcp-server \
--server-name "ZavaServer" \
--server-url "https://mcp.zava.com/mcp" \
--publisher "Contoso" \
--description "My external MCP server for document search" \
--auth-type APIKey \
--api-key-location Header \
--api-key-name token \
--tools "tool1,tool2"

{
  "serverName": "ext_InternalTools",
  "serverUrl": "https://tools.contoso.com/mcp",
  "authType": "APIKey",
  "description": "Contoso internal tools MCP Server with API key authentication.",
  "publisherName": "Contoso",
  "tools": [
    {
      "name": "tool1",
      "description": "First tool exposed by the server."
    },
    {
      "name": "tool2",
      "description": "Second tool exposed by the server."
    }
  ],
  "remoteScopes": null,
  "externalOAuth": null,
  "apiKey": {
    "location": "Header",
    "name": "X-API-Key"
  }
}

Ekstern OAuth

For servere, der godkendes via en ekstern OAuth-provider:

a365 develop-mcp register-external-mcp-server \
--server-name "ZavaServer" \
--server-url "https://zava.com/mcp" \
--publisher "Contoso" \
--description "My external MCP server for document search" \
--auth-type ExternalOAuth \
--idp-authorization-url "https://idp.zava.com/o/oauth2/v2/auth" \
--idp-token-url "https://idp.zava.com/oauth2/token" \
--idp-scopes "https://api.zava.com/read" \
--idp-client-id "<your-client-id>" \
--idp-client-secret "<your-client-secret>" \
--remote-scopes "https://api.zava.com/read" \
--tools "tool1,tool2"

{
  "serverName": "ext_Analytics",
  "serverUrl": "https://analytics.contoso.com/mcp",
  "authType": "ExternalOAuth",
  "description": "Contoso Analytics MCP Server for dataset and query operations.",
  "publisherName": "Contoso",
  "tools": [
    {
      "name": "list_datasets",
      "description": "List all available analytics datasets."
    }
  ],
  "remoteScopes": "https://analytics.contoso.com/.default",
  "externalOAuth": {
    "authorizationUrl": "https://auth.contoso.com/oauth2/authorize",
    "tokenUrl": "https://auth.contoso.com/oauth2/token",
    "scopes": "https://analytics.contoso.com/.default",
    "clientId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "clientSecret": "<your-client-secret>"
  },
  "apiKey": null
}

EntraOAuth

For servere, der godkendes via Microsoft Entra ID:

a365 develop-mcp register-external-mcp-server \
--server-name "ZavaServer" \
--server-url "https://mcp.zava.com/mcp" \
--publisher "Contoso" \
--description "My external MCP server for document search" \
--auth-type EntraOAuth \
--remote-scopes "https://api.zava.com/.default" \
--tools "tool1,tool2"

{
  "serverName": "ext_OrgDirectory",
  "serverUrl": "https://directory.contoso.com/mcp",
  "authType": "EntraOAuth",
  "description": "Contoso organization directory MCP Server secured with Entra OAuth.",
  "publisherName": "Contoso",
  "tools": [
    {
      "name": "list_users",
      "description": "List users in the organization directory."
    },
    {
      "name": "get_user_profile",
      "description": "Get the profile of a specific user by ID or UPN."
    }
  ],
  "remoteScopes": "api://contoso-directory/.default",
  "externalOAuth": null,
  "apiKey": null
}

Når registreringen er fuldført, skal du sende MCP-serveren til administratorgennemsyn i Microsoft 365 Administration.

Evaluer MCP-servere

Du kan evaluere kvaliteten af dine MCP-værktøjsdefinitioner med kommandoen a365 develop-mcp evaluate . Denne kommando undersøger serverens værktøjsskemaer og genererer en rapport med handlingsvejledning til forbedring af værktøjsnavne, beskrivelser og parameterskemaer.

De semantiske kontroller bedømmes af en kodeagent-CLI (GitHub Copilot CLI eller Claude Code), der kører lokalt på din computer, under din egen konto og dit AI-abonnement. Denne kommando sender ikke værktøjsskemadata til Microsoft.

Minimumrolle kræves: Ingen. Evalueringen kører lokalt i forhold til den URL-adresse til MCP-serveren, du angiver, og kalder ikke Azure eller Microsoft Graph.

Forudsætninger

• Kommandolinjegrænsefladen Agent 365. Se Installér Agent 365 kommandolinjegrænsefladen.
• Til semantisk (AI)-scoring: en lokalt installeret CLI for kodeagent:
  • GitHub Copilot kommandolinjegrænsefladen: Installer med npm install -g @github/copilot (Node.js 18 eller nyere). Dette er den separate copilot binære fil, ikke gitHub-kommandolinjegrænsefladeudvidelsen gh copilot .
  • Claude Kode: Installér med npm install -g @anthropic-ai/claude-code, eller følg Claude installation af kode.
• Hvis ingen af agenten er installeret, kører kommandoen stadig deterministiske kontroller og skriver tjeklisten, og stopper derefter, så du kan score de semantiske kontroller med din egen LLM (bring-your-own-LLM). Gå --eval-engine none til skip agent sondering helt.

Sådan fungerer evalueringen

Kommandoen kører en pipeline med fem trin og logfører status som vist i følgende tabel:

Hver kontrol er en af to typer:

• Deterministisk: Regelbaseret logik i kommandolinjegrænsefladen; bestået eller mislykket er nøjagtig og har ikke brug for kunstig intelligens (f.eks. "værktøjsnavnet er ikke tomt").
• Semantisk: Scoret af kodeagenten med en reason streng, der forklarer dommen.

Kørslen er idempotent. Hvis du kører den samme kommando igen, genbruges en eksisterende <server-name>_checklist.json og springer serverregistrering over, hvilket er den måde, bring-your-own-LLM-rundturen fungerer på: Scor selv tjeklisten, og kør derefter igen for at fortsætte. Slet tjeklistefilen for at gennemtvinge en ny søgning, når du har ændret værktøjsskemaerne.

Eksempler

Evaluer en lokal server med automatisk valg af program:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"

Evaluer en godkendt server med det token, der leveres via en miljøvariabel, og artefakter, der er skrevet til en undermappe:

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Generér kun tjeklisten, og scor den derefter med din egen LLM:

a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none

Gennemtving et bestemt pointprogram:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code

Læs rapporten

Åbn <server-name>_eval_report.html fra outputmappen i en browser. Rapporten viser:

• Den overordnede score (0-100; højere er bedre).
• Modenhedsniveauet (0-4) og dets mærkat.
• Scorer pr. værktøj med kategoriopdelinger: værktøjsnavn, beskrivelse af værktøj, parameternavn, parameterbeskrivelse og skemastruktur.
• En prioriteret liste over handlingselementer sorteret efter virkning, herunder de konkrete krav til at nå det næste udløbsniveau.

Datahåndtering og AI-gennemsigtighed

• Kommandoen behandler kun MCP-serverens statiske værktøjsskemaer (navne, beskrivelser og parameterskemaer) fra tools/list. Den behandler ikke nyttedata for kørsel, slutbrugerdata eller personlige data.
• CLI-kodeagenten kører på din maskine under dit eget AI-abonnement. Model-API-kaldet foretages direkte af denne kommandolinjegrænseflade til AI-udbyderen i henhold til dine servicebetingelser og fakturering. Kommandolinjegrænsefladen a365 angiver modellen, men mægles ikke i opkaldet.
• Værdien --auth-token opbevares i hukommelsen, sendes kun som HTTP-headeren Authorization til serveren og skrives aldrig til disken eller overføres til kodeagenten.
• Outputfiler (_checklist.json, _eval_report.html, _eval_report.json) skrives kun til din --output-dir og bliver på computeren.

Fejlfinding

Brug følgende fejlfindingsvejledning til at diagnosticere almindelige fejl og anvende den anbefalede rettelse.

Gennemse og godkend værktøjsanmodninger

Når en udvikler registrerer et værktøj, f.eks. en ekstern MCP-server, vises værktøjet i Microsoft 365 Administrationistration Center til gennemsyn og godkendelse.

Som administrator med de rette tilladelser til at administrere agentværktøjer i Microsoft 365 Administrationistration Center kan du gennemse, godkende eller afvise disse anmodninger for at styre, hvilke værktøjer der er tilgængelige til brug i din organisation.

Hvis du vil gennemse og godkende anmodninger om registrering af MCP-serveren, skal du følge disse trin:

1. Log på Microsoft 365 Administration.

2. Vælg Agentværktøjer>, og vælg derefter fanen Anmodninger.

3. Ventende anmodninger viser følgende oplysninger for hver server:

   • Servernavn
   • Publisher
   • Anmodet af
   • Anmodet dato

4. Gennemse serveroplysningerne og deklarerede værktøjer for nøjagtighed og overholdelse af angivne standarder.

5. Vælg Godkend for at gøre serveren tilgængelig i organisationens registreringsdatabase eller Afvis for at afvise anmodningen.

6. Ved godkendelse skal du give samtykke til de Microsoft Entra tilladelser, der kræves af MCP-serveren. Serveren bliver først tilgængelig for agentbygningsoverflader, når der er givet samtykke.

På baggrund af tilgængeligheden af MCP-servere vises følgende statusindikatorer:

• Tilgængelig – værktøjet er aktivt og klar til brug.
• Blokeret – værktøjet er deaktiveret, og agenter kan ikke få adgang til det.

Kontrolelementer til nøglestyring

I følgende tabel opsummeres de vigtigste styringskontrolelementer:

Brug en godkendt MCP-server

Når en MCP-server er godkendt og Microsoft Entra giver samtykke, kan du bruge den på tværs af understøttede agentopbygningsoverflader. Følgende klientoverflader understøtter i øjeblikket aktivering af godkendte BYO MCP-servere som prøveversion:

Som bruger i Copilot Studio skal du benytte følgende fremgangsmåde til at aktivere den godkendte BYO MCP-server:

1. Gå til Copilot Studio i dit miljø.

2. Opret en ny brugerdefineret agent (eller åbn en eksisterende).

3. Gå til afsnittet Funktioner, og vælg MCP-server.

4. Vælg MCP-serveren i registreringsdatabasen.

5. Test agenten ved at angive en prompt, der aktiverer MCP-serveren.

Få mere at vide om, hvordan du aktiverer godkendte BYO MCP-servere fra Claude code, VS Code og GitHub Copilot CLI i afsnittet Konfigurer arbejds-IQ MCP-servere til kodningsagenter i oversigten over Work IQ MCP.

Overvåg og overvåg MCP-serveraktivitet

Som medlem af organisationens sikkerhedsteam kan du bruge Microsoft Defender avanceret jagt til at spore og analysere MCP-serveraktiveringer. Denne proces hjælper dig med at se, hvilke agenter der aktiverer hvilke MCP-servere, hvornår aktiveringerne forekommer, og andre relevante metadata, der kan hjælpe med at registrere usædvanlige eller uautoriserede brugsmønstre.

Eksempel på KQL-forespørgsel – Defender Advanced Hunting:

CloudAppEvents
| where ActionType in ( "ExecuteToolByGateway")
| where RawEventData contains "tool name"

Denne forespørgsel returnerer oplysninger, herunder agentnavn, MCP-servernavn og aktiveringsmetadata.

Sletning af en BYO MCP-server

Microsoft understøtter i øjeblikket ikke sletning af en BYO MCP-server.

Administrer plug-ins

Plug-ins er API-baserede integrationer, der giver agenter adgang til eksterne data og forretningshandlinger. I modsætning til MCP-servere, der viser funktioner via protokollen Model Context, forbinder plug-ins typisk agenter direkte til programspecifikke tjenester og API'er.

Plug-in-handlinger

Installér plug-ins

Du kan installere plug-ins på tværs af hele organisationen eller for bestemte brugere eller grupper ved hjælp af den samme proces som enhver anden app i Microsoft 365 Administration.

Hvis du vil installere en plug-in, så den er tilgængelig, skal du følge disse trin:

1. Log på Microsoft 365 Administration.
2. Select Agents>Tools>Plugins.
3. Vælg en plug-in, der skal installeres, på listen over plug-ins. Ruden Oversigt over plug-in vises.
4. Vælg Installér i ruden Oversigt over plug-ins.
5. I ruden Vælg brugere skal du bekræfte plug-in'en og kanaloplysningerne.
6. Vælg, hvem der kan bruge plug-in'en ved at vælge enten Alle brugere eller bestemte brugere eller grupper.
7. Vælg Næste.
8. I ruden Gennemse & installation skal du bekræfte oplysningerne og vælge Installér.

Fjern plug-ins

Du kan fjerne plug-ins på tværs af hele organisationen eller for bestemte brugere eller grupper ved hjælp af den samme proces som enhver anden app i Microsoft 365 Administration. Når du fjerner en plug-in, fjerner du plug-in'en fra miljøet. Plug-in'en vil ikke længere være tilgængelig for agenter, medmindre den er installeret igen.

Hvis du vil fjerne en plug-in, så den ikke er tilgængelig, skal du følge disse trin:

1. Log på Microsoft 365 Administration.
2. Select Agents>Tools>Plugins.
3. Vælg en plug-in, der skal fjernes, på listen over plug-ins. Ruden Oversigt over plug-in vises.
4. I ruden Oversigt over plug-ins skal du vælge Fjern.
5. Bekræft fjernelsen ved at vælge Fjern.

Bloker plug-ins

Du kan blokere et plug-in på tværs af hele organisationen ved hjælp af Microsoft 365 Administration. Når du blokerer et plug-in, forhindrer du, at plug-in'en bruges, samtidig med at den er registreret og synlig i Microsoft 365 Administration. Plug-in'en forbliver installeret og tilgængelig i lejeren, men agenter kan ikke aktivere den, før blokeringen fjernes.

Hvis du vil blokere en plug-in, skal du følge disse trin:

1. Log på Microsoft 365 Administration.
2. Select Agents>Tools>Plugins.
3. Vælg en plug-in, der skal blokeres, på listen over plug-ins. Ruden Oversigt over plug-in vises.
4. Vælg Blok.
5. Bekræft, at plug-in'en er blokeret korrekt.

Fjern blokering af plug-ins

Du kan fjerne blokeringen af en plug-in på tværs af hele organisationen ved hjælp af Microsoft 365 Administration.

Følg disse trin for at fjerne blokeringen af en plug-in:

1. Log på Microsoft 365 Administration.
2. Select Agents>Tools>Plugins.
3. På listen over plug-ins skal du vælge en plug-in for at fjerne blokeringen. Ruden Oversigt over plug-in vises.
4. Vælg Fjern blokering.
5. Bekræft, at blokeringen af plug-in'en er fjernet.