Konfigurer Azure Bot Service ferdigheter for bruk i Copilot Studio agenter

Bemerkning

Denne artikkelen beskriver funksjoner som brukes i agenter eller agentstrømmer drevet av standardledningsnettet.

Important

Denne artikkelen inneholder informasjon om Azure Bot Service skills, en kodebasert måte å utvide agentens muligheter i standardharnessen. Disse ferdighetene bør ikke forveksles med agentiske ferdigheter i Microsoft Copilot-verktøyet. Lær mer om hvordan du bruker agentferdigheter i Ferdighetsoversikt for agenter.

Copilot Studio lar deg utvide agenten din ved å bruke Azure Bot Service ferdigheter. Hvis du allerede har agenter bygget og distribuert i organisasjonen din (ved å bruke SDK for Microsoft 365-agenter eller andre pro-code-verktøy) for spesifikke scenarioer, kan du konvertere disse botene til Azure Bot Service ferdigheter og registrere dem i en Copilot Studio-agent.

Bemerkning

For å legge til en Azure Bot Service ferdighet fra Copilot Studio-appen i Microsoft Teams, må du ha et Microsoft Copilot Studio frittstående abonnement.

Denne artikkelen er ment for systemadministratorer eller IT-profesjonelle som er kjent med Azure Bot Service skills.

Når du registrerer en Azure Bot Framework-skill hos en Copilot Studio-agent, kan du sømløst utløse Azure Bot Service skill-handlinger i samtalen.

Forutsetninger

Important

Copilot Studio-agenter støtter kun Azure Bot Service-ferdigheter bygget med Legacy Bot Framework SDK versjon 4.12.0+ og SDK for Microsoft 365-agenter v1.0.0+. Nye Azure Bot Service skills bør bygges ved hjelp av SDK for Microsoft 365-agenter.

For å konfigurere en Azure Bot Service-skill, sett den tilknyttede appregistreringen i Microsoft Entra ID for skillen til enkeltleierkonfigurasjon.

Når man skal bruke agentflyter eller Azure Bot Service skills

Tabellen nedenfor hjelper deg å avgjøre når du bør bruke agentflyt eller Azure Bot Service ferdigheter for en samtale.

Faktor Når man skal bruke agentstrømmer Når du bør bruke Azure Bot Service-ferdigheter
Egenskap Agentforfattere kan bygge gjenbrukbare flyter for å bygges inn i en hvilken som helst agentsamtale. Utviklere kan opprette, distribuere og drifte tilpassede ferdigheter i eget miljø.
Samtaletype Bruk flyter for enkle operasjoner med én vending. Du kan for eksempel legge inn en ordre eller få ordrestatus. Bruk Azure Bot Service-ferdigheter til komplekse operasjoner med flere utvekslinger. Du kan for eksempel planlegge et møte eller en bestille en flyreise.
Svar Bruk flyter til å utsende et agentsvar. Vis for eksempel en tilpasset melding eller innebygde bilder. Bruk Azure Bot Service skills til å generere alle støttede agentresponser. Vis for eksempel et dynamisk kort, eller send tilfeldige svar.
Actions Bruk arbeidsflyter til å utløse server-side handlinger som fullføres i én omdreining. Du kan for eksempel kalle en HTTP API eller utløse en egendefinert kobling. Bruk ferdighetene i Azure Bot Service til å utløse server- og klientsidehendelser og -handlinger. Du kan for eksempel navigere til en side etter agentsvar.

Konfigurer en Azure Bot Service-skill

Først, bruk Copilot Studio til å opprette en agent og lage og implementere en Azure Bot Service skill ved hjelp av pro-code-verktøy i organisasjonen din. Se disse eksemplene:

Før du registrerer Azure Bot Service-skillen, gi agent-ID-en til skillutvikleren slik at de kan autorisere agenten til å kalle handlinger i skillen. Lær mer om tillatelseslisten for en Azure Bot Service ferdighet. Du kan få agent-ID-en din fra vinduet Legg til en ferdighet .

