Administrer Copilot Studio-agenter

Note

Dette verktøyet er tilgjengelig som standard på følgende MCP-servere: Dynamics 365 Customer Service. Verktøyene og eksemplene i denne dokumentasjonen illustrerer dagens muligheter. Verktøynavn, beskrivelser, parametere, svarformater og tilgjengelig funksjonalitet kan endres over tid.
Når du bygger agenter, integrasjoner eller orkestreringslogikk, bør du ikke hardkode avhengigheter på spesifikke verktøynavn, parameterstrukturer, verktøymetadata eller responsskjemaer. I stedet bør du designe løsningen din for å oppdage og bruke tilgjengelige verktøy under kjøring.
Etter hvert som plattformen utvikler seg, kan Microsoft legge til, fjerne, gi nytt navn eller endre verktøy og verktøymetadata. Å designe mot kapabiliteter i stedet for spesifikke verktøyidentifikatorer bidrar til å opprettholde kompatibilitet på tvers av tjenesteoppdateringer.

Bruk denne funksjonen når du vil registrere, redigere eller fjerne Copilot Studio-agenter som serviceagenten kan delegere spørsmål til under en samtale.

Hva det gjør

Assistenten åpner et administrasjonsgrensesnitt hvor du kan administrere Copilot Studio-agentregistreringer for ditt Dynamics 365-miljø. Copilot Studio-agenter er publiserte roboter som tjenesteagenten kan sende spørsmål til etter skjemanavn.

Fra registreringswidgeten kan du legge til nye agentdelegeringer, redigere eksisterende, teste tilkobling og fjerne registreringer du ikke lenger trenger. Hver registrering inkluderer et visningsnavn, bot-identitet, beskrivelse, skjemanavn og valgfrie inndataparametere.

Prøv prompts som

  • "Styr mine Copilot Studio-agenter"
  • "Registrer en under-agent"
  • "Vis MCS-agentregistreringene mine"
  • "Legg til en Copilot Studio-botdelegasjon"
  • "Deleger til en agent"
  • "Jeg vil legge til en MCS-agent"

Hva du vil se i chatten

Assistenten viser en interaktiv registreringsstyringswidget som en app-i-chat-komponent. Hvis du allerede har registreringer, viser widgeten dem i en liste med nøkkeldetaljer som visningsnavn, verktøynavn, beskrivelse og skjemanavn.

Nyttige tips

  • Du trenger Service Agent Maker Customizing-privilegiet for å administrere registreringer.
  • Kun publiserte, aktive Copilot Studio-bots i ditt miljø kan registreres.
  • Bruk alltid Test Connection-knappen før du lagrer for å verifisere at agenten er tilgjengelig via Agents SDK.
  • Miljøet ditt støtter opptil 10 Copilot Studio-agentregistreringer.
  • Beskrivelsen du gir vises til serviceagenten ved ruting, så skriv den tydelig for å hjelpe agenten med å avgjøre når de skal delegere.

Tips

Etter å ha registrert en agent, kan serviceagenten delegere spørsmål til den i fremtidige samtaler. Agenten vises som et verktøy med prefikset .mcs_

Hva skjer videre?

Etter at registreringswidgeten vises, kan du:

  • "Legg til en ny Copilot Studio-agent"
  • "Test agentforbindelsen min"
  • "Fjern FAQ-boten"
  • "Rediger beskrivelsen for min registrerte agent"

Endrer dette dataene?

Dette steget er skrivebeskyttet, men oppfølgingshandlinger kan endre data.

Å åpne registreringswidgeten endrer ikke dataene. Å legge til, redigere eller fjerne registreringer fra widgeten endrer konfigurasjonen i miljøet ditt.

Hva du kan gjøre fra app-i-chat-komponenten

Fra registreringswidgeten i chatten kan du:

  • Se alle registrerte Copilot Studio-agenter for ditt miljø
  • Legg til en ny agentregistrering ved å velge en publisert bot fra miljøet ditt
  • Rediger visningsnavnet eller beskrivelsen til en eksisterende registrering
  • Test tilkoblingen til en registrert agent for å verifisere at den er tilgjengelig
  • Fjern en registrering du ikke lenger trenger

Forutsetninger

Dette verktøyet krever følgende:

  • Copilot-utvidbarhet med Copilot Studio skal konfigureres. Krever rollen som Systemadministrator eller Copilot Service-administrator

Lær mer i Extend Copilot med Copilot Studio.

Verktøyoversikt

Eiendom Verdi
Brukervendt navn Administrer Copilot Studio-agenter
Internt verktøynavn manage_copilot_studio_registration
Formål Åpner admin-grensesnittet for å administrere Copilot Studio-agentregistreringer

Verktøyatferd

Åpner admin-grensesnittet for å administrere Copilot Studio-agentregistreringer. Administratorer kan liste, registrere eller avregistrere publiserte Copilot Studio-boter som Service Agent kan delegere spørsmål til etter skjemanavn. Dette verktøyet dekker kun Copilot Studio-agentdelegering; HTTPS-verktøyserver-endepunkter administreres via manage_mcp_registration.

Merknader

Merknad Verdi Betydning
readOnlyHint true Dette verktøyet endrer ikke data direkte. Widgeten kaller separate lagre/slett-verktøy.
destructiveHint Ikke angitt Ikke aktuelt (skrivebeskyttet launcher).
idempotentHint Ikke angitt Ikke aktuelt (skrivebeskyttet launcher).
openWorldHint Ikke angitt Bruker standard (spørringer Dataverse + Power Platform).

Inndatabegreper

Tiltak

Inndata Beskrivelse Obligatorisk
open, list open (standard) eller list. open gjengir den interaktive registreringsstyringswidgeten. listreturnerer en tekstoppsummering av nåværende registrerte Copilot Studio-agenter. Nei

Organisasjons-URL

Inndata Beskrivelse Obligatorisk
orgUrl orgUrl (valgfritt). Overstyrer den nåværende valgte miljø-URL-en når verten ikke oppgir en. Nei

Respons og UI-oppførsel

Dette MCP-verktøyet støttes av en MCP-app.

Svartype

Interaktiv widget (handling open) eller tekstsammendrag (handling list)

Når handling er open, viser widgeten registreringsadministrasjonsgrensesnittet hvor administratorer kan bla gjennom, legge til, teste og fjerne Copilot Studio-agentregistreringer. Når handling er list, returnerer verktøyet en tekstbasert oppsummering.

Rutingsnotater

Bruk manage_copilot_studio_registration når:

  • Brukeren nevner Copilot Studio, MCS-agenter, underagenter eller bot-delegering
  • Brukeren ønsker å legge til, fjerne eller bla gjennom agentintegrasjoner

Ikke bruk dette verktøyet når:

  • Brukeren nevner MCP-servere, verktøyendepunkter eller HTTPS-URL-er – rute til manage_mcp_registration
  • Brukeren ønsker å konfigurere agentoppsett (rutenett, skjemaer, tidslinjer) – rute til browse_agent_config_options
Verktøy Forhold
save_copilot_studio_registration Widget-aktivert verktøy som opprettholder en ny eller oppdatert agentregistrering
delete_copilot_studio_registration Widget-aktivert verktøy som fjerner agentregistrering
test_copilot_studio_registration_connection Widget-aktivert verktøy som tester agentens tilgjengelighet
list_copilot_studio_registration_bots Widget-aktivert verktøy som lister opp tilgjengelige boter for botvelgeren
manage_mcp_registration Administrerer HTTPS MCP-verktøyserverregistreringer (separat omfang)

Datamutasjonsklassifisering

Skrivebeskyttet launcher med nedstrøms mutasjon via widget.

Selve launcheren endrer ikke data. Widgeten kaller save_copilot_studio_registration og delete_copilot_studio_registration for skriveoperasjoner.