Sdílet prostřednictvím


Odeslání události nebo aktivity

Microsoft Copilot Studio poskytuje dva uzly, které vám umožňují odesílat aktivity bez zpráv: Odeslat událost a Odeslat aktivitu. Tyto typy uzlů jsou popsány v následujících sekcích.

Snímek obrazovky s přidáním pokročilého uzlu, včetně možností Odeslat událost a Odeslat aktivitu.

Odesílání událostí

Uzel Odeslat událost je určen pro odesílání aktivit událostí. Aktivity událostí se odesílají z agent a mohou být zachyceny a použity kanálem, který rozhoduje, zda a jak tyto aktivity používat. Když odešlete událost, dáte jí název a poté můžete nastavit hodnotu události. Tato hodnota může být v libovolném formátu: primitivní doslovná hodnota, odkaz na proměnnou nebo vzorec Power Fx. Hodnota se serializuje jako JSON a přidá se k odchozí aktivitě.

Snímek obrazovky zobrazující nabídku nastavení pro uzel aktivity události.

Použití tohoto uzlu zahrnuje:

  • Můžete nakonfigurovat vlastní ovládací prvek webového chatu pro zpracování událostí odeslaných z agent. Můžete například vyhledat událost, která se vrací z agent, a provést na stránce akci. Ukázka 04.api/c.incoming-activity-event v úložišti ukázek webového chatu Microsoft Bot Framework na GitHubu demonstruje, jak by zpracování událostí mohlo fungovat.
  • Audiokódy používají aktivity událostí, aby vám umožnily ovládat službu. Například spuštění nebo zastavení nahrávání hovorů. Další informace najdete v části Nahrávání hovorů.

Odesílání dalších typů aktivit

Kromě aktivit událostí můžete odesílat aktivity jiných typů pomocí uzlu odeslat aktivitu. Obecně je použití tohoto uzlu pokročilé – proto je v pokročilé podkategorii. Typy aktivit, které můžete odeslat, jsou podmnožinou aktivit nabízených ve schématu Bot Framework – třída ActivityTypes. Při použití tohoto uzlu zvolíte typ aktivity a poté volitelně nastavíte název nebo hodnotu.

Běžné typy jsou:

  • Psaní – Odešle aktivitu psaní, kterou může kanál vybrat a zobrazit tak indikátor psaní v klientovi.
  • Zpoždění – Lze použít k poskytnutí prodlevy mezi zprávami. Například: odeslání zprávy, potom odeslání aktivity zpoždění a následná další zpráva. Zákazníkovi se zobrazí první zpráva, následuje pauza a pak druhá zpráva. V tomto případě je „Hodnota“ nastavena na počet milisekund zpoždění. Podrobnosti získáte v tématu Pole ActivityTypes.Delay.
  • Vyvolání / vyvolání odpovědi – Obecně se používá pro Microsoft Teams. Uživatel vytvoří téma s triggerem Vyvolání, aby zachytil příchozí vyvolání z Teams a pomocí aktivity Vyvolání odpovědi poslal příslušnou odpověď zpět do Teams.
  • Předání – Umožňuje uživateli odeslat aktivitu Předání s explicitní kontrolou nad hodnotou. Předání se používá pro některé externí kanály, jako jsou audiokódy.

Snímek obrazovky zobrazující uzel aktivity Vyvolat s rozevíracím seznamem Typ.