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

Důležité

Schopnosti a funkce Power Virtual Agents jsou nyní součástí Microsoft Copilot Studio po významných investicích do generativní umělé inteligence a vylepšených integracích napříč Microsoft Copilot.

Některé články a snímky obrazovky mohou odkazovat na Power Virtual Agents, zatímco aktualizujeme dokumentaci a obsah školení.

Copilot Studio umožňuje rozšířit používání vašeho kopilota pomocí dovedností Bot Framework. Pokud jste již ve své organizaci vytvořili a nasadili kopiloty (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 kopilotu 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 kopilota 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é

Kopiloti 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 kopilota Composer 1.x, nejprve jej migrujte do Composer 2.x, než jej použijete jako dovednost.

Chcete-li nakonfigurovat dovednost, přidružená registrace aplikace v Microsoft Entra ID pro vaši dovednost musí být nastavena na Konfigurace 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 kopilotů mohou vytvářet opakovaně použitelné toky, které lze vložit do jakékoli konverzace s kopiloty	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.
Odpověď respondenta	Použijte toky k odeslání odpovědi kopilota. Zobrazte například personalizovanou zprávu nebo vložené obrázky.	Použijte dovednosti k odeslání jakékoli podporované odpovědi kopilota. 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 kopilota.

Konfigurace dovednosti

Nejdříve v Copilot Studio vytvořte kopilota 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 kopilota, aby kopilota autorizoval k vyvolání akcí v dovednosti. Další informace o seznamu povolených dovedností. ID svého kopilota můžete získat z okna Přidat dovednost.

Přidání dovednosti do kopilota:

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 kopilota a poskytněte jej svému vývojáři dovedností.

   

4. Zadejte adresu URL manifestu dovednosti. Manifest dovednosti obsahuje informace, které bude váš kopilot 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 kopilotovi. 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 kopilota. 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 přidána do kopilota. (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áš kopilot může mít maximálně 100 dovedností. (LIMITS_TOO_MANY_SKILLS)	Do kopilota 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 kopilota mezi povolenými (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Zkontrolujte, zda byl váš kopilot přidán do seznamu povolených dovedností.