Úprava a správa toku agenta nebo pracovního postupu v návrháři

Toky agentů a pracovní postupy se vytvářejí a upravují v návrhářích vizuálů v Copilot Studio. Nové pracovní postupy, které jsou teď ve verzi Public Preview, používají přepracovaný vizuální návrhář, zatímco toky agentů používají původní vizuální návrhář. Oba vizuální designéry poskytují plátno, na kterém můžete pokračovat ve vytváření nebo úpravě automatizace. Přidávejte a odebírejte akce, kontrolujte chyby a publikujte svůj tok, to vše bez opouštění designéra. Můžete také přizpůsobit způsob zobrazení toku agenta nebo pracovního postupu, abyste se mohli zaměřit na konkrétní oblasti.

Důležité

Tento článek obsahuje dokumentaci k funkcím Preview v řešení Microsoft Copilot Studio a může se změnit.

Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před oficiálním vydáním, abyste si je mohli co nejdříve vyzkoušet a napsat nám své názory.

Pokud vytváříte agenta připraveného do provozního prostředí, podívejte se do tématu Přehled řešení Microsoft Copilot Studio.

Pracovní postupy

Pro zobrazení agentního toku nebo pracovního postupu v designéru otevřete Copilot Studio, vyberte Toky, vyberte tok a poté vyberte záložku Sestavit.

Toky agentů

Pro zobrazení agentního toku v designéru otevřete Copilot Studio, vyberte Toky, vyberte tok a poté vyberte záložku Designér.

Změna způsobu zobrazení toku

V závislosti na velikosti a složitosti toku agenta nebo pracovního postupu může být vhodné upravit způsob zobrazení toku, aby bylo snazší s ním pracovat. Panel nástrojů v levém dolním rohu plátna ovládá zobrazení.

Pracovní postupy

Legenda

1. Přiblížit: Zvětší velikost pracovního postupu na plátně.
2. Oddálit: zmenší velikost pracovního postupu na plátně.
3. Přizpůsobit zobrazení: Změní velikost zobrazení, aby se celý pracovní postup vešel na plátno.
4. Úklid: Přeorganizujte pracovní postup a větve pro čistší celkové zobrazení.
5. Vertikální rozvržení: Přepněte na vertikální rozvržení pracovního postupu.

Toky agentů

Legenda

1. Rozbalit nebo sbalit: Rozbalí nebo sbalí všechny skupiny akcí. Pokud má například akce více podmínek, vyberte tuto ikonu, aby se zobrazily podrobnosti o podmínce.
2. Přiblížit: Zvětší velikost toku na plátně.
3. Oddálit: zmenší velikost toku na plátně.
4. Přizpůsobit zobrazení: Změní velikost zobrazení, aby se celý tok vešel na plátno.
5. Minimapa: Přechod na konkrétní úsek velkého toku.
6. Hledat: Vyhledání operací v toku.

Přidání a odebrání akcí

Pracovní postupy

1. Na kartě, za kterou chcete akci přidat, vyberte Přidat krok. Otevře se podokno Přidat.

2. V části Přidat začněte psát akci, kterou chcete, aby váš tok provedl, nebo konektor, který chcete přidat, a poté ho vyberte ze seznamu. V závislosti na vaší volbě může být potřeba zadat další informace k dokončení akce.

Pokud zjistíte, že akce není potřeba, klikněte na ikonu Odstranit v pravém horním rohu dané akce.

Toky agentů

1. Pod kartou, kam chcete přidat akci, vyberte možnost Vložit novou akci. Otevře se panel Přidání akce.

2. V části Přidání akce začněte psát akci, kterou má tok provést, a pak ji vyberte ze seznamu. V závislosti na vaší volbě může být potřeba zadat další informace k dokončení akce.

Pokud zjistíte, že akce není potřeba, vyberte ji v toku a poté klikněte na tři tečky (⋮) >Odstranit. Odstranění potvrďte tlačítkem OK.

Kontrola parametrů toku

Pracovní postupy

