Používání akcí s vlastními kopiloty (Preview)
Možnosti svého kopilota můžete rozšířit přidáním jedné nebo více akcí. Akce používá váš kopilot k automatické odpovědi uživatelům pomocí generativní akce, nebo je můžete volat explicitně z tématu.
[Tento článek představuje předběžnou dokumentaci a může se změnit.]
Základní typy akcí
Pokud zapnete generativní režim, váš kopilot může automaticky vybrat nejvhodnější akci nebo téma, aby mohl uživateli za běhu odpovědět.
V klasickém režimu může kopilot používat témata pouze k tomu, aby odpovídal uživateli. Stále však můžete navrhnout svého kopilota tak, aby volal akce explicitně z témat.
Akce jsou založeny na jednom z následujících základních typů akcí:
- Předem vytvořená akce konektoru
- Vlastní akce konektoru
- Cloudový tok Power Automate
- Zadání AI Builder
- Dovednost Bot Framework
Důležité
Nemůžete použít konverzační akce vytvořené v Copilot Studio jako akce s vlastními kopiloty.
Každá základní akce má další informace, které popisují její účel, což umožňuje kopilotovi používat generativní AI ke generování otázek. Tyto otázky jsou nutné k vyplnění vstupů potřebných k provedení akce. Proto nemusíte ručně vytvářet uzly otázek ke shromažďování všech potřebných vstupů, jako jsou vstupy na toku. Vstupy jsou zpracovávány za vás za běhu.
Akce mohou generovat kontextovou odpověď na dotaz uživatele pomocí výsledků akce. Případně můžete explicitně napsat odpověď na akci.
Tip
Při použití vygenerovaných otázek z akce informujte své uživatele, že část konverzace generuje umělá inteligence.
Přidejte například další zprávu do Zahájení konverzacesystémového tématu. Toto téma určuje zprávu, která se zobrazí vašim uživatelům, když začne nová konverzace.
Přidat akci
Otevřete svého vlastního kopilota výběrem Kopiloti v levém navigačním panelu a výběrem kopilota ze seznamu.
Vyberte Akce pro zobrazení akcí pro kopilota.
Vyberte + Přidat akci.
V průvodci Vybrat akci (Preview) vyhledejte akci, kterou chcete použít, a vyberte ji.
Zobrazený výchozí seznam obsahuje toky Power Automate a vlastní konektory dostupné ve vašem prostředí. Tento seznam obsahuje běžně používané předpřipravené konektory a dovednosti Bot Framework, které jsou registrovány pro vašeho kopilota.
Důležité
Některé akce vytvořené z pluginů AI, jako jsou dynamická zadání a ty založené na API Dataverse, vyžadují ověření.
V závislosti na akci se vaše připojení automaticky nakonfiguruje, jak je znázorněno v příkladu. Případně budete muset nakonfigurovat připojení, pokud jsou pokyny uvedeny v průvodci. Po úspěšné konfiguraci připojení vyberte Další.
Zkontrolujte a v případě potřeby provést změny v konfiguraci akcí modulu plug-in. Vyberte Dokončit pro přidání akce do kopilota.
Vyberte Další.
Vyvolat akci
Pokud jste zapnuli generativní akce, bude vaše akce volána automaticky jako odpověď na relevantní dotaz uživatele.
Případně můžete zavolat akci explicitně z tématu.
Otestujte svoji akci
Volání akce
Váš kopilot vybere a spustí vaši akci na základě názvu a popisu. Můžete vytvářet vysoce kvalitní popisy pomocí vyhrazeného režimu sledování, abyste viděli, jaké akce váš kopilot vybral na stránce generativní akce.
Případně, pokud jste přidali do tématu, můžete to otestovat zadáním zprávy podobné jedné ze spouštěcích frází pro téma.
Na tomto snímku obrazovky můžete vidět testovanou akci počasí:
Případně, pokud jste přidali akci do tématu, můžete provést test spuštěním tématu vhodnou spouštěcí frází.
Konfigurace vstupů a výstupů pro akci
Provedení změn v konfiguraci akce
Akci můžete konfigurovat mnoha způsoby. V posledním kroku průvodce akcí, nazvaném Zkontrolovat a dokončit, můžete provést změny v konfiguraci akce kliknutím na Upravit vedle příslušné sekce.
Podrobnosti akce
Zde můžete nakonfigurovat údaje o své akci, včetně Zobrazovaného názvu modelu a Popisu modelu pro vaši akci. Obvykle jsou názvy a popisy za vás předem vyplněny na základě akce, kterou jste vybrali.
Vlastnosti Zobrazovaný název a Popis pro každý vstup pomáhají kopilotovi porozumět účelu vstupu a vygenerovat vhodnou otázku pro uživatele a rozpoznat správnou hodnotu v odpovědi uživatele. Například následující je výchozí název a popis vstupního parametru umístění pro konektor MSN Weather.
- Název: Místo
- Popis: Vyhledávací dotaz místa. Platné vstupy jsou Město, Region, Stát, Země, Orientační bod, PSČ, zeměpisná šířka a zeměpisná délka
Když se uživatel zeptá na polohu, kopilot vygeneruje otázku jako: Jaké je místo, kde byste chtěli zjistit počasí? Můžete zadat město, region, kraj, zemi, orientační bod nebo PSČ.
Můžete změnit možnost Identifikovat jako na konkrétní typ entity v závislosti na shromažďovaném vstupu, což může kopilotovi pomoci přesně extrahovat hodnotu z odpovědi uživatele.
Ve výchozím nastavení je každý vstup nastaven na Dynamicky vyplnit nejlepší možnost. Kopilot se pokusí naplnit hodnotu z dostupného kontextu, například extrahovat hodnotu ze zprávy uživatele. Pokud není nalezena žádná vhodná hodnota, vygeneruje otázku, kterou se uživatele zeptá na hodnotu. Vstup můžete přepsat hodnotou namísto dotázání uživatele. Chcete-li provést přepis, změňte rozevírací seznam Jak kopilot vyplní tento vstup? na Nastavit hodnotu a poté zadejte hodnotu. Tato hodnota může být konkrétní hodnota, existující proměnná nebo vzorec Power Fx.
Chcete-li ovládat chování svého kopilota při dotazování na hodnotu nebo ověřování odpovědi uživatele, můžete nakonfigurovat další nastavení pro vstupy.
Výstupy
Ve výchozím nastavení je vaše akce nakonfigurována tak, aby automaticky generovala kontextovou odpověď pro uživatele na základě jeho dotazu a výsledku akce. Pokud se například uživatel zeptá: „Jaká je aktuální teplota v Londýně?“, vygeneruje se kontextová odpověď pomocí GPT, například „Aktuální teplota v Londýně je 9 stupňů Celsia“.
Případně se můžete rozhodnout napsat konkrétní odpověď, aby se vaše akce vrátila. Stejně jako v editoru potvrzení můžete vložit odkazy na výstupní proměnné z akce pomocí voliče proměnných, jak je ukázáno v tomto příkladu.
Volání akce zevnitř tématu
Akci můžete volat explicitně z tématu, podobně jako volání jiných typů akcí, jako jsou toky Power Automate. V závislosti na případu použití můžete tok použít jako součást širšího tématu, které používá více uzlů. Nebo, jako v příkladu počasí, přidání jediného akčního uzlu do téma může být vše, co potřebujete.
Volání akce zevnitř tématu:
V Copilot Studio přejděte na stránku Témata pro kopilota, kterého chcete upravit.
Vytvořte nové téma a pojmenujte jej Získání počasí.
Přidejte následující spouštěcí fráze:
- bude pršet
- dnešní předpověď
- získat počasí
- jaké je počasí
Vyberte Nový uzel (+) a potom Zavolat akci. Přejděte na kartu Akce pluginu (Preview) a poté vyberte akci, kterou jste vytvořili dříve, Získat předpověď počasí.
Váš uzel akce modulu plug-in (Preview) je nyní přidán do vašeho tématu.
Zvolte Uložit.
Přepište vstupy při volání akce z tématu
Ve výchozím nastavení, když vaše akce běží, váš kopilot generuje otázky pro uživatele, aby naplnil požadované vstupy. Možná však budete chtít přepsat jeden nebo více vstupů a zadat explicitní hodnotu namísto otázky pro uživatele. Přepsání můžete provést v konfiguraci akce modulu plug-in v sekci Vstupy. Nebo můžete hodnoty přepsat pouze tehdy, když je vaše akce použita z konkrétního tématu:
V uzlu vyberte Nastavit hodnotu a vyberte vstup, který chcete přepsat.
Zadejte hodnotu pro vstup zadáním hodnoty, výběrem proměnné nebo použitím vzorce.
Nyní, když je tento vstup přepsán, kopilot nepožádá uživatele o hodnotu.
Zapnutí ověření pro akce AI
Některé akce, když jsou vytvořeny na základě akcí umělé inteligence, vyžadují ke správnému fungování ověření, jako je dynamické zadání nebo jiné, které volají rozhraní API Dataverse.
Akce se vždy spouštějí v běhovém prostředí Microsoft Copilot v kontextu koncového uživatele a nelze je spustit, pokud není zapnuto ověřování. Jsou podporovány dva typy metod ověření:
Přejděte na vlastnosti akce konektoru.
V části Ověření koncového uživatele vyberte Ověření autora pomocí kopilota.
Publikujte a otestujte prostředí v podokně testu kopilota nebo v požadovaném kanálu.
Používání akcí toku s přihlašovacími údaji koncového uživatele
Akce toku lze nakonfigurovat tak, aby používaly přihlašovací údaje koncového uživatele. Pokud tok používáte v podporovaném kanálu, nevyžaduje to žádnou speciální konfiguraci v dialogu kopilota a koncoví uživatelé budou moci spravovat svá připojení pro daný tok v poskytnutém prostředí.
Ověřování akcí na základě pluginů ve vaší knihovně
Při vytváření na základě modulů plugin AI vyžadují akce ke správnému fungování ověření. Nejčastěji je to vidět u akcí založených na zadáních nebo jiných, které volají API Dataverse. Akce založené na pluginech se vždy spouštějí v kontextu koncového uživatele a nelze je spustit, pokud není zapnuto ověřování. Jsou podporovány dva typy metod ověření:
Integrovaná autentizace (Teams a Power Apps): Tuto metodu ověřování můžete použít, pokud chcete publikovat svého kopilota do kanálu Teams. Tato metoda funguje také pro kopiloty vložené do libovolné aplikace Power Platform, která používá tokeny vytvořené podle standardu PPAPI.
Manuální ověřování (kopiloti třetích stran): Tato metoda ověřování zahrnuje nastavení a připojení Microsoft Entra ID.
Vytvoření připojení ručního ověřování:
Nastavte aplikaci Microsoft Entra ID.
Nastavte ruční ověřování pro svého kopilota Copilot Studio.
Povolte svým aplikacím používat delegování k načtení tokenu jménem uživatele. Nezapomeňte přidat všechny potřebné rozsahy.
