Implementace dovednosti pro použití v Power Virtual Agents
PLATÍ PRO: SDK v4
Dovednost je robot, který může používat jiný robot. Tímto způsobem můžete vytvořit jednoho uživatelem orientovaného robota a rozšířit ho o jednu nebo více dovedností. Další informace o dovednostech obecně najdete v přehledu dovedností a o tom, jak je vytvořit v implementaci dovednosti. Šablony virtuálního asistenta také obsahují sadu předem připravených dovedností , které si můžete přizpůsobit a nasadit místo toho, abyste vytvářeli úplně od začátku.
Pokud očekáváte, že vaše dovednost bude spotřebována z robota Power Virtual Agents , existují určitá další omezení týkající se vaší dovednosti, pro kterou budete muset počítat.
Omezení manifestu
Power Virtual Agents umisťuje omezení toho, co můžete deklarovat v manifestu dovedností.
- Můžete deklarovat pouze 100 nebo méně akcí.
- Každá akce je omezená na 25 nebo méně vstupů nebo výstupů.
- Typ pole nemůžete použít pro vstupy nebo výstupy.
Omezení stejného tenanta
Aby se zajistilo dodržování předpisů a odpovídající zásady správného řízení vlastních dovedností zaregistrovaných pro použití v rámci Power Virtual Agents, musí být robot dovedností zaregistrovanou aplikací v Microsoft Entra ID. Po přidání dovednosti ověříme, jestli JE ID aplikace dovednosti v tenantovi přihlášeného uživatele a koncový bod dovedností odpovídá zaregistrované aplikaci Home Page URL.
Než budete moct robota zaregistrovat jako dovednost v rámci power virtual agents, musíte zajistit, aby se pro robota na domovské stránce na webu Azure Portal nastavil adresa URL manifestu dovedností robota.
Ověření provedené při registraci dovednosti
Když se koncový uživatel pokusí připojit k vaší dovednosti z robota Power Virtual Agents, bude nejprve muset naimportovat dovednosti do Power Virtual Agents. Vaše dovednost projde řadou ověřovacích kontrol. Selhání jedné z těchto kontrol může mít za následek chybovou zprávu popsanou v této tabulce.
| Krok ověření | Kód chyby | Error message | Popis nebo zmírnění rizik |
|---|---|---|---|
| Adresa URL manifestu je platná. | URL_MALFORMED, URL_NOT_HTTPS |
Odkaz není platný; Odkaz musí začínat https:// | Tento odkaz zadejte znovu jako zabezpečenou adresu URL. |
| Manifest je možné načíst | MANIFEST_FETCH_FAILED |
Narazili jsme na problémy se získáním manifestu dovednosti. | Ověřte, že adresa URL manifestu je odkazem na váš manifest; zkuste otevřít adresu URL manifestu ve webovém prohlížeči. Pokud URL vykreslí stránku do 10 sekund, znovu zaregistrujte svou dovednost. |
| Manifest je čitelný. | MANIFEST_TOO_LARGE |
Manifest je příliš velký. | Manifest musí být 500 kB nebo menší. |
| Manifest je čitelný. | MANIFEST_MALFORMED |
Tento manifest je nekompatibilní. | Zkontrolujte, jestli je manifest platným souborem JSON. Zkontrolujte, jestli manifest obsahuje požadované vlastnosti, například name, msaAppIdatd. Další informace najdete v tématu Omezení manifestu. |
| Dovednost ještě není zaregistrovaná | MANIFEST_ALREADY_IMPORTED |
Tato dovednost už byla k robotovi přidána. | Odstraňte dovednost a znovu ji zaregistrujte. |
| Shoda koncových bodů manifestu a domén domovské stránky | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
V koncových bodech dovedností došlo k neshodě. | Doména adresy URL domovské stránky aplikace Microsoft Entra ID a doména adresy URL manifestu se musí shodovat. Zobrazit omezení stejného tenanta |
| Dovednost je hostovaná v přihlášeném tenantovi uživatele. | APPID_NOT_IN_TENANT |
Pokud chcete přidat dovednost, musí být nejprve zaregistrována. | Globální správce musí zaregistrovat dovednost do přihlášené organizace uživatele. |
| Akce jsou omezené | LIMITS_TOO_MANY_ACTIONS |
Tato dovednost je omezena na 100 akcí. | V manifestu dovedností je definováno příliš mnoho akcí dovedností. Odstraňte akce a zkuste to znovu. |
| Vstupní parametry akce jsou omezené. | LIMITS_TOO_MANY_INPUTS |
Akce jsou omezeny na 25 vstupů. | Existuje příliš mnoho vstupních parametrů akce dovednosti. Odstraňte parametry a zkuste to znovu. |
| Výstupní parametry akce jsou omezené. | LIMITS_TOO_MANY_OUTPUTS |
Akce jsou omezeny na 25 výstupů. | Existuje příliš mnoho výstupních parametrů akce dovednosti. Odeberte parametr a zkuste to znovu. |
| Počet dovedností je omezený. | LIMITS_TOO_MANY_SKILLS |
Robot může mít maximálně 25 dovedností. | Do robota je přidáno příliš mnoho dovedností. Odstraňte existující dovednost a zkuste to znovu. |
| Token zabezpečení je platný. | AADERROR_OTHER |
Vypadá to, že se něco nepovedlo. | K získání tokenu zabezpečení pro aktivaci dovednosti může dojít k přechodné chybě. Zkuste naimportovat dovednosti znovu. |
| Dovednost je zdravá | ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
Při kontrole dovednosti došlo k nějakému problému. | Power Virtual Agents obdrželi neznámou odpověď při odesílání EndOfConversation aktivity vaší dovednosti. Ujistěte se, že vaše dovednost běží a správně reaguje. |
| Dovednost je oprávněná | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
Tato dovednost nepovolila vašeho robota. | Zkontrolujte, jestli byl robot přidaný do seznamu povolených dovedností. Další informace najdete v tématu Power Virtual Agents, jak nakonfigurovat dovednosti. |