Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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
- Gå gjennom restriksjoner og validering av Azure Bot Service ferdighetene som brukes i Copilot Studio
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:
Gå til agenten.
Velg Innstillinger>Ferdigheter.
Velg Legg til en ferdighet.
Kopier agent-ID-en din. Du må oppgi agent-ID-en til skillutvikleren din.
Skriv inn URL-en til Azure Bot Service skillmanifest. Et ferdighetsmanifest inneholder informasjonen agenten din trenger for å utløse handlinger innenfor ferdigheten.
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. |