Sdílet prostřednictvím

Implementace dovednosti pro použití v nástroji Copilot Studio

  • Článek

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 copilot Studia Copilot Studio , existují některá další omezení týkající se vaší dovednosti, pro kterou musíte počítat.

Omezení manifestu

Copilot Studio omezuje, 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 nástroji Copilot Studio, 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 nástroji Copilot Studio, musíte zajistit, aby byla domovská stránka na webu Azure Portal nastavená na adresu URL manifestu dovedností robota.

Ověření provedené při registraci dovednosti

Když se koncový uživatel pokusí připojit k vaší dovednosti ze svého copilotu, bude nejprve muset naimportovat dovednost do copilot Studia. Vaše dovednost prochází řadou ověřovacích kontrol. Selhání jedné z těchto kontrol může vést k chybové zprávě, jak je popsáno v této tabulce.

Krok ověření Kód chyby Chybová zpráva Popis nebo zmírnění rizik
Adresa URL manifestu je platná. URL_MALFORMED, URL_NOT_HTTPS Odkaz není platný; Odkaz musí začínat https:// Znovu zadejte odkaz 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. Aplikace Copilot Studio obdržela při odesílání EndOfConversation aktivity vaší dovednosti neznámou odpověď. 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 je váš robot v seznamu povolených dovedností. Další informace najdete v nástroji Copilot Studio, jak nakonfigurovat dovednost.