Share via

Een vaardigheid implementeren voor gebruik in Power Virtual Agents

  • 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 gebouwde vaardigheden bevatten die u kunt aanpassen en implementeren in plaats van een volledig nieuwe vaardigheden te bouwen.

Als u verwacht dat uw vaardigheid wordt verbruikt vanuit een Power Virtual Agents-bot , zijn er enkele aanvullende beperkingen voor uw vaardigheid waarvoor u rekening moet houden.

Manifestbeperkingen

Power Virtual Agents stelt beperkingen in voor wat u in uw vaardigheidsmanifest kunt declareren.

  • 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 voldoende governance van aangepaste vaardigheden worden geregistreerd voor gebruik in Power Virtual Agents, 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 de tenant van de aangemelde gebruiker is en het eindpunt voor vaardigheden overeenkomt met de geregistreerde toepassing Home Page URL.

Voordat u uw bot kunt registreren als vaardigheid in Power Virtual Agents, 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 probeert verbinding te maken met uw vaardigheid vanuit hun Power Virtual Agents-bot, moet deze eerst de vaardigheid importeren in Power Virtual Agents. 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 Foutbericht 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 veilige 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 globale 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. Power Virtual Agents 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 toegevoegd aan de acceptatielijst van de vaardigheid. Zie de Power Virtual Agents voor meer informatie over het configureren van een vaardigheid.