Delen via

Een vaardigheid implementeren voor gebruik in Copilot Studio

  • Artikel

VAN TOEPASSING OP: SDK v4

Een vaardigheid is een bot die kan worden gebruikt door een andere bot. Op deze manier kunt u één gebruikersgerichte bot maken en uitbreiden met een of meer vaardigheden. Meer informatie over vaardigheden in het algemeen vindt u in Het overzicht van vaardigheden en hoe u deze kunt bouwen in Een vaardigheid implementeren. U kunt de sjablonen voor virtuele assistenten ook een set vooraf gedefinieerde vaardigheden bevatten die u kunt aanpassen en implementeren in plaats van een geheel nieuwe vaardigheden te maken.

Als u verwacht dat uw vaardigheid wordt verbruikt vanuit een Copilot Studio-copilot , zijn er enkele andere beperkingen voor uw vaardigheid waarvoor u rekening moet houden.

Manifestbeperkingen

Copilot Studio plaatst beperkingen op wat u kunt declareren in uw vaardigheidsmanifest.

  • U kunt slechts 100 of minder acties declareren.
  • Elke actie is beperkt tot 25 of minder invoer- of uitvoerbewerkingen.
  • U kunt het matrixtype niet gebruiken voor invoer of uitvoer.

Beperking voor dezelfde tenant

Om ervoor te zorgen dat naleving en adequaat beheer van aangepaste vaardigheden worden geregistreerd voor gebruik in Copilot Studio, moet uw vaardigheidsbot een geregistreerde toepassing zijn in Microsoft Entra ID. Bij het toevoegen van een vaardigheid valideren we of de toepassings-id van de vaardigheid zich in de tenant van de aangemelde gebruiker bevindt en het eindpunt voor vaardigheden overeenkomt met de geregistreerde toepassing Home Page URL.

Voordat u uw bot kunt registreren als vaardigheid in Copilot Studio, moet u ervoor zorgen dat voor de bot de startpagina in Azure Portal is ingesteld op de manifest-URL voor vaardigheden van de bot.

Validatie uitgevoerd tijdens het registreren van een vaardigheid

Wanneer een eindgebruiker vanuit zijn copilot verbinding probeert te maken met uw vaardigheid, moet deze eerst de vaardigheid importeren in Copilot Studio. Uw vaardigheid doorloopt een reeks validatiecontroles. Een fout bij een van deze controles kan resulteren in een foutbericht zoals beschreven in deze tabel.

Validatiestap Foutcode Foutmelding Beschrijving of beperking
Manifest-URL is geldig URL_MALFORMED, URL_NOT_HTTPS De koppeling is niet geldig. De koppeling moet beginnen met https:// Voer de koppeling opnieuw in als een beveiligde URL.
Manifest kan worden opgehaald MANIFEST_FETCH_FAILED Er zijn problemen opgetreden bij het verkrijgen van het vaardigheidsmanifest. Controleer of uw manifest-URL een koppeling naar uw manifest is; probeer uw manifest-URL te openen in een webbrowser. Als de URL de pagina binnen 10 seconden weergeeft, registreert u uw vaardigheid opnieuw.
Manifest kan worden gelezen MANIFEST_TOO_LARGE Het manifest is te groot. Uw manifest moet 500 kB of minder zijn.
Manifest kan worden gelezen MANIFEST_MALFORMED Het manifest is niet compatibel. Controleer of het manifest een geldig JSON-bestand is. Controleer of het manifest vereiste eigenschappen bevat, zoals name, msaAppIdenzovoort. Zie Manifestbeperkingen voor meer informatie.
Vaardigheid is nog niet geregistreerd MANIFEST_ALREADY_IMPORTED Deze vaardigheid is al aan uw bot toegevoegd. Verwijder de vaardigheid en registreer deze opnieuw.
Manifesteindpunt- en startpaginadomeinen komen overeen MANIFEST_ENDPOINT_ORIGIN_MISMATCH Uw vaardigheidseindpunten komen niet overeen. U moet overeenkomen met het URL-domein van de startpagina van de Microsoft Entra ID-app en het URL-domein van het manifest. Zie Beperking voor dezelfde tenant
Vaardigheid wordt gehost in de tenant van de aangemelde gebruiker APPID_NOT_IN_TENANT Als u een vaardigheid wilt toevoegen, moet deze eerst worden geregistreerd. Een beheerder moet de vaardigheid registreren bij de organisatie van de aangemelde gebruiker.
Acties zijn beperkt LIMITS_TOO_MANY_ACTIONS De vaardigheid mag maximaal 100 acties omvatten. Er zijn te veel vaardigheidsacties gedefinieerd in het vaardigheidsmanifest. Verwijder acties en probeer het opnieuw.
Parameters voor actie-invoer zijn beperkt LIMITS_TOO_MANY_INPUTS Acties zijn beperkt tot 25 invoerparameters. Er zijn te veel invoerparameters voor vaardigheidsacties. Verwijder parameters en probeer het opnieuw.
Uitvoerparameters voor acties zijn beperkt LIMITS_TOO_MANY_OUTPUTS Acties zijn beperkt tot 25 uitvoerparameters. Er zijn te veel uitvoerparameters voor vaardigheidsacties. Verwijder de parameter en probeer het opnieuw.
Aantal vaardigheden is beperkt LIMITS_TOO_MANY_SKILLS Uw bot kan maximaal 25 vaardigheden hebben. Er zijn te veel vaardigheden toegevoegd aan een bot. Verwijder een bestaande vaardigheid en probeer het opnieuw.
Het beveiligingstoken is geldig AADERROR_OTHER Het lijkt erop dat er iets mis is gegaan. Er is mogelijk een tijdelijke fout opgetreden bij het verkrijgen van een beveiligingstoken om de vaardigheid te activeren. Probeer de vaardigheid opnieuw te importeren.
Vaardigheid is gezond ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Er is een fout opgetreden bij het controleren van uw vaardigheid. Copilot Studio heeft een onbekend antwoord ontvangen bij het verzenden van een EndOfConversation activiteit naar uw vaardigheid. Zorg ervoor dat uw vaardigheid wordt uitgevoerd en correct reageert.
Vaardigheid is geautoriseerd ENDPOINT_HEALTHCHECK_UNAUTHORIZED Deze vaardigheid heeft uw bot niet toegestaan. Controleer of uw bot is gekoppeld aan de acceptatielijst van de vaardigheid. Zie copilot Studio voor meer informatie over het configureren van een vaardigheid.