Lezen in het Engels

Delen via

Een Bot Framework-vaardigheid configureren voor gebruik in Copilot Studio

  • Artikel

Met Copilot Studio kunt u uw agent uitbreiden met Bot Framework-vaardigheden. Als u al bots in uw organisatie hebt gebouwd en geïmplementeerd (met de Bot Framework SDK en pro-codetools) voor specifieke scenario's, kunt u die bots omzetten in een vaardigheid en die vaardigheid registreren in een Copilot Studio-agent.

Notitie

Om een vaardigheid toe te voegen vanuit de Copilot Studio-app in Microsoft Teams, moet u een zelfstandig Microsoft Copilot Studio-abonnement hebben.

Dit artikel is bedoeld voor systeembeheerders of IT-professionals die bekend zijn met Bot Framework-vaardigheden. Nadat een vaardigheid is geregistreerd bij een Copilot Studio-agent, kunnen auteurs naadloos vaardigheidsacties activeren in een gesprek.

Vereisten

Belangrijk

Copilot Studio-agenten ondersteunen alleen vaardigheden die zijn ontwikkeld met behulp van Bot Framework SDK versie 4.12.0+.

Klassieke chatbots ondersteunen alleen vaardigheden die zijn ontwikkeld met behulp van Bot Framework SDK versie 4.7+.

Als u gebruiktmaakt van Bot Framework Composer wordt sterk aanbevolen om Composer 2.x te gebruiken. Als u een bestaande Composer 1.x-agent wilt gebruiken, migreert u deze eerst naar Composer 2.x voordat u deze als vaardigheid gebruikt.

Als u een vaardigheid wilt configureren, moet de gekoppelde app-registratie in Microsoft Entra ID voor uw vaardigheid worden ingesteld op multitenantconfiguratie.

Stroomacties en vaardigheidsacties

Gebruik de volgende tabel om te bepalen wanneer vaardigheden voor een gesprek moeten worden gebruikt.

Stroomacties Vaardigheidsacties
Persona Agentauteurs kunnen herbruikbare stromen maken om in elk agentgesprek in te sluiten. Ontwikkelaars kunnen aangepaste vaardigheden maken, implementeren en hosten in hun eigen omgeving.
Gesprek Gebruik stromen voor enkelvoudige bewerkingen. Voorbeelden hiervan zijn een bestelling plaatsen of de orderstatus ontvangen. Gebruik vaardigheden voor complexe, meervoudige bewerkingen. Voorbeelden hiervan zijn het plannen van een vergadering of het boeken van een vlucht.
De respons 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 Copilot Studio eerst om een agent te maken en maak en implementeer een vaardigheid met pro-codetools in uw organisatie.

Voordat u de vaardigheid registreert, geeft u de agent-id aan uw vaardighedenontwikkelaar op om de agent te machtigen om acties aan te roepen in de vaardigheid. Meer informatie over de acceptatielijst voor vaardigheden. U kunt de id van uw agent vinden in het venster Een vaardigheid toevoegen.

Een vaardigheid toevoegen aan uw agent:

  1. Vouw in het navigatiedeelvenster de optie Instellingen uit en selecteer vervolgens Vaardigheden.

  2. Selecteer boven aan de pagina Vaardigheden de optie Vaardigheid toevoegen.

  3. Kopieer de id van uw agent en geef die door aan uw ontwikkelaar van vaardigheden.

  4. 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.

  5. 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 compliance

Om de privacy van gebruikers te beschermen, vereisen we dat vaardigheden worden geregistreerd als een app in de Microsoft Entra ID-tenant van de aangemelde gebruiker.

Problemen oplossen die zich voordoen tijdens de registratie van vaardigheden

Er wordt een reeks validatiecontroles uitgevoerd op basis van de URL. Deze controles garanderen compliance, governance en bruikbaarheid van de vaardigheid die aan uw agent wordt toegevoegd. U moet deze fouten oplossen voordat u een vaardigheid registreert.

Foutbericht Problemen oplossen/beperken
Er zijn problemen opgetreden bij het ophalen 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, enkele endpoint, activities/id, activities/description, activities/type (alleen event of message wordt ondersteund)).
Er is een discrepantie in uw eindpunten
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Controleer of uw vaardigheidseindpunt overeenkomt met het veld Publisher domain (voorkeur) of Home page URL van uw Microsoft Entra ID-aanmeldingsregistratie. Meer informatie over het instellen van de startpagina voor eindpunten.
Een vaardigheid kan pas worden toegevoegd nadat deze is geregistreerd
(APPID_NOT_IN_TENANT)		 Controleer of de toepassings-id van uw vaardigheid is geregistreerd in de Microsoft Entra ID-tenant van uw organisatie.
De koppeling is niet geldig. De koppeling moet beginnen met https://
(URL_MALFORMED. URL_NOT_HTTPS)		 Voer de koppeling opnieuw in als een veilige URL.
Het 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 is misgegaan.
(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.
Deze vaardigheid heeft uw agent niet geaccepteerd
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Controleer of uw agent is toegevoegd aan de acceptatielijst van de vaardigheid.