Sdílet prostřednictvím


Jak fungují roboti Microsoft Teams

PLATÍ PRO: SDK v4

Tento článek vychází z toho, co jste se naučili v tom, jak roboti fungují a konverzace řízené událostmi. Měli byste být obeznámeni s těmito články, než budete pokračovat.

Hlavním rozdílem v robotech vyvinutých pro Microsoft Teams je způsob zpracování aktivit. Obslužná rutina aktivity Teams je odvozena od obslužné rutiny aktivity a zpracovává typy aktivit specifické pro Teams před zpracováním obecnějších typů aktivit.

Poznámka:

Sady SDK služby Bot Framework JavaScript, C# a Python budou nadále podporovány, ale sada Java SDK se vyřazuje s konečnou dlouhodobou podporou končící v listopadu 2023.

Stávající roboti sestavení pomocí sady Java SDK budou i nadále fungovat.

Při vytváření nových robotů zvažte použití aplikace Microsoft Copilot Studio a přečtěte si o výběru správného řešení copilotu.

Další informace najdete v tématu Budoucnost vytváření robotů.

Obslužná rutina aktivity Teams

Pokud chcete vytvořit robota pro Teams, odvozujte robota z třídy obslužné rutiny aktivity Teams. Když takový robot obdrží aktivitu, směruje aktivitu prostřednictvím různých obslužných rutin aktivit. Počáteční základní obslužná rutina je obslužná rutina otáčení a směruje aktivitu na obslužnou rutinu na základě typu aktivity. Obslužná rutina otáčení volá obslužnou rutinu , která je navržená pro zpracování konkrétního typu přijaté aktivity. Třída obslužné rutiny aktivity Teams je odvozena z třídy obslužné rutiny aktivity. Kromě typů aktivit, které může obslužná rutina aktivity zpracovat, třída obslužné rutiny aktivity Teams obsahuje další obslužné rutiny pro aktivity specifické pro Teams.

Robot, který je odvozený z obslužné rutiny aktivity Teams, je podobný robotu, který je odvozen přímo z třídy obslužné rutiny aktivity. Teams ale obsahuje další informace o conversationUpdate aktivitách a posílá aplikace Teams specifické invoke pro jednotlivé aktivity a event aktivity.

Když obslužná rutina aktivity Teams – robot obdrží aktivitu zpráv, jeho obslužná rutina pro otáčení směruje aktivitu příchozí zprávy do své OnMessageActivityAsync obslužné rutiny, podobně jako robot založený na obslužné rutině aktivity. Když ale robot Teams obdrží aktivitu aktualizace konverzace, zpracuje tato aktivita verze Teams obslužné OnConversationUpdateActivityAsync rutiny.

Pro většinu obslužných rutin aktivit specifických pro Teams neexistuje žádná základní implementace. Tyto obslužné rutiny budete muset přepsat a poskytnout odpovídající logiku robota.

Všechny obslužné rutiny aktivit popsané v části zpracování aktivit konverzací řízených událostmi pomocí článku obslužné rutiny aktivity budou dál fungovat stejně jako s robotem mimo Teams, s výjimkou zpracování přidávaných a odebraných aktivit členů, tyto aktivity se budou lišit v kontextu týmu, kde se nový člen přidá do týmu místo vlákna zprávy. Další informace najdete v tématu Aktivity aktualizace konverzací Teams.

Pokud chcete implementovat logiku pro tyto obslužné rutiny aktivit specifické pro Teams, přepíšete metody v robotovi.

Logika teams-robota

Logika robota zpracovává příchozí aktivity z jednoho nebo více kanálů robotů a generuje odchozí aktivity v reakci. To platí i pro robota odvozeného z třídy obslužné rutiny aktivity Teams, která nejprve kontroluje aktivity Teams, a pak předává všechny ostatní aktivity obslužné rutině aktivity služby Bot Framework.

Aktivity aktualizace instalace Teams

Přidejte obslužnou rutinu události aktualizace instalace, aby robot:

  • Odešle úvodní zprávu, když je nainstalovaná ve vlákně konverzace.
  • Vyčistíte data uživatelů a vláken při odinstalaci z vlákna.

Další informace najdete v tématu Událost aktualizace instalace v dokumentaci teams.

Aktivity aktualizace konverzací v Teams

Následující tabulka uvádí události Teams, které generují aktivitu aktualizace konverzace v robotovi. Článek aktualizace konverzací v Microsoft Teams popisuje, jak používat každou z těchto událostí.

Níže je seznam všech obslužných rutin aktivit Teams volaných z OnConversationUpdateActivityAsync metody obslužné rutiny aktivity Teams .

Typ události Obslužná rutina Podmínka Dokumentace k Teams
channelCreated OnTeamsChannelCreatedAsync Odesílá se při každém vytvoření nového kanálu v týmu, ve které je robot nainstalovaný. Kanál byl vytvořen.
channelDeleted OnTeamsChannelDeletedAsync Odesílá se pokaždé, když se kanál odstraní v týmu, ve které je robot nainstalovaný. Kanál byl odstraněn.
channelRenamed OnTeamsChannelRenamedAsync Odesílá se pokaždé, když se kanál přejmenuje v týmu, ve které je robot nainstalovaný. Kanál se přejmenoval.
channelRestored OnTeamsChannelRestoredAsync Odesláno pokaždé, když se kanál, který byl dříve odstraněn, obnoví v týmu, ve které už je váš robot nainstalovaný. Kanál se obnovil.
membersAdded OnTeamsMembersAddedAsync Ve výchozím nastavení volá metodu ActivityHandler.OnMembersAddedAsync . Odesláno při prvním přidání robota do konverzace a pokaždé, když se nový uživatel přidá do týmového nebo skupinového chatu, do kterého je robot nainstalovaný. Přidali jsme členy týmu.
membersRemoved OnTeamsMembersRemovedAsync Ve výchozím nastavení volá metodu ActivityHandler.OnMembersRemovedAsync . Odesláno, pokud je robot odebrán z týmu a pokaždé, když je každý uživatel odebrán z týmu, kterého je robot členem. Členové týmu se odebrali.
teamArchived OnTeamsTeamArchivedAsync Odešle se, když je tým, ve které je robot nainstalovaný, archivován. Tým archivoval.
teamDeleted OnTeamsTeamDeletedAsync Odešle se, když je tým, ve které je váš robot, odstraněný. Tým byl odstraněn.
teamRenamed OnTeamsTeamRenamedAsync Odesláno, když se tým, ve které je váš robot, přejmenoval. Tým byl přejmenován.
teamRestored OnTeamsTeamRestoredAsync Odesláno, když se obnoví dříve odstraněný tým, ve které je robot. Tým byl obnoven.
TeamUnarchived OnTeamsTeamUnarchivedAsync Odesílá se, když je tým, ve které je robot nainstalovaný, nearchivován. Tým je nearchivovaný.

Aktivity událostí Teams

Následující tabulka uvádí aktivity událostí specifické pro Teams, které Teams odesílá robotovi. Uvedené aktivity událostí jsou určené pro konverzační roboty v Teams.

Jedná se o obslužné rutiny aktivit událostí specifické pro OnEventActivityAsync Teams, které volají z obslužné rutiny aktivity Teams .

Typy událostí Obslužná rutina Popis
application/vnd.microsoft.meetingEnd OnTeamsMeetingEndAsync Robot je přidružený ke schůzce, která právě skončila.
application/vnd.microsoft.meetingStart OnTeamsMeetingStartAsync Robot je přidružený ke schůzce, která právě začala.

Aplikace Teams vyvolá aktivity

Následující tabulka uvádí aktivity volání specifické pro Teams, které Teams odesílá robotovi. Uvedené aktivity vyvolání jsou určené pro konverzační roboty v Teams. Sada SDK služby Bot Framework podporuje také volání specifická pro rozšíření zasílání zpráv. Další informace najdete v článku o rozšířeních zasílání zpráv v Teams.

Poznámka:

Dokumentace k platformě Microsoft Teams a klientská knihovna Teams JavaScript (TeamsJS) odkazují na moduly úloh jako modální dialogy. Další informace najdete v dialogových oknech .

Tady je seznam všech obslužných rutin aktivit Teams volaných z OnInvokeActivityAsync obslužné rutiny aktivity Teams :

Vyvolání typů Obslužná rutina Popis
actionableMessage/executeAction OnTeamsO365ConnectorCardActionAsync Akce karty konektoru Teams O365
CardAction.Invoke OnTeamsCardActionInvokeAsync Vyvolání akce karty Teams
fileConsent/invoke OnTeamsFileConsentAcceptAsync Souhlas se souborem Teams přijměte.
fileConsent/invoke OnTeamsFileConsentAsync Souhlas se souborem Teams.
fileConsent/invoke OnTeamsFileConsentDeclineAsync Souhlas se souborem Teams.
signin/verifyState OnTeamsSigninVerifyStateAsync Teams se přihlásí ke stavu ověření.
task/fetch OnTeamsTaskModuleFetchAsync Načtení modulu úkolů Teams
úkol/odeslání OnTeamsTaskModuleSubmitAsync Odeslání modulu úkolů Teams

Další kroky

Informace o vytváření robotů Teams najdete v dokumentaci pro vývojáře v Microsoft Teams.