Sdílet prostřednictvím

Vytvoření toku agenta jako nástroje

Naučte se používat cloudový tok v Copilot Studio tím, že agentovi umožníte vytvořit předpověď počasí na vyžádání. V tomto prvním příkladu vytvoříte tok, který načte předpověď počasí. V dalším příkladu vytvoříte téma pro volání toku jako akce, aby agent mohl reagovat předpovědí, když se zákazník zeptá na počasí.

Aby tok agenta fungoval jako nástroj s agenty, vyžaduje následující:

  • Mít spouštěč Když agent zavolá tok a akci odpovědi Odpovědět agentovi.
  • Mít konfigurovánu reakci v reálném čase namísto asynchronní. Přepínač Asynchronní odpověď musí být nastavený na Vypnuto v části Sítě v nastavení Odpovědět agentovi.
  • Odpovězte agentovi v rámci limitu 100 sekund akce. Optimalizujte logiku toku, dotazy a množství vrácených dat tak, aby typický běh byl pod tímto limitem 100 sekund. Akce v procesu, které musí běžet déle, je možné umístit po akci Reagovat na Copilota, aby pokračovaly v běhu až do limitu doby trvání procesu 30 dnů. Pokyny k urychlení toků najdete v tématu Zrychlení provádění toků agenta pomocí expresního režimu.

Když v nástroji Copilot Studio vytvoříte tok agenta jako nový nástroj přidaný do agenta, přidá se za vás požadovaná aktivační událost toku a akce odpovědi. Existující tok můžete upravit pro použití s agenty, když jej aktualizujete, aby používal tuto aktivační událost a akci odpovědi.

Předpoklady

Vytvořte tok, který můžete použít s agentem

V tomto příkladu vytvoříte tok, který načte aktuální předpověď počasí s MSN Weather. Tok přidáte jako nástroj do existujícího tématu agenta.

Přidání prázdného nového toku agenta do tématu a jeho uložení

  1. Přejděte na stránku Témata svého agenta.

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

  3. Vyberte ikonu Přidat uzel pod libovolným uzlem a vyberte Přidat nástroj.

  4. Na kartě Základní nástroje vyberte Nový tok agenta.

    Otevře se stránka Toky agenta s úvodní šablonou toku otevřenou v návrháři toků agentů pro úpravy. Tok zahrnuje požadovanou akci Když agent zavolá trigger toku a Odpovědět na akci agenta.

  5. Před provedením jakýchkoli změn vyberte Publikovat a uložte tok. Po úspěšném vytvoření toku se zobrazí oznámení.

  6. Výběrem možnosti Přejít zpět k agentu se vraťte do svého tématu. Do tématu pro tok se přidá nový uzel akce.

  7. Výběrem možnosti Uložit dokončíte přidání toku jako nástroje do agenta.

Přidání akcí a konfigurace toku

Se základní šablonou vytvořenou pro tok a tokem přidaným do tématu agenta se teď můžete vrátit a přidat do toku akce. V tomto příkladu přidáte akci, která načte aktuální předpověď z MSN Weather.

  1. Na uzlu Akce s tokem vyberte odkaz Zobrazit podrobnosti toku a vraťte se k toku agenta.

  2. Na stránce Přehled v části Údaje upravte název toku na něco smysluplného, například „Získat předpověď počasí“.

  3. Přejděte do návrháře, vyberte trigger toku Když agent zavolá tok a přidejte následující vstupní parametry:

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

  4. Vyberte ikonu Přidat pod aktivační událostí toku Když agent zavolá tok.

  5. V části Přidání akce vyhledejte „počasí MSN“ a vyberte akci Získat předpověď na dnešek.

  6. Na panelu Získání předpovědi pro dnešek v poli Umístění zadejte lomítko (/), vyberte Vložit dynamický obsah a pak vyberte vstupní parametr Město.

  7. Stejným způsobem přidejte vstupní parametr PSČ.

  8. V akci Odpovědět agentovi přidejte následující výstupní parametry a proměnné:

    Výstupní parametr Typ Proměnná
    day_summary Text Denní souhrn
    location Text Umístění
    chance_of_rain Počet Denní pravděpodobnost deště

    Snímek obrazovky dynamických proměnných jako výstupních parametrů pro akci odpovědi.

  9. Vyberte Publikovat. Po úspěšném vytvoření toku se zobrazí oznámení.

Pokud chcete pokračovat, postupujte podle pokynů v tématu Volání toku agenta z agenta.

Správa, která připojení tok používá

V podporovaném ověřeném agentovi lze cloudové toky nakonfigurovat tak, aby používaly přihlašovací údaje koncového uživatele, když jsou spuštěny jako součást plánu generativní orchestrace nebo volány z tématu. Použití toku v podporovaném kanálu nevyžaduje v agentovi žádnou speciální konfiguraci. Zákazníci mohou spravovat svá připojení při používání agenta.

Cloudové toky v prostředích používajících klíče spravované zákazníkem (CMK) zatím není možné spouštět s přihlašovacími údaji zákazníka v rámci 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í.

Související obsah

  • Last updated on