Konfigurér Azure Bot Service færdigheder til brug i Copilot Studio agenter

Note

Denne artikel beskriver funktioner, der anvendes i agenter eller agentstrømme, drevet af standardledningsnettet.

Vigtig

Denne artikel indeholder information om Azure Bot Service skills, en kodebaseret måde at udvide en agents evner i standardharnessen. Disse færdigheder bør ikke forveksles med agentbaserede færdigheder i GitHub Copilot-rammen. Lær mere om, hvordan du bruger agentiske færdigheder i oversigt over færdigheder for agenter.

Copilot Studio lader dig udvide din agent ved at bruge Azure Bot Service færdigheder. Hvis du allerede har agenter bygget og implementeret i din organisation (ved hjælp af SDK til Microsoft 365-agenter eller andre pro-code-værktøjer) til specifikke scenarier, kan du konvertere disse bots til Azure Bot Service færdigheder og registrere dem i en Copilot Studio-agent.

Note

Hvis du vil tilføje en Azure Bot Service-færdighed fra appen Copilot Studio i Microsoft Teams, skal du have et enkeltstående abonnement med Microsoft Copilot Studio.

Denne artikel er tiltænkt systemadministratorer eller IT-professionelle, der er bekendt med Azure Bot Service skills.

Når du registrerer en Azure Bot Framework-færdighed i en Copilot Studio-agent, kan du uden problemer udløse Azure Bot Service-færdighedshandlinger i samtalen.

Forudsætninger

Vigtig

Copilot Studio agenter understøtter kun Azure Bot Service færdigheder, der er bygget med Legacy Bot Framework SDK version 4.12.0+ og SDK til Microsoft 365-agenter v1.0.0+. Nye Azure Bot Service færdigheder bør bygges ved hjælp af SDK til Microsoft 365-agenter.

Hvis du vil konfigurere en Azure Bot Service-færdighed, skal du angive den tilknyttede appregistrering i Microsoft Entra ID for din færdighed til konfiguration med en enkelt lejer.

Hvornår man skal bruge agent flows eller Azure Bot Service skills

Følgende tabel hjælper dig med at afgøre, hvornår du skal bruge agent flows eller Azure Bot Service skills til en samtale.

Faktor Hvornår man skal bruge agentstrømme Hvornår skal man bruge Azure Bot Service skills
Karakter Agentudviklere kan bygge genanvendelige flows, som kan integreres i en hvilken som helst agentsamtale. Udviklere kan oprette, udrulle og være vært for brugerdefinerede færdigheder i deres eget miljø.
Samtaletype Brug flows til simple operationer med et enkelt skift. Du kan f.eks. afgive en ordre eller hente ordrestatus. Brug Azure Bot Service-færdigheder til komplekse operationer med flere omgange. Du kan f.eks. planlægge et møde eller reservere en flybillet.
Svar Brug flows til at sende et agentsvar. Du kan f.eks. vise en personlig meddelelse eller indbyggede billeder. Brug Azure Bot Service-færdigheder til at sende et hvilket som helst understøttet agentsvar. Du kan f.eks. vise et tilpasset kort eller sende tilfældige svar.
Actions Brug flows til at udløse en handling med et enkelt skift på serversiden. Du kan f.eks. kalde en HTTP API eller udløse en brugerdefineret connector. Brug Azure Bot Service skills til at udløse server- og klientside-events og handlinger. Du kan f.eks. navigere til en side som følge af agentsvaret.

Konfigurér en Azure Bot Service skill

Først skal du bruge Copilot Studio til at oprette en agent og oprette og implementere en Azure Bot Service skill ved hjælp af pro-code-værktøjer i din organisation. Se disse eksempler:

Før du registrerer Azure Bot Service-færdigheden, giv agent-ID'et til din færdighedsudvikler, så de kan give agenten tilladelse til at kalde handlinger i færdigheden. Lær mere om tilladelseslisten for en Azure Bot Service skill. Du kan få dit agent-ID fra vinduet Tilføj en færdighed .

Sådan tilføjer du en Azure Bot Service-færdighed til din agent:

  1. Gå til din agent.

  2. Vælg Indstillinger>Færdigheder.

  3. Vælg Tilføj en færdighed.

  4. Kopiér dit agent-id. Du skal give agent-ID'et til din skill-udvikler.

  5. Indtast URL'en til Azure Bot Service færdighedsmanifest. En færdighedsmanifest indeholder den information, som din agent har brug for for at udløse handlinger inden for færdigheden.

  6. Vælg Næste for at starte valideringsprocessen. Når valideringen lykkes, tilføjes din skill til din agent. Du kan nu bruge denne færdighed i dine emner.

Overvejelser vedrørende overholdelse af angivne standarder

For at beskytte brugerens privatliv skal du registrere en Azure Bot Service skill som en app i den indloggede brugers Microsoft Entra ID-tenant.

Fejlfinding af fejl under registrering af Azure Bot Service-færdigheder

Systemet kører en række valideringskontroller i forhold til URL-adressen. Disse kontroller sikrer overholdelse, styring og brugervenlighed af den skill, du tilføjer til din agent. Du skal rette disse fejl, før du registrerer en Azure Bot Service skill.

Fejlmeddelelse Lokalisering af fejl/afhjælpning
Vi stødte på problemer med at få færdighedsmanifestet.
(MANIFEST_FETCH_FAILED)		 Prøv at åbne manifestets URL-adresse i en webbrowser. Hvis URL-adressen gengiver siden inden for 10 sekunder, skal du registrere din færdighed igen.
Manifestet er ikke kompatibelt.
(MANIFEST_MALFORMED)		 (a) Kontrollér, om manifestet er en gyldig JSON-fil.
(b) Tjekke om manifestet indeholder de nødvendige egenskaber
For eksempel, (name, msaAppId, enkeltendpoint, activities/id, activities/description,activities/type (kun event eller message understøttet)).
Der er en uoverensstemmelse i dine endpoints
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Kontrollér, om dit færdighedsslutpunkt stemmer overens med feltet Microsoft Entra ID programregistrerings Publisher domain (foretrukket) eller Home page URL. Få mere at vide om, hvordan du indstiller startsiden for slutpunkter.
For at tilføje en færdighed skal den først registreres
(APPID_NOT_IN_TENANT)		 Kontrollér, om dine færdigheders program-id er registreret i organisationens Microsoft Entra ID lejer.
Forbindelsen er ikke gyldig; Forbindelsen skal begynde med https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Rediger linket for at tilføje en sikker URL-adresse.
Manifestet er for stort;
(MANIFEST_TOO_LARGE)		 Kontrollér størrelsen på manifestet. Det skal være mindre end eller lig med 500 KB.
Denne færdighed er allerede tilføjet til din agent.
(MANIFEST_ALREADY_IMPORTED)		 Slet færdigheden, og prøv at udføre registreringen igen.
Færdigheden må højst indeholde 100 handlinger.
(LIMITS_TOO_MANY_ACTIONS)		 Der er angivet for mange færdighedshandlinger i færdighedsmanifestet. Fjern handlinger, og prøv igen.
Handlinger er begrænset til 25 input.
(LIMITS_TOO_MANY_INPUTS)		 Der er for mange inputparametre for færdighedshandlinger. Fjern parametre, og prøv igen.
Handlinger er begrænset til 25 output.
(LIMITS_TOO_MANY_OUTPUTS)		 Der er for mange outputparametre for færdighedshandlinger. Fjern parametre, og prøv igen.
Din agent kan højst have 100 færdigheder.
(LIMITS_TOO_MANY_SKILLS)		 Der er tilføjet for mange færdigheder for en agent. Fjern en eksisterende færdighed, og prøv igen.
Det ser ud til, at noget gik galt.
(AADERROR_OTHER)		 Der opstod en midlertidig fejl under valideringen af din færdighed. Prøv igen.
Noget gik galt under kontrollen af din færdighed.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 Kontrollér, om din færdigheds slutpunkt er online og reagerer på meddelelser. Kontrollér også, at appregistreringen for den enkelte lejerfærdighed er udrullet til den samme lejer.
Denne færdighed tillod ikke, at din agent blev angivet
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Tjek, om din agent er tilføjet til færdighedens tilladelsesliste.
  • Sidst opdateret den