Pro zobrazení parametrů spouštěče nebo akce v pracovním postupu vyberte danou kartu. Panel konfigurace se otevře na pravé straně. Chcete-li zadat hodnotu parametru, vyberte možnost z rozbalovacího seznamu nebo zadejte výraz pro dynamické nastavení hodnoty.

Toky agentů

Pro zobrazení parametrů spouštěče nebo akce v toku agenta vyberte danou kartu. Otevře se konfigurační panel s kartou Parametry, která je zobrazena ve výchozím nastavení. Chcete-li zadat hodnotu parametru, vyberte možnost z rozbalovacího seznamu nebo zadejte výraz pro dynamické nastavení hodnoty.

Zobrazení historie verzí pro toky agenta

Historie verzí se zaznamenává v Microsoft Dataverse, když vytváříte nebo upravujete tok agenta. Pokud chcete co nejlépe rozumět, jak se tok agenta tok vyvíjel, projděte si jeho historii verzí. Verze toku jsou seskupené podle data s indikátory pro nejnovější verzi, publikovanou a dříve publikovanou verzi.

Historie toku je založena na uložených verzích, takže je dobré uložit návrhy ještě před dokončením toku.

Abyste mohli použít panel historie verzí, musíte tok agenta uložit alespoň jednou.

1. V nabídce v horní části plátna vyberte možnost Historie verzí.

2. Chcete-li zobrazit zaznamenané verze toku, rozbalte některou položku v seznamu.

3. Pro zobrazení verze v designéru ji vyberte v seznamu.

Zkontrolovat chyby

Pracovní postupy

Chyby v akcích pracovního postupu jsou označeny červeně. Pro zobrazení údajů chyby v určité akci vyberte chybu. Pro zobrazení všech chyb v celém toku otevřete banner centra stavu. Výběrem chyby zobrazíte podrobnosti jednotlivých chyb.

Toky agentů

Chyby v akcích toku agenta jsou označeny červeně. Pro zobrazení údajů chyby v určité akci vyberte chybu. Pokud chcete vypsat všechny chyby v celém toku, v nabídce v horní části plátna vyberte Kontrola toku. Výběrem chyby zobrazíte podrobnosti jednotlivých chyb. Případně volbou Otevřít operaci otevřete operaci na panelu Kontrola toku a opravte chybu.

Důležité

Nemůžete publikovat tok, pokud obsahuje chyby. Před publikováním toku musíte opravit všechny chyby.

Publikování pracovního postupu

Pokud pracovní postup neobsahuje žádné chyby, můžete ho publikovat. Pokud chcete tok publikovat, v nabídce v horní části plátna vyberte Publikovat.

Testování toku nebo pracovního postupu agenta

Pracovní postupy

Testovací běhy vám umožní ověřit krok nebo celý tok bez opuštění návrháře, a to buď pomocí skutečných vstupních dat, hodnot, které si sami zadáte, nebo výstupů z předchozího běhu.

Test lze spustit dvěma způsoby:

Co chcete ověřit	Postup testování	Kde to najít
Jednotlivá akce nebo krok AI samostatně	Otestujte tento uzel	Záložka Test v bočním panelu uzlu
Celý tok, od začátku do konce	Spuštění testu toku	Tlačítko Spustit v horním příkazovém panelu

Oba povrchy sdílejí stejnou myšlenku: zadat vstupy (reálné nebo simulované), spustit a následně zkontrolovat výstup.

Otestujte jeden uzel v pracovním toku

Otevřete libovolnou akci nebo uzel ve svém pracovním toku a vyberte tlačítko Spustit nebo Otestovat. K dispozici jsou tři části:

1. Spustit/resetovat test: Spustí krok na vyžádání nebo vymaže aktuální vstupy a výstupy.

   

2. Načtení hodnot z předchozího spuštění: Rozbalovací seznam posledních spuštění tohoto toku. Když vyberete jednu možnost, stáhnou se výstupy z upstreamového kroku do vstupních polí níže.

3. Vstupy: Jedno upravitelné pole pro každý výstup z předchozího kroku, na který odkazuje uzel. Odznak vpravo od každého řádku ukazuje očekávaný typ pole (řetězec, e-mail, datum-čas, číslo atd.).

4. Výstup: Živý výsledek posledního testu, formátovaný podle typu uzlu (JSON, výsledek promptu, odpověď konektoru atd.).

Simulované vstupy

Ve výchozím stavu jsou vstupní pole prázdná. Můžete provádět následující:

• Zadejte libovolnou hodnotu přímo do pole. Pole přijímá typ uvedený na odznaku vpravo.
• Pole můžete nechat prázdné, pokud není pro daný krok potřeba.

Zpropitné

Co se tu objevuje? Karta Test automaticky zobrazí výstupy upstreamového kroku, na které odkazuje výrazy tohoto uzlu. Pokud přidáte nový token do uzlu, příslušné pole se objeví při dalším otevření testu.

Nahrání hodnot z předchozího běhu

Pokud tok běžel dříve, můžete přehrát skutečná data místo jejich vkládání ručně.

1. V rozevíracím seznamu Načíst hodnoty z předchozího spuštění vyberte spuštění. Každá položka je označena datem/časem a stavem běhu (například 24. dubna, 09.12 – Proběhl úspěšně).

2. Designér načte výstupy kroků tohoto běhu a promítne je do vstupního schématu vašeho uzlu. Odpovídající hodnoty jsou zapsány do vstupních polí.

3. Upravte libovolné pole, pokud chcete scénář upravit.

V rozevíracím seznamu se zobrazuje 10 nejnovějších spuštění jakéhokoli stavu. Pokud spuštění neobsahuje výstupy pro jeden z vašich předcházejících kroků (protože byl tento krok přeskočen nebo tato cesta nebyla zvolena), vyplní se pouze dostupná pole. Ostatní pole zůstávají nezměněna.

Pokud se tok předtím nespustil, Není k dispozici žádné předchozí spuštění a rozevírací seznam je skrytý.

Spuštění testu

Vyberte Spustit test. Tlačítko zobrazuje stav zaneprázdnění, zatímco probíhá volání; sekce Výstup zobrazuje indikátor průběhu a následně výsledek nebo chybu.

• Reset test resetuje jak vstupy, tak poslední výstup.
• Test spustí uzel izolovaně proti rozhraní API konektoru. Test nespustí zbytek toku.

Testování celého toku

V horní liště příkazů vyberte tlačítko spuštění (Test). Testování spustí váš pracovní postup komplexně v živém modulu runtime.

Před začátkem běhu designér:

1. Uloží a publikuje tok, pokud máte neuložené změny (nebo pokud je to poprvé).
2. Při prvním spuštění instaluje všechna nová připojení.
3. Aktivuje spuštění. Cesta závisí na typu spouštěče.

Typ aktivační události	Co se stane, když zvolíte Test
Ruční / požadavek HTTP	Otevře se dialogové okno, ve kterém zadáte vstupy spouštěče, a následně se tok okamžitě spustí.
Opakování / posuvné okno / dotazování	Buď se plán spustí a první spuštění proběhne automaticky, nebo, pokud je tok už nainstalovaný, proběhne jednou.
Událost konektoru (například když dorazí e-mail)	Tok se publikuje a čeká. Můžete vidět Čekání na spouštěč…. Proveďte akci ve zdrojovém systému, abyste spustili tok.
HTTP webhook	Tok je publikovaný; aktivujte jej z externího systému stejně jako obvykle.

Testovací vstupy (ruční spouštěč)

U manuálních spouštěčů se v dialogu Zadejte vstupy manuálního spouštěče zobrazí jedno pole pro každý vstup, který jste na spouštěči definovali:

• Text/číslo/e-mail/datum: Odpovídající vstupní ovládací prvek.
• Logická hodnota: Přepínač triggeru.
• Výběr z možností (enum): Rozevírací seznam.
• Vícenásobný výběr: Rozevírací seznam pro více výběrů.
• Soubor: Dialog pro výběr souboru (obsah je nahrán jako součást běhu).
• Objekt/pole: Víceřádková textová oblast, kam můžete vložit JSON.

Vyberte Spustit pro zahájení toku s těmito vstupy nebo Zrušit pro zavření bez spuštění. Povinná pole jsou označena hvězdičkou. Pokud chybí nebo jsou hodnoty neplatné, zobrazí se validační zprávy přímo v poli a spuštění je zablokováno, dokud nejsou opraveny.

Dialog se zobrazí pokaždé, když zvolíte Test. Hodnoty se mezi běhy neukládají, takže můžete rychle zkoušet různé scénáře.

Sledovat běh

Jakmile je spuštění v běhu:

• Příkazový panel zobrazuje tlačítko Zrušit během aktivního spuštění.
• Na panelu Aktivity (vpravo) je uvedené aktuální spuštění v horní části se stavovým odznáček: Spuštěno, Čeká, Úspěšné, Neúspěšné nebo Zrušeno. Výběrem libovolného spuštění jej otevřete na plátně a zkontrolujte vstupy a výstupy jednotlivých kroků.

Vyberte minulá spuštění

Panel Aktivity také slouží jako historie spuštění vašeho procesu:

• Filtrovat podle Všech / Úspěšných / Neúspěšných / Spuštěných pomocí rozevíracího seznamu v horní části.
• Vyberte Obnovit pro opětovné načtení seznamu.
• Ve spodní části vyberte Načíst více pro načtení dalších předchozích běhů.
• Výběr konkrétního spuštění jej načte na plátno, kde každý uzel zobrazuje vstupy, které přijal, a výstupy, které pro dané spuštění vyprodukoval. Data jsou stejná jako ta, která používá karta Test na úrovni uzlu, když v jejím rozevíracím seznamu vyberete konkrétní spuštění.

Kdy použít který typ testu

• Iterace v jednom kroku AI nebo akci konektoru?: Otestujte tento uzel. Je rychlejší, nepublikuje se a umožňuje napodobení pouze upstreamových hodnot, které jsou důležité.
• Ověřování komplexního chování nebo logiky triggeru?: Spusťte test toku. Testuje celý proces ve skutečném runtime prostředí.
• Reprodukování produkčního problému?: Otevřete neúspěšné spuštění na panelu Aktivita, poté otevřete selhávající uzel a na kartě Test použijte Načíst hodnoty z předchozího spuštění pro přehrání přesných upstreamových dat do akce.

Toky agentů

Jen proto, že váš tok nemá žádné chyby a lze jej publikovat, neznamená to, že udělá to, co chcete. Po publikování toku agenta jej otestujte, abyste se ujistili, že funguje podle očekávání.

Test můžete spustit ručně nebo automaticky. Jakmile test proběhne, můžete zkontrolovat výsledky všech akcí a ověřit, že tok funguje dle očekávání.

1. Uložte a publikujte tok.

2. V nabídce v horní části plátna vyberte možnost Testovat. Otevře se panel Testování toku.

3. Vyberte, zda test spustit Ručně, nebo Automaticky.

4. Na panelu Spuštění toku vyberte Testovat>Spustit tok. Zelené zaškrtávací políčko označuje, že se tok úspěšně spustil.

5. Vyberte Hotovo.

Testování toku agenta v návrháři nespotřebovává kapacitu Copilot Studio.

Související obsah

• Parametry v podokně konfigurace akcí
• Přidání několika akcí a upřesňující možnosti do cloudového toku
• Koncepty a správa verzí cloudových toků
• Provádění vázaných nebo nevázaných akcí
• Rychlé vyhledání a oprava chyb pomocí nástroje Kontrola toku
• Řešení běžných problémů s aktivačními událostmi
• Nejčastější dotazy týkající nástroje Copilot v cloudových tocích
• Nejčastější dotazy k asistentovi výrazů Copilot
• Nejčastější dotazy ohledně generativních akcí v cloudových tocích