Een Bot Framework-vaardigheid configureren voor gebruik in Copilot Studio
Belangrijk
Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.
Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.
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
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:
Vouw in het navigatiedeelvenster de optie Instellingen uit en selecteer vervolgens Vaardigheden.
Selecteer boven aan de pagina Vaardigheden de optie Vaardigheid toevoegen.
Kopieer de copilot-id en geef die door aan uw vaardighedenontwikkelaar.
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.
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. |
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor