Konfigurace dovednosti Bot Framework pro použití v Copilot Studio

Copilot Studio umožňuje rozšířit agenta pomocí dovedností Bot Framework. Pokud jste již ve své organizaci vytvořili a nasadili roboty (pomocí nástrojů SDK Bot Framework a profesionální psaní kódu) pro konkrétní scénáře, můžete převést tyto roboty na dovednosti a zaregistrovat dovednost v agentu Copilot Studio.

Poznámka:

Chcete-li přidat dovednost zevnitř aplikace Copilot Studio v Microsoft Teams, potřebujete samostatné předplatné Microsoft Copilot Studio.

Tento článek je určen pro systémové administrátory nebo IT odborníky, kteří jsou obeznámeni s dovednostmi Bot Framework. Poté, co byla dovednost zaregistrována u agenta Copilot Studio, autoři mohou bez problémů spouštět akce dovedností v konverzaci.

Předpoklady

• Kontrola omezení a ověření dovedností používaných v Copilot Studio

Důležité

Agenti Copilot Studio podporují pouze dovednosti vytvořené pomocí Bot Framework SDK verze 4.12.0+.

Klasičtí chatboti podporují pouze dovednosti vytvořené pomocí Bot Framework SDK version 4.7+.

Pokud používáte Bot Framework Composer, důrazně se doporučuje používat Composer 2.x. Pokud chcete použít existujícího agenta Composer 1.x, nejprve ho migrujte do Composer 2.x, než ho použijete jako dovednost.

Pokud chcete nakonfigurovat dovednost, přidružená registrace aplikace v Microsoft Entra ID pro vaši dovednost by měla být nastavená na konfiguraci pro více tenantů.

Toky akcí a akcí dovedností

Následující tabulka vám pomůže určit, kdy použít dovednosti pro konverzaci.

	Akce toku	Akce dovednosti
Osoba	Autoři agentů mohou vytvářet opakovaně použitelné toky, které lze vložit do jakékoli konverzace s agenty.	Vývojáři mohou vytvářet, nasazovat a hostovat vlastní dovednosti ve svém vlastním prostředí.
Konverzace	Použijte toky pro jednoduché operace s jedním opakováním. Například zadání objednávky nebo zjištění stavu objednávky.	Používejte dovednosti pro složité operace s více opakováními. Například naplánování schůzky nebo rezervace letu.
Reakce	Použijte toky k odeslání odpovědi agenta. Zobrazte například personalizovanou zprávu nebo vložené obrázky.	Použijte dovednosti k odeslání jakékoli podporované odpovědi agenta. Například ukažte adaptivní kartu nebo posílejte náhodné odpovědi.
Akce	Pomocí toků spouštějte akce jedním opakováním na straně serveru. Například zavolejte HTTP API nebo aktivujte vlastní konektor.	Použijte dovednosti ke spouštění událostí a akcí na straně serveru a na straně klienta. Například přejděte na stránku po odpovědi agenta.

Konfigurace dovednosti

Nejdříve použijte Copilot Studio k vytvoření agenta a vytvořte a nasaďte dovednost pomocí nástrojů pro psaní kódu do vaší organizace.

Před registrací dovednosti poskytněte svému vývojáři dovedností ID agenta, aby agenta autorizoval k vyvolání akcí v dovednosti. Další informace o seznamu povolených dovedností. ID svého agenta můžete získat z okna Přidat dovednost.

Přidání dovednosti do agenta:

1. V navigačním podokně rozbalte Nastavení a vyberte Dovednosti.

2. V horní části stránky Dovedností vyberte Přidat dovednost.

3. Zkopírujte si ID svého agenta a poskytněte ho svému vývojáři dovedností.

4. Zadejte adresu URL manifestu dovednosti. Manifest dovednosti obsahuje informace, které bude váš agent potřebovat ke spuštění akcí v rámci dovednosti.

5. Tlačítkem Další spusťte proces ověření. Jakmile je ověření úspěšné, vaše dovednost se přidá k vašemu agentovi. Teď můžete použít tuto dovednost ve svých tématech.

Úvahy o dodržování předpisů

Abychom chránili osobní údaje uživatelů, vyžadujeme, aby byly dovednosti zaregistrovány jako aplikace u tenanta Microsoft Entra ID přihlášeného uživatele.

Odstraňování problémů při registraci dovedností

U adresy URL se provádí řada ověřovacích kontrol. Tyto kontroly zajišťují shodu, správu a použitelnost dovednosti přidávané do vašeho agenta. Před registrací dovednosti budete muset tyto chyby opravit.

Chybová zpráva	Řešení/zmírnění problému
Při získávání manifestu dovednosti došlo k problému. (MANIFEST_FETCH_FAILED)	Zkuste otevřít adresu URL manifestu ve webovém prohlížeči. Pokud URL vykreslí stránku do 10 sekund, znovu zaregistrujte svou dovednost.
Tento manifest je nekompatibilní. (MANIFEST_MALFORMED)	(a) Zkontrolujte, zda je manifest platným souborem JSON. (b) Zkontrolujte, zda manifest obsahuje požadované vlastnosti Například (name, msaAppId, jeden endpoint, activities/id, activities/description, activities/type (podporováno pouze event nebo message)).
Neshoda v koncových bodech (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Zkontrolujte, zda koncový bod dovednosti odpovídá poli Publisher domain (preferováno) nebo Home page URL registrace aplikace Microsoft Entra ID. Přečtěte si další informace o nastavení domovské stránky pro koncové body.
Před přidáním musí být dovednost nejprve zaregistrována (APPID_NOT_IN_TENANT)	Zkontrolujte, zda je ID aplikace vaší dovednosti zaregistrováno u klienta Microsoft Entra ID vaší organizace.
Odkaz není platný. Odkaz musí začínat na https:// (URL_MALFORMED, URL_NOT_HTTPS)	Tento odkaz zadejte znovu jako zabezpečenou adresu URL.
Manifest je příliš velký. (MANIFEST_TOO_LARGE)	Zkontrolujte velikost manifestu. Nesmí být větší než 500KB.
Tato dovednost už byla k agentovi přidána. (MANIFEST_ALREADY_IMPORTED)	Odstraňte tuto dovednost a zkuste ji zaregistrovat znovu.
Tato dovednost je omezena na 100 akcí. (LIMITS_TOO_MANY_ACTIONS)	V manifestu dovedností je definováno příliš mnoho akcí dovedností. Odstraňte akce a zkuste to znovu.
Akce jsou omezeny na 25 vstupů. (LIMITS_TOO_MANY_INPUTS)	Existuje příliš mnoho vstupních parametrů akce dovednosti. Odstraňte parametry a zkuste to znovu.
Akce jsou omezeny na 25 výstupů. (LIMITS_TOO_MANY_OUTPUTS)	Existuje příliš mnoho výstupních parametrů akce dovednosti. Odstraňte parametry a zkuste to znovu.
Váš agent může mít maximálně 100 dovedností. (LIMITS_TOO_MANY_SKILLS)	Do agenta je přidáno příliš mnoho dovedností. Odstraňte existující dovednost a zkuste to znovu.
Zdá se, že došlo k nějakému problému. (AADERROR_OTHER)	Při ověřování vaší dovednosti došlo k přechodné chybě. Zkuste to znovu.
Při kontrole dovednosti došlo k nějakému problému. (ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)	Zkontrolujte, zda je koncový bod dovednosti online a odpovídá na zprávy.
Tato dovednost neobsahuje vašeho agenta mezi povolenými (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Zkontrolujte, zda byl váš agent přidán do seznamu povolených dovedností.