Lagre MCS-agentregistrering

Notat

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.

Denne funksjonen fungerer bak kulissene når du legger til eller redigerer en Copilot Studio-agentregistrering fra registreringsstyringswidgeten.

Hva det gjør

Når du fyller ut registreringsskjemaet i Copilot Studio-agentadministrasjonswidgeten og velger Lagre, lagrer dette verktøyet registreringen i Dynamics 365-miljøet ditt. Den håndterer både opprettelse av nye registreringer og oppdatering av eksisterende.

Verktøyet validerer botens identitet og skjemanavn, håndhever registreringsgrensen (10 per miljø), og forhindrer dupliserte bot-ID-er eller skjemanavn. Ved suksess lagrer den registreringen og oppdaterer Service Agents verktøyliste slik at den nye agentdelegeringen blir tilgjengelig.

Prøv prompts som

Gjelder ikke. Dette verktøyet kalles automatisk når du lagrer en registrering fra administrasjonswidgeten. Den aktiveres ikke ved å skrive en prompt.

Hva du vil se i chatten

Registreringswidgeten oppdateres for å bekrefte at lagringen lyktes, og viser registrerings-ID-en og om den ble opprettet eller oppdatert. Hvis valideringen feiler (for eksempel en duplisert bot-ID eller skjemanavn), viser widgeten en feilmelding som forklarer hva som skal fikses.

Nyttige tips

• Du må kjøre Test Connection før du lagrer en ny registrering. Bot-metadataene fra testen brukes til å fylle ut nødvendige felt.
• Hver bot kan bare registreres én gang. Fjern den eksisterende registreringen først hvis du må registrere den samme boten på nytt.
• Beskrivelsen du gir, er det serviceagenten ser når han skal avgjøre om han skal delegere et spørsmål til denne agenten. Gjør det klart og spesifikt.
• Skjemanavn må være unike på tvers av alle Copilot Studio-registreringer i ditt miljø.

Hva skjer videre?

Etter lagring går registreringswidgeten tilbake til listevisningen. Du kan gjøre følgende:

• "Test forbindelsen igjen"
• "Rediger registreringen jeg nettopp lagret"
• "Legg til en ny Copilot Studio-agent"

Endrer dette dataene?

Ja, dette endrer dataene.

Å lagre en registrering oppretter eller oppdaterer en konfigurasjonspost i Dynamics 365-miljøet ditt og oppdaterer Service Agents tilgjengelige verktøyliste.

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	Lagre MCS-agentregistrering
Internt verktøynavn	save_copilot_studio_registration
Formål	Opprettholder en ny eller oppdatert Copilot Studio (MCS) agentregistrering

Verktøyatferd

Vedvarer en ny eller oppdatert Copilot Studio (MCS)-agentregistrering. Dette er et widget-støtteverktøy som aktiveres automatisk når brukere interagerer med utvidelsesregistreringswidgeten. Den er ikke ment for direkte påkallelse av modellen.

Merknader

Merknad	Verdi	Betydning
readOnlyHint	false	Dette verktøyet oppretter eller oppdaterer registreringsdata.
destructiveHint	false	Oppdateringer er ikke-destruktive (upsert-mønster).
idempotentHint	true	Gjentatte anrop med samme inngang gir samme resultat.
openWorldHint	Ikke angitt	Bruker standard.

Inndatabegreper

Registreringsobjekt

Inndata	Beskrivelse	Obligatorisk
botId, name, displayName, , description, inputParameters, environmentId, , schemaNamem365AppId	Inneholder agentregistreringsdetaljer inkludert botId (Dataverse-bot GUID), name (unik identifikator), displayName, description, inputParameters, ( environmentId Power Platform-miljø), schemaName, og m365AppId.	Nei

Registrerings-ID

Inndata	Beskrivelse	Obligatorisk
id	id (valgfritt). Når den er tilgjengelig, oppdaterer den en eksisterende registrering; når den utelates, opprettes en ny.	Nei

Organisasjons-URL

Inndata	Beskrivelse	Obligatorisk
orgUrl	orgUrl (valgfritt). Overstyrer URL-en til det nåværende valgte miljøet.	Nei

Respons og UI-oppførsel

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

Svartype

Widget-oppdatering

Widgeten oppdateres for å vise den lagrede registreringen.

Rutingsnotater

Dette verktøyet kalles utelukkende av widgeten manage_copilot_studio_registration . Ikke påkall det direkte.

Relaterte verktøy

Verktøy	Forhold
manage_copilot_studio_registration	Launcher-verktøyet som åpner registreringswidgeten
delete_copilot_studio_registration	Fjerner agentregistreringen
test_copilot_studio_registration_connection	Tester agentens tilgjengelighet før lagring
list_copilot_studio_registration_bots	Lister over tilgjengelige roboter for botvelgeren

Datamutasjonsklassifisering

Skriv (oppsert). Oppretter eller oppdaterer en Copilot Studio-agentregistrering i den organisasjonsbaserte registreringsbutikken.