Sdílet prostřednictvím


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

    Screenshot triggeru Spustit tok z toku Copilota.

  • Akce reakce: Odpovědět Copilotovi

    Snímek obrazovky akce Reagovat na odpověď Copilota.

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

Vytvořte tok pro použití s ​​agent

  1. Přejděte na stránku Témata pro svůj agent.

  2. Otevřete téma, ze kterého chcete volat tok.

  3. Vyberte tlačítko Přidat uzel (+) pod existujícím uzlem a přidejte tak nový uzel.

  4. V okně pro výběr uzlu vyberte Volat akci, Základní akce a poté vyberte Vytvořit tok.

    Screenshot s možností Vytvořit tok v nabídce Volat akci.

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

    Screenshot šablony toku Power Automate volané z Copilot Studio.

    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.

  1. Vyberte název toku a přejmenujte ho na Načíst předpověď počasí.

    Snímek obrazovky s vybraným názvem toku.

  2. Přidejte následující vstupní parametry do spouštěče Spustit tok z Copilota:

    • Město (text)
    • PSČ (číslo)

    Screenshot vstupních parametrů pro tok Power Automate.

  3. Výběrem možnosti Přidat akci vytvořte novou akci v uzlu triggeru toku Spustit tok z Copilota.

    Snímek obrazovky tlačítka Přidat akci toku.

  4. Vyhledejte MSN Weather a poté vyberte akci Načíst předpověď na dnešek.

    Snímek obrazovky akce Načíst předpověď na dnešek pod konektorem MSN Weather.

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

    Snímek obrazovky proměnných přidaných do akce Načíst předpověď pro dnešek

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

    Snímek obrazovky dynamických výstupních proměnných přidaných k akci odpovědi toku.

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

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

  2. Přejděte na Moje toky na levé straně a vyhledejte tok.

  3. Výběr toku

    Snímek obrazovky postupu Získat předpověď počasí ve výchozím řešení.

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.

  1. Vyberte Nový krok.

  2. Vyhledejte Copilot a vyberte Spustit tok z Copilota.

  3. Vyberte Nový krok.

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

  5. 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ů:

  1. Otevřete svůj postup a najděte akce Reagovat na Copilot .

  2. Vyberte kartu Nastavení.

  3. Nastavte Asynchronní odpověď na Vypnuto a poté vyberte Hotovo.

    Snímek obrazovky přepínače asynchronní odpovědi.

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ů:

  1. Přejděte na portál Power Automate.

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

    Screenshot s tlačítkem Nové řešení.

    Pojmenujte nové řešení, v poli Vydavatel vyberte Výchozí vydavatel CDS, zadejte číslo Verze a poté vyberte Vytvořit.

    Snímek obrazovky vlastností řešení.

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

    Snímek obrazovky tlačítka Přidat existující.

  4. Na stránce Přidat existující tok vyberte kartu Z řešení, poté vyberte tok a poté vyberte Přidat.

    Snímek obrazovky se seznamem existujících toků v řešeních.

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

    Snímek obrazovky se seznamem existujících toků mimo řešení.