Del via

Konfigurer færdigheder til brug i Copilot Studio-agenter

med Copilot Studio kan du udvide din agent ved hjælp af skills. Hvis du allerede har agenter, der er bygget og udrullet i din organisation (ved hjælp af Microsoft 365 Agents SDK eller andre prokodeværktøjer) til bestemte scenarier, kan du konvertere disse robotter til en færdighed og registrere denne færdighed i en Copilot Studio-agent.

Bemærk

Hvis du vil tilføje en færdighed i Copilot Studio-appen i Microsoft Teams, skal du have et Microsoft Copilot Studio separat abonnement.

Denne artikel henvender sig til systemadministratorer eller IT-medarbejdere, der kender dine -færdigheder.

Når du registrerer en færdighed med en Copilot Studio-agent, kan du uden problemer trigger-kompetencehandlinger i samtalen.

Forudsætninger

Vigtigt

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

Hvis du vil konfigurere en færdighed, skal du angive den tilknyttede appregistrering i Microsoft Entra ID for dine færdigheder til konfiguration med en enkelt lejer.

Hvornår skal du bruge agentflows i forhold til færdigheder?

I følgende tabel får du hjælp til at bestemme, hvornår du skal bruge agentflows eller færdigheder i en samtale.

Faktor Hvornår man skal bruge agentstrømme Hvornår man skal bruge færdigheder
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 af færdigheder i forbindelse med komplekse handlinger med flere skift. 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 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.
Handlinger 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 færdigheder til at udløse hændelser og handlinger på serversiden og klientsiden. Du kan f.eks. navigere til en side som følge af agentsvaret.

Konfigurere en -færdighed

Brug først Copilot Studio til at opret en agent og opret og udrul en færdighed ved hjælp af prokodeværktøjer i din organisation. Se disse eksempler:

Før du registrerer færdigheden, skal du oplyse udvikleren af dine færdigheder om agentens id for at autorisere agenten til at kalde handlinger i færdigheden. Lær mere om tilladelseslisten for en færdighed. Du kan få din agents id fra vinduet Tilføj en færdighed.

Føj en færdighed til din agent:

  1. Gå til din agent.

  2. Vælg Indstillinger>Færdigheder for at gå til siden Færdigheder.

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

  4. Kopiér dit agent-id. Du skal angive agent-id'et til udvikleren af dine færdigheder.

  5. Angiv URL-adressen for færdighedsmanifestet. Et færdighedsmanifest indeholder de oplysninger, som din agent skal bruge for at udløse handlinger i en færdighed.

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

Overvejelser vedrørende overholdelse af angivne standarder

For at beskytte brugerens personlige oplysninger kræver vi, at færdigheder registreres som en app i den bruger, der er logget på, Microsoft Entra ID lejer.

Foretag fejlfinding i forbindelse med registrering af færdigheder

Der foretages en række valideringskontroller i forhold til URL-adressen. Disse kontroller sikrer, at den færdighed, der tilføjes din agent, overholder angivne standarder, styring og er brugervenlige. Du skal rette disse fejl, før du registrerer en færdighed.

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 har ikke godkendt din agent på godkendelseslisten
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Kontrollér, om din agent er blevet tilføjet til tilladelseslisten for færdigheden.
  • Last updated on