Kom i gang med den eksterne MCP-server for operationsagenter (forhåndsvisning)

Brug den eksterne Model Context Protocol (MCP)-server til operationsagenter til at konfigurere mål og instruktioner, administrere videnskilder og handlinger, generere playbooks og styre overvågning gennem naturligt sprog.

En operationsagent eksponerer to MCP-endepunkter:

• Et konfigurerende endpoint til at læse og opdatere agentens opsætning og generere dens playbook.
• Et forespørgselsendepunkt til inspektion af agentens tilstand og dens overvågningsoperationer.

For at komme i gang med den eksterne MCP-server for en operationsagent, følg disse trin:

1. Forbind til den eksterne MCP-server for operationsagenter fra Visual Studio Code eller GitHub Copilot CLI.
2. Konfigurer MCP-klienten med serverens URL'er og autentificering.
3. Brug GitHub Copilot til at konfigurere agenten, generere en playbook og styre overvågning ved hjælp af naturligt sprog.
4. Valider forbindelsen ved at bruge testprompts.

Forudsætninger

Før du sætter MCP-serveren op og bruger den, skal du sikre dig, at du har:

• Visual Studio Code.

• GitHub Copilot i Visual Studio Code.

• En datakildeforbindelse.

• En operationsagent i et Fabric-arbejdsområde, hvor du har rollen som bidragsyder eller administrator.

  Bemærk arbejdsområdets ID og operationsagentens item-ID fra Fabric item URL'en. URL-formatet er https://app.fabric.microsoft.com/groups/<Workspace ID>/operationsagents/<Item ID>.

Godkendelse

Serveren bruger OAuth. Konfigurér din MCP-klient til at erhverve og videregive en gyldig Microsoft Entra ID-token. GitHub Copilot håndterer dette token automatisk.

Du har brug for bidragyder- eller administratoradgang til arbejdsområdet, der indeholder operationsagenten.

Forbind til operationsagentens MCP-server

Hver operationsagent eksponerer to HTTP-baserede MCP-endepunkter: én til konfiguration og én til forespørgsler.

Server-URL'er

https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/configure
https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/query

MCP-klientkonfiguration

Tilføj begge fjern-MCP-serverdefinitioner til MCP-klientens konfigurationsfil. I Visual Studio Code kan du bruge .vscode/mcp.json til arbejdsområdekonfiguration eller din brugerprofil til brugerkonfiguration. For mere information, se Visual Studio Code MCP-konfigurationsreferencen.

{
  "servers": {
    "operations-agent-configure": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/configure"
    },
    "operations-agent-query": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/query"
    }
  }
}

Tilgængelige værktøjer

Operationsagentens MCP-server eksponerer værktøjer, som AI-agenter kan bruge til at konfigurere og drive en operationsagent. Værktøjerne er fordelt på konfigurations - og forespørgen-endpoints .

Konfigurér server

Brug konfigurationsendpointet til at læse og opdatere agentens opsætning, administrere videnskilder og handlinger, generere dens playbook og starte eller stoppe overvågning.

Forespørgselsserver

Brug forespørgselsendepunktet til at inspicere agentens tilstand og dens overvågningsoperationer.

Datakildeforbindelse

En operationsagent har brug for en forbundet datakilde, før den kan generere en playbook. Du kan forbinde en datakilde på to måder:

• Fabric UI: Forbind datakilden fra agenteditoren under Knowledge Source.

• MCP-værktøj: Brug værktøjet add_or_update_eventhouse_knowledge_source til at tilføje en KQL-database eller eventhouse, eller add_or_update_fabric_ontology_knowledge_source til at tilføje en Fabric-ontologi.

Eksempler: Konfigurer en agent

Eksempelprompt:

"Indstil agentens instruktioner til: Overvåg cykeltilgængelighed på alle vores stationer for lav cykeltilgængelighed. Alarmér, når færre end 3 cykler er tilgængelige på en station."

svar:

Ringer set_agent_instructions og bekræfter, at instruktionerne er opdateret.

Eksempelprompt:

"Tilføj en eventhouse-videnskilde, MyDB så agenten kan overvåge mine motorcyklers data."

svar:

Ringer add_or_update_eventhouse_knowledge_source og bekræfter, at datakilden var forbundet.

Eksempelprompt:

"Tilføj en handling, så agenten kan bruge <URL eller beskrivelse af et Fabric-element> med en Location-parameter."

svar:

Kalder add_or_update_agent_action og bekræfter, at handlingen blev tilføjet med parameteren bevaret.

Eksempler: Lav og gennemgå en playbook

Eksempelprompt:

"Lav en playbook for denne agent."

svar:

Kalder generate_playbook og returnerer et playbook-ID med status InProgress. Genereringen tager typisk et til tre minutter.

Eksempelprompt:

"Hvad er status på playbook-generationen?"

svar:

Opkald get_generate_playbook_status og rapporter fremgang. Gentag , indtil statussen er Completed.

Eksempelprompt:

"Vis mig playbook-resuméet og reglerne."

svar:

Kalder get_playbook_summary og get_playbook_rules returnerer forretningsenheder, ordliste og overvågningsregler.

Eksempelprompt:

"Vis mig detaljerne i den første playbook-regel."

svar:

Kalder get_rule_details med regel-ID'et og returnerer den fulde betingelse og binding.

Eksempler: Administrer overvågning

Her er nogle eksempler på prompts:

• "Hvad er den nuværende tilstand for denne operationsagent?"

• "Start agenten."

• "Stop agenten."

• "Vis mig de seneste operationer."

• "Få detaljer om den seneste operation."

• "Giv mig et komplet billede: instruktioner, videnskilder, handlinger, spillebog og tilstand."

Den sidste prompt kæder flere værktøjer på tværs af begge endepunkter og syntetiserer resultaterne til en enkelt opsummering.

Begrænsninger

• Konfiguration per element: Hvert par af MCP-server-URL'er gælder for en enkelt operationsagent. For at arbejde med flere agenter skal du konfigurere en separat MCP-serverpost for hver enkelt.

• Datakilde nødvendig for playbooks: Agenten kan ikke generere en playbook, før mindst én videnskilde er forbundet. Forsøg på at generere en playbook uden en datakilde giver en fejl.

• Understøttede videnskilder: Du kan forbinde eventhouse- eller KQL-databasekilder og Fabric-ontologikilder. Andre datakildetyper understøttes ikke i øjeblikket.

• Kun manuel konfiguration: Du skal manuelt tilføje MCP-serverens URL'er til klientens konfigurationsfil. Automatisk opdagelse er ikke tilgængelig.

Tip

• Forbind også eventhouse MCP-serveren: Hvis din datakilde er en Fabric eventhouse, forbedrer det resultaterne betydeligt at forbinde eventhouse MCP-serveren sammen med operationsagenten. Din agent kan derefter inspicere dit databaseskema, sample data og validere KQL-forespørgsler.

• Vær specifik med agentinstruktionerne: Kvaliteten af playbooken afhænger af, hvor tydeligt du beskriver, hvad der skal overvåges. Angiv dataværdier, tærskler og betingelser eksplicit. For mere vejledning, se operations agent best practices.

• Konfigurér før du genererer: Sæt instruktioner, handlinger og videnskilder før du kalder generate_playbook. Genkonfiguration efter generering kræver regenerering af playbooken.

• Tjek staten før du handler: Brug get_agent_state den til at bekræfte, at agenten er Active det, eller Inactive før du starter eller stopper overvågning.

Relateret indhold

• Hvad er MCP i Real-Time Intelligence (forhåndsvisning)?
• Opret og konfigurer operationsagenter
• Kom i gang med den eksterne MCP-server til eventhouses
• Kom i gang med den fjernbetjente MCP-server til Activator
• Tilføj og administrer MCP-servere i VS Code
• Tilføjelse af MCP-servere til GitHub Copilot CLI