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

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.

Převod existující dovednosti z víceklientských na jednoho tenanta

Stávající dovednosti můžete převést z podpory více tenantů na podporu s jedním tenantem. Pokud chcete převést víceklientských dovedností na dovednosti s jedním tenantem, musíte provést následující změny:

• Vytvoření nové registrace aplikace Entra ID s jedním tenantem
• Aktualizace konfigurace dovedností tak, aby používala jednoho tenanta
• Nasazení dovednosti
• (Volitelné) Aktualizace zdrojového kódu

Pro dovednosti s jedním tenantem se vyžadují následující hodnoty:

Vlastnost	Hodnota
MicrosoftAppType	SingleTenant
MicrosoftAppId	ID aplikace robota
MicrosoftAppPassword	Heslo aplikace robota
MicrosoftAppTenantId	ID tenanta aplikace robota

Pro referenci byly použity následující hodnoty pro víceklientských dovedností:

Vlastnost	Hodnota
MicrosoftAppType	MultiTenant
MicrosoftAppId	ID aplikace robota
MicrosoftAppPassword	Heslo aplikace robota
MicrosoftAppTenantId	Nelze použít; pro roboty s více tenanty je ponecháno prázdné.

Po převodu hodnot naimportujte dovednost do instance vašeho agenta vytvořeného jako instance s jedním tenantem. Můžete si také prohlédnout registraci aplikace Entra ID a podívat se, jak byla vytvořena. Přejděte na Spravovat>ověřování>podporované typy účtů.

Aktualizace kódu s více tenanty na jednoho tenanta

Po převodu hodnot možná budete muset aktualizovat kód tak, aby umožňoval připojení zadaného tenanta ke dovednostem. Další informace najdete v tématu BotBuilder-Samples.

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 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.