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.

Omezení s jedním tenantem a více tenanty

Copilot Studio dříve vytvořilo víceklientové aplikace Entra ID. Teď ale vytváří aplikace Entra ID s jedním tenantem. Aby dovednosti správně fungovaly s agenty na základě nových aplikací Entra ID s jedním tenantem, musí být dovednosti nakonfigurované pro instanci s jedním tenantem. Další informace najdete v tématu Převod existující dovednosti z víceklientských na jednoklientských nebo Aktualizace víceklientských dovedností na dovednosti s jedním tenantem.

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. 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 registrace aplikace s jednou tenantkou byla nasazena do stejného tenanta, ve kterém byl agent vytvořen.
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.