Een Bot Framework-vaardigheid configureren voor gebruik in Copilot Studio

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

Opmerking

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-copilot, kunnen auteurs naadloos vaardigheidsacties activeren in een gesprek.

Vereisten

• Beperkingen en validatie beoordelen voor vaardigheden die worden gebruikt in Copilot Studio

Belangrijk

Copilot Studio-copilots 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-copilot wilt gebruiken, migreert u deze eerst naar Composer 2.x voordat u deze als vaardigheid gebruikt.

Om een vaardigheid te configureren, moet de bijbehorende app-registratie in Microsoft Entra ID voor uw vaardigheid worden ingesteld op Configuratie voor meerdere tenants.

Stroomacties en vaardigheidsacties

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

	Stroomacties	Vaardigheidsacties
Persona	Copilot-auteurs kunnen herbruikbare stromen maken om in elk copilotgesprek 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 copilotreactie uit te zenden. Laat bijvoorbeeld een persoonlijk bericht of inline afbeeldingen zien.	Gebruik vaardigheden om elke ondersteunde copilotreactie 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 copilot-respons.

Een vaardigheid configureren

Gebruik eerst Copilot Studio om een copilot te maken en een vaardigheid te maken en implementeren met pro-codetools in uw organisatie.

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

Een vaardigheid toevoegen aan uw copilot:

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 copilot-id en geef die door aan uw vaardighedenontwikkelaar.

   

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

5. Selecteer Volgende om het validatieproces te starten. Zodra de validatie is gelukt, wordt uw vaardigheid toegevoegd aan uw copilot. 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 copilot 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 copilot 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 copilot kan maximaal 100 vaardigheden bevatten. (LIMITS_TOO_MANY_SKILLS)	Er zijn te veel vaardigheden toegevoegd aan een copilot. 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 copilot niet geaccepteerd (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Controleer of uw copilot is toegevoegd aan de acceptatielijst van de vaardigheid.