Vytvoření toku
Naučte se používat cloudový tok v Copilot Studio tím, že agent umožníte na požádání vytvořit předpověď počasí. V tomto prvním příkladu vytvoříte tok, který načte předpověď počasí. V dalším příkladu zavoláte tok jako akci z téma , takže agent může odpovědět s předpovědí, když se zákazník zeptá na počasí.
Pro práci s agenty vyžaduje tok Power Automate specifický spouštěč toku a akci odpověď.
Trigger toku: Spustit tok z Copilota
Akce reakce: Odpovědět Copilotovi
Když vytvoříte tok z Copilot Studio, spouštěč a akce se přidají za vás. Můžete upravit stávající tok pro použití s agenty tak, že jej změníte tak, aby používal tyto akce.
Důležité
Chcete-li použít cloudové toky ve vlastních agentech v Copilot Studio, toky musí:
- Mít trigger Spustit tok z Copilota.
- Být umístěn v řešení ve stejném prostředí jako agent. Stávající toky lze přidat k řešení , aby byly dostupné při přidávání akcí do agent.
- Vracet odpověď synchronně s akcí Odpovědět Copilotovi v rámci limitu akce 100 sekund. Chcete-li se vyhnout časovým limitům, optimalizujte logiku toku, dotazy a množství vrácených dat tak, aby typické spuštění bylo pod tímto limitem. Akce, které potřebují běžet déle, mohou být umístěny za akcí Odpovědět Copilotovi, aby mohli pokračovat v provádění až do limitu doby trvání toku, což je obvykle 30 dní.
Předpoklady
- Přístup k Copilot Studio s licencí, která zahrnuje použití toků v kontextu výtvorů Copilot Studio.
Vytvořte tok pro použití s agent
Přejděte na stránku Témata pro svůj agent.
Otevřete téma, ze kterého chcete volat tok.
Vyberte tlačítko Přidat uzel (+) pod existujícím uzlem a přidejte tak nový uzel.
V okně pro výběr uzlu vyberte Volat akci, Základní akce a poté vyberte Vytvořit tok.
Portál Power Automate se otevře na nové kartě se šablonou úvodního postupu otevřenou pro úpravy. Portál se otevírá ve stejném prostředí jako agent a používá stejná uživatelská pověření.
Tip
Přejmenujte uzly, abyste je snáze identifikovali. Chcete-li název aktualizovat přímo, vyberte pole názvu uzlu nebo vyberte ikonu Další (…) pro uzel a z nabídky vyberte Přejmenovat. Můžete také přejmenovat uzly v editoru kódu.
Není možné přejmenovat uzly Trigger a Přejít na krok.
Názvy uzlů mohou mít délku až 500 znaků.
Nyní přidejte do toku akce. V tomto příkladu přidáte akci, která načte aktuální předpověď z MSN Weather.
Vyberte název toku a přejmenujte ho na Načíst předpověď počasí.
Přidejte následující vstupní parametry do spouštěče Spustit tok z Copilota:
- Město (text)
- PSČ (číslo)
Výběrem možnosti Přidat akci vytvořte novou akci v uzlu triggeru toku Spustit tok z Copilota.
Vyhledejte MSN Weather a poté vyberte akci Načíst předpověď na dnešek.
V akci Načíst předpověď na dnešek v poli Umístění vyberte Přidat dynamický obsah a poté vyberte Město a PSČ.
V akci Odpovědět Copilotovi přidejte následující výstupní parametry a proměnné:
Výstupní parametr Type Proměnná day_summary
Řetězcové Denní souhrn location
Řetězcové Umístění chance_of_rain
Počet Denní pravděpodobnost deště Zvolte Uložit.
Správa, která připojení tok používá
V podporovaném ověřeném agent lze cloudové toky nakonfigurovat tak, aby používaly přihlašovací údaje uživatele , když jsou spuštěny jako součást plánu generativní orchestrace nebo jsou volány z téma. Pokud tok používáte v podporovaném kanálu, nevyžaduje to žádnou speciální konfiguraci v agent dialogu a uživatelé budou moci spravovat svá připojení při používání agent.
Cloudové toky v prostředích využívajících klíče spravované zákazníkem (CMK) zatím nelze spouštět s přihlašovacími údaji koncového uživatele jako součást plánů generativní orchestrace nebo z témat. Zajistěte, aby nastavení typu run-only pro cloudové toky v prostředích CMK byla nastavena na konkrétní připojení namísto Poskytnuto uživatelem pouze ke spuštění.
Upravte existující tok pro použití s agent
Pokud máte tok s jiným spouštěčem, který chcete použít se svým agent, můžete tok změnit tak, aby používal Spustit tok z Copilot spouštěče a Odpovědět Copilot odpověď akce a ujistěte se, že je v řešení ve stejném prostředí jako vlastní agent.
Přejděte na portál Power Automate a pomocí voliče prostředí vpravo nahoře vyberte prostředí, kde je uložen váš tok.
Přejděte na Moje toky na levé straně a vyhledejte tok.
Výběr toku
Přidání triggeru a akce odezvy Copilota
Pokud váš tok ještě nezahrnuje spouštěč Copilot a akci odpověď, musíte je přidat, než budete moci tok použít se svým agent.
Vyberte Nový krok.
Vyhledejte Copilot a vyberte Spustit tok z Copilota.
Vyberte Nový krok.
Vyhledejte konektor Copilot a vyberte možnost Odpovědět Copilotovi. Akci odpovědi lze použít na více větvích toku, ale při každém použití musí mít stejné výstupy.
Uložte a publikujte tok.
Ujistěte se, že akce odpovědi je nastavena na návrat v reálném čase
Toky, které chcete použít v agent, musí vracet hodnoty v reálném čase nebo synchronně. Toky, které běží na pozadí nebo asynchronně, mohou způsobit chybu, když se je agent pokusí spustit. Místo spuštění toku agent řekne: „Stalo se něco neočekávaného. Vyšetřujeme to. Kód chyby: 3000.“
Když vytvoříte tok z Copilot Studio, asynchronní odpovědi jsou ve výchozím nastavení vypnuty. Pokud jste upravili existující tok, který má zapnuté asynchronní odpovědi, zkontrolujte nastavení a ujistěte se, že je vypnuto, podle následujících kroků:
Otevřete svůj postup a najděte akce Reagovat na Copilot .
Vyberte kartu Nastavení.
Nastavte Asynchronní odpověď na Vypnuto a poté vyberte Hotovo.
Přidání toku do řešení
Aby byly toky dostupné agentům, musí být uloženy v řešení ve stejném Power Platform prostředí. Pokud je tok v řešení, na stránce s údaji o toku se zobrazí dlaždice Řešení, která uvádí, ve kterých řešeních se tok nachází. Toky lze přidat k Výchozímu řešení pro použití s agenty nebo přesunout do jiného řešení pomocí níže uvedených kroků:
Přejděte na portál Power Automate.
Přejděte na Řešení a vyberte existující řešení, nebo vytvořte řešení pro vaše toky.
Chcete-li vytvořit řešení, vyberte možnost Nové řešení.
Pojmenujte nové řešení, v poli Vydavatel vyberte Výchozí vydavatel CDS, zadejte číslo Verze a poté vyberte Vytvořit.
Na kartě Řešení přejděte na řešení, které chcete použít. Vyberte tlačítko Přidat existující a přidejte k němu tok.
Na stránce Přidat existující tok vyberte kartu Z řešení, poté vyberte tok a poté vyberte Přidat.
Chcete-li přesunout tok z karty Moje toky do řešení, vyberte Vnější řešení a poté vyberte Přidat při přidání toku do řešení.