Sdílet prostřednictvím


Odeslání aktivit akce

Důležité

Schopnosti a funkce Power Virtual Agents jsou nyní součástí Microsoft Copilot Studio po významných investicích do generativní umělé inteligence a vylepšených integracích napříč Microsoft Copilot.

Některé články a snímky obrazovky mohou odkazovat na Power Virtual Agents, zatímco aktualizujeme dokumentaci a obsah školení.

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í jsou odesílány z kopilota a mohou být zachyceny a používány kanálem, který rozhoduje, zda a jak aktivity použít. 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 kopilota. Můžete například vyhledat událost, která je vrácena od kopilota, a provést akci na stránce. 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. Koncovému uživateli se zobrazí první zpráva, po ní pauza a poté 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.