Vaardigheden configureren voor gebruik in Copilot Studio-agents

Met Copilot Studio kunt u uw agent uitbreiden met behulp van vaardigheden. Als u al agents hebt gebouwd en geïmplementeerd in uw organisatie (met behulp van de SDK voor Microsoft 365-agenten of andere hulpprogramma's voor procode) voor specifieke scenario's, kunt u deze bots converteren naar een vaardigheid en die vaardigheid registreren in een Copilot Studio-agent.

Opmerking

Als u een vaardigheid wilt toevoegen vanuit de Copilot Studio-app in Microsoft Teams, moet u beschikken over een Microsoft Copilot Studio zelfstandig abonnement.

Dit artikel is bedoeld voor systeembeheerders of IT-professionals die bekend zijn met vaardigheden.

Zodra u een vaardigheid hebt geregistreerd met een Copilot Studio-agent, kunt u naadloos vaardigheidsacties in het gesprek activeren.

Vereiste voorwaarden

Belangrijk

Copilot Studio-agents ondersteunen alleen vaardigheden die zijn gebouwd met Legacy Bot Framework SDK versie 4.12.0+ en SDK voor Microsoft 365-agenten v1.0.0+. Er moeten nieuwe vaardigheden worden gebouwd met behulp van de SDK voor Microsoft 365-agenten.

Als u een vaardigheid wilt configureren, stelt u de bijbehorende app-registratie in Microsoft Entra ID voor uw vaardigheid in op configuratie met één tenant.

Wanneer moet u agentstromen of vaardigheden gebruiken

In de volgende tabel kunt u bepalen wanneer u agentstromen of vaardigheden voor een gesprek moet gebruiken.

Factor Wanneer agentstromen te gebruiken Wanneer je vaardigheden moet gebruiken
Persona Agent-auteurs kunnen herbruikbare flows maken om in elke agentconversatie in te sluiten. Ontwikkelaars kunnen aangepaste vaardigheden maken, implementeren en hosten in hun eigen omgeving.
Gesprekstype Gebruik flows voor eenvoudige, enkelvoudige bewerkingen. Voorbeelden hiervan zijn een bestelling plaatsen of de orderstatus ontvangen. Gebruik vaardigheden voor complexe, meerfasige operaties. Voorbeelden hiervan zijn het plannen van een vergadering of het boeken van een vlucht.
Antwoord Gebruik stromen om een agentreactie uit te zenden. Laat bijvoorbeeld een persoonlijk bericht of inline afbeeldingen zien. Gebruik vaardigheden om elke ondersteunde agentreactie uit te zenden. Laat bijvoorbeeld een adaptieve kaart zien of stuur willekeurige reacties.
Acties Gebruik stromen om enkelvoudige acties op de server te activeren. Roep bijvoorbeeld een HTTP-API aan of activeer een aangepaste connector. Gebruik vaardigheden om gebeurtenissen en acties op de server en client te activeren. Navigeer bijvoorbeeld naar een pagina na een agentrespons.

Een vaardigheid configureren

Gebruik eerst Copilot Studio om een agent te maken en een vaardigheid te creëren en te implementeren met behulp van professionele coderingstools binnen uw organisatie. Raadpleeg deze voorbeelden:

Voordat u de vaardigheid registreert, geeft u het ID van de agent aan uw vaardigheden ontwikkelaar op om de agent te machtigen om acties aan te roepen in de vaardigheid. Lees meer over de toelaatlijst voor een vaardigheid. U kunt de id van uw agent vinden in het venster Een vaardigheid toevoegen.

Een vaardigheid toevoegen aan uw agent:

  1. Ga naar uw agent.

  2. Selecteer Instellingen>Vaardigheden om naar de pagina Vaardigheden te gaan.

  3. Selecteer Een vaardigheid toevoegen.

  4. Kopieer uw agent-id. U moet de agent-id opgeven voor uw vaardighedenontwikkelaar.

  5. Voer de URL naar het vaardigheidsmanifest in. Het manifest van een vaardigheid bevat de informatie die uw agent nodig heeft om acties binnen een vaardigheid te activeren.

  6. Selecteer Volgende om het validatieproces te starten. Zodra de validatie succesvol is, wordt uw vaardigheid aan uw agent toegevoegd. U kunt deze vaardigheid nu gebruiken in uw onderwerpen.

Overwegingen voor de naleving

Om de privacy van gebruikers te beschermen, moeten we vaardigheden registreren als een app in de Microsoft Entra ID tenant van de aangemelde gebruiker.

Problemen oplossen die zich voordoen tijdens de registratie van vaardigheden

Het systeem voert een reeks validatiecontroles uit op basis van de URL. Deze controles zorgen voor naleving, governance en bruikbaarheid van de vaardigheid die u toevoegt aan uw agent. U moet deze fouten oplossen voordat u een vaardigheid registreert.

Foutbericht Problemen oplossen/beperken
We kregen problemen met het verkrijgen van het vaardigheidsmanifest.
(MANIFEST_FETCH_FAILED)		 Probeer uw manifest-URL te openen in een webbrowser. Als de URL de pagina binnen 10 seconden weergeeft, registreert u uw vaardigheid opnieuw.
Het manifest is niet compatibel.
(MANIFEST_MALFORMED)		 (a) Controleer of het manifest een geldig JSON-bestand is.
(b) Controleer of het manifest de vereiste eigenschappen bevat
Bijvoorbeeld, (name, msaAppId, enkel endpoint, activities/id, activities/description,activities/type (alleen event of message ondersteund)).
Er is een mismatch tussen je eindpunten
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Controleer of uw vaardigheidseindpunt overeenkomt met het veld Publisher domain (voorkeur) of Home page URL van uw toepassingregistratie in Microsoft Entra ID. Meer informatie over het instellen van de startpagina voor eindpunten.
Om een vaardigheid toe te voegen, moet deze eerst geregistreerd worden
(APPID_NOT_IN_TENANT)		 Controleer of de toepassings-id van uw vaardigheid is geregistreerd in de Microsoft Entra ID tenant van uw organisatie.
De link is niet geldig; De link moet beginnen met https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Wijzig de koppeling om een beveiligde URL toe te voegen.
De manifest is te groot;
(MANIFEST_TOO_LARGE)		 Controleer de grootte van het manifest. Het moet kleiner dan of gelijk zijn aan 500 KB.
Deze vaardigheid is al aan uw agent toegevoegd.
(MANIFEST_ALREADY_IMPORTED)		 Verwijder de vaardigheid en probeer deze opnieuw te registreren.
De vaardigheid mag maximaal 100 acties omvatten.
(LIMITS_TOO_MANY_ACTIONS)		 Er zijn te veel vaardigheidsacties gedefinieerd in het vaardigheidsmanifest. Verwijder acties en probeer het opnieuw.
Acties zijn beperkt tot 25 invoerparameters.
(LIMITS_TOO_MANY_INPUTS)		 Er zijn te veel invoerparameters voor vaardigheidsacties. Verwijder parameters en probeer het opnieuw.
Acties zijn beperkt tot 25 uitvoerparameters.
(LIMITS_TOO_MANY_OUTPUTS)		 Er zijn te veel uitvoerparameters voor vaardigheidsacties. Verwijder parameters en probeer het opnieuw.
Uw agent kan maximaal 100 vaardigheden bevatten.
(LIMITS_TOO_MANY_SKILLS)		 Er zijn te veel vaardigheden toegevoegd aan een agent. Verwijder een bestaande vaardigheid en probeer het opnieuw.
Het lijkt erop dat er iets mis is gegaan.
(AADERROR_OTHER)		 Er is een tijdelijke fout opgetreden bij het valideren van uw vaardigheid. Probeer het opnieuw.
Er is een fout opgetreden bij het controleren van uw vaardigheid.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 Controleer of uw vaardigheidseindpunt online is en reageert op berichten. Controleer ook of de app-registratie van de vaardigheid voor één tenant op dezelfde tenant is geïmplementeerd.
Deze vaardigheid heeft je agent niet op de lijst gezet
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Controleer of uw agent is toegevoegd aan de acceptatielijst van de vaardigheid.
  • Last updated on