For å tilføre agenten din en Azure Bot Service ferdighet:

  1. Gå til agenten.

  2. Velg Innstillinger>Ferdigheter.

  3. Velg Legg til en ferdighet.

  4. Kopier agent-ID-en din. Du må oppgi agent-ID-en til skillutvikleren din.

  5. Skriv inn URL-en til Azure Bot Service skillmanifest. Et ferdighetsmanifest inneholder informasjonen agenten din trenger for å utløse handlinger innenfor ferdigheten.

  6. Velg Neste for å begynne valideringsprosessen. Når valideringen lykkes, blir skillen din lagt til agenten din. Du kan nå bruke denne ferdigheten i emnene dine.

Overholdelsesvurderinger

For å beskytte brukerens personvern må du registrere en Azure Bot Service-ferdighet som en app i den innloggede brukerens Microsoft Entra ID-tenant.

Feilsøke feil under Azure Bot Service skill-registrering

Systemet kjører en rekke valideringskontroller mot nettadressen. Disse kontrollene sikrer samsvar, styring og brukervennlighet for ferdigheten du legger til i agenten din. Du må rette opp disse feilene før du registrerer en Azure Bot Service skill.

Feilmelding Feilsøke / løsning
Vi støtte på problemer med å få ferdighetsmanifestet.
(MANIFEST_FETCH_FAILED)
Prøv å åpne manifestnettadressen i en nettleser. Hvis nettadressen gjengir siden innen 10 sekunder, må du registrere ferdigheten på nytt.
Manifestet er ikke kompatibelt.
(MANIFEST_MALFORMED)
(a) Kontroller at manifestet er en gyldig JSON-fil.
(b) Sjekk om manifestet inneholder nødvendige egenskaper
For eksempel, (name, msaAppId, enkeltendpoint, activities/id, activities/description,activities/type (kun event eller message støttet)).
Det er en mismatch i endepunktene dine
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)
Kontroller om ferdighetsendepunktet samsvarer med Microsoft Entra ID programregistreringens Publisher domain (foretrukket) eller Home page URL-feltet. Lær mer om hvordan du setter startsiden for endepunkter.
For å legge til en ferdighet må den først registreres
(APPID_NOT_IN_TENANT)
Kontroller om kompetansens program-ID er registrert i organisasjonens Microsoft Entra ID tenant.
Koblingen er ikke gyldig; Koblingen må begynne med https://
(URL_MALFORMED, URL_NOT_HTTPS)
Endre koblingen for å legge til en sikker nettadresse.
Manifestet er for stort;
(MANIFEST_TOO_LARGE)
Kontroller størrelsen på manifestet. Det må være mindre enn eller lik 500 kB.
Denne ferdigheten er allerede lagt til din agent.
(MANIFEST_ALREADY_IMPORTED)
Slett ferdigheten, og prøv å registrere den på nytt.
Ferdigheten er begrenset til 100 handlinger.
(LIMITS_TOO_MANY_ACTIONS)
Det er for mange ferdighetshandlinger definert i ferdighetsmanifestet. Fjern handlinger, og prøv på nytt.
Handlinger er begrenset til 25 inndata.
(LIMITS_TOO_MANY_INPUTS)
Det er for mange inndataparametere for ferdighetshandling. Fjern parametere, og prøv på nytt.
Handlinger er begrenset til 25 utdata.
(LIMITS_TOO_MANY_OUTPUTS)
Det er for mange utdataparametere for ferdighetshandling. Fjern parametere, og prøv på nytt.
Agenten kan ha et maksimum på 100 ferdigheter.
(LIMITS_TOO_MANY_SKILLS)
Det er for mange ferdigheter lagt til i en agent. Fjern en eksisterende ferdighet, og prøv på nytt.
Det ser ut som noe gikk galt.
(AADERROR_OTHER)
Det oppstod en forbigående feil under validering av ferdigheten. Prøv på nytt.
Noe gikk galt under kontrollen av ferdigheten.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)
Kontroller om ferdighetsendepunktet er tilkoblet og svarer på meldinger. Kontroller også at appregistreringen for enkeltleierferdigheten ble distribuert til samme leier.
Denne ferdigheten tillot ikke at agenten din ble lagt til på tillatelseslisten
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)
Sjekk om agenten din er lagt til i ferdighetens allowlist.