Referenční informace ke kanálům
PLATÍ PRO: SDK v4
Tento článek popisuje podporu kanálů pro různé funkce bot Frameworku:
- Typy aktivit, které každý kanál může odesílat nebo přijímat.
- Typy karet, které každý kanál může zobrazit, včetně adaptivních karet.
- Akce karty a navrhovaná podpora akcí v jednotlivých kanálech
- Obecná klasifikace různýchtypůch
Podrobné informace o struktuře aktivit a karet na úrovni protokolu najdete v tématu Aktivity bot Framework a schémata karet.
Adaptivní karty jsou samostatnou technologií. Další informace najdete v tématu adaptivecards.io.
Podpora aktivit podle kanálu
Následující tabulka udává, jestli daný kanál může robotovi odeslat daný typ aktivity. V tabulce mají následující termíny následující významy.
| Období | Význam |
|---|---|
| Ano | Robot může tuto aktivitu přijímat z kanálu. |
| No | Robot nemůže tuto aktivitu přijímat z kanálu. |
| Neurčeno | Aktuálně není definováno. |
| Kanál | Aktualizace vztahů kontaktů | Aktualizace konverzací | Konec konverzace | Událost | Aktualizace instalace | Vyvolání | Zpráva | Reakce na zprávu | Aktualizace zprávy | Odstranění zprávy | Psaní |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Alexa | No | No | Ano | Ano | No | No | Ano | No | No | No | Ne |
| Azure Communication Services | No | Ano | Ne | Ano | No | No | Ano | Ne | Ano | Ano | Yes |
| Direct Line | No | Ano | Ano | Ano | Ano | Ne | Ano | No | No | No | Ano |
| Direct Line Speech | Ano | ||||||||||
| No | No | Ne | Neurčeno | No | No | Ano | No | No | No | Ne | |
| No | Ano | Ne | Ano | No | No | Ano | Ano | No | No | Ne | |
| GroupMe | No | Ano | No | Neurčeno | No | No | Ano | No | No | No | Ne |
| LINE | No | Ano | Ne | Ano | No | No | Ano | No | No | No | Ne |
| Microsoft Teams | No | Ano | No | Neurčeno | No | Ano | Ano | Ano | Ano | Ano | No |
| Omnikanál | Ano | ||||||||||
| Outlook (Preview) | Ano | ||||||||||
| Vyhledávání (Preview) | Ano | ||||||||||
| Slack | No | Ano | No | Neurčeno | No | No | Ano | Ne | Ano | Ano | No |
| Telegram | No | Ano | No | Neurčeno | No | No | Ano | Ne | Ano | Neurčeno | No |
| Twilio (SMS) | No | No | Ne | Neurčeno | No | No | Ano | No | No | No | Ne |
| Webový chat | No | Ano | Ano | Ano | Ano | Ne | Ano | No | No | No | Ano |
event Podpora a invoke aktivity se liší podle názvu aktivity a liší se podle kanálu.
Podpora karty dle kanálu
Následující tabulka udává, jestli daný kanál může vykreslit daný typ karty. I když kanál může vykreslit typ karty, nemusí kanál podporovat všechny funkce na kartě. Než robota uvolníte, otestujte chování každé karty, které robot může odeslat.
V tabulce mají následující termíny následující významy.
| Období | Význam |
|---|---|
| Ano | Karta je podporována v tomto kanálu; Každý daný kanál však může podporovat pouze podmnožinu akcí karty nebo může omezit počet akcí povolených na každé kartě. |
| No | Karta není v tomto kanálu podporovaná. |
| Částečná | Částečná podpora. Tento kanál nemusí kartu zobrazit, pokud karta obsahuje vstupy nebo tlačítka. Úroveň podpory se liší podle kanálu. |
| Image | Karta se převede na obrázek. |
| Text | Karta se převede na neformátovaný text. Odkazy nemusí být kliknutelné, obrázky se nemusí zobrazovat a multimédia nemusí být přehrátelná. Úroveň podpory se liší podle kanálu. |
| Kanál | Adaptivní karta | Animační karta | Karta zvuku | Karta hero | Karta účtenky | Přihlašovací karta | Karta miniatury | Grafická karta |
|---|---|---|---|---|---|---|---|---|
| Alexa | No | No | No | Ano | Ne | Ano | No | Ne |
| Azure Communication Services | Ano* | Ano | Ano | Ano | Ano | Ano | Ano | Yes |
| Image | Text | Text | Ano | Ano | Ano | Yes | Text | |
| Obrázek, částečný | Ano | Ano | Ano | Ano | Ano | Ano | Yes | |
| GroupMe | Image | Text | Text | Text | Text | Text | Text | Text |
| LINE | Obrázek, částečný | Ano | Text | Ano | Ano | Ano | Yes | Text |
| Microsoft Teams | Yes | No | No | Ano | Ano | Ano | Ano | No |
| Omnikanál | ||||||||
| Outlook (Preview) | ||||||||
| Vyhledávání (Preview) | ||||||||
| Slack | Image | Ano | Text | Text | Ano | Yes | Text | Text |
| Telegram | Obrázek, částečný | Ano | Text | Ano | Ano | Ano | Ano | Yes |
| Twilio (SMS) | Image | Text | No | Text | Text | Text | Text | No |
| Webový chat | Ano | Ano | Ano | Ano | Ano | Ano | Ano | Ano |
Poznámka:
- Kanál Direct Line technicky podporuje všechny karty, ale je na klientovi, aby je implementoval.
- *V případě chatu služby Azure Communication Services se adaptivní karty podporují jenom v případech použití služeb Azure Communication Services, a ne pro případy použití Azure Communication Services do Teams.
Podpora akcí karet podle kanálu
Následující tabulka ukazuje maximální počet navrhovaných akcí a akcí karet, které daný kanál podporuje. Hodnota None označuje, že typ akce není v kanálu podporovaný.
| Kanál | Navrhované akce | Akce karet |
|---|---|---|
| Alexa | Nic | Nic |
| Azure Communication Services | ||
| Direct Line | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| Nic | Nic | |
| 11 | 3 | |
| GroupMe | Nic | Nic |
| LINE | 13 | 99 |
| Microsoft Teams | Nic | 3 |
| Omnikanál | ||
| Outlook (Preview) | ||
| Vyhledávání (Preview) | ||
| Slack | Nic | 100 |
| Telegram | 100 | 100 |
| Twilio (SMS) | Nic | Nic |
| Webový chat | 100 | 100 |
- Další informace o akcích karet naleznete v tématu Zpracování událostí v bohatých kartách v článku Přidání média do zpráv .
- Další informace o navrhovaných akcích najdete v tématu Použití tlačítek pro vstup.
Kategorie aktivit
Aktivity je možné rozdělit do samostatných kategorií. Podrobný popis jednotlivých typů aktivit a informace, které jednotlivé typy aktivit obsahují, najdete ve schématu aktivit služby Bot Framework.
Vítejte
Tato kategorie zahrnuje aktivity conversationUpdate a contactRelationUpdate aktivity.
- Mnoho kanálů odesílá aktivity aktualizace konverzací.
- Chování přivítání robota se často aktivuje aktivitou aktualizace konverzace. Vytváření spolehlivého uvítacího chování však může vyžadovat použití konverzace nebo stavu uživatele.
- Některé kanály odesílají aktivity aktualizace relací kontaktů.
- Pokud robot tyto kanály používá, možná budete muset do uvítacího chování robota zahrnout logiku této aktivity.
Konverzační
Tato kategorie zahrnuje , messagemessageReactiona endOfConversation aktivity.
- Všechny kanály můžou odesílat a přijímat aktivity zpráv.
- U robotů, kteří používají dialogy, by se do dialogového okna měly obecně předávat aktivity zpráv.
- Některé kanály můžou odesílat a přijímat aktivity reakce na zprávy.
- V závislosti na návrhu robota můžete do dialogového okna předat aktivity reakce na zprávy.
- Aktivity reakce na zprávy odkazují na předchozí zprávy podle ID.
- Ukončení konverzací signalizují konec konverzace z pohledu odesílatele.
- Ke komunikaci mezi roboty se používají aktivity na konci konverzace pro dovednosti.
Tip
Reakce na zprávu obsahuje věci, jako je palec nahoru u předchozího komentáře. Můžou se stát mimo pořadí, takže si je můžete představit jako podobná tlačítkům. Tento typ aktivity může odesílat kanál Teams.
Aktualizace a odstranění zprávy
Tato kategorie zahrnuje aktivity messageUpdate a messageDelete aktivity.
- Teams podporuje aktivity aktualizace a odstraňování zpráv.
Rozšiřitelnost aplikací
Tato kategorie zahrnuje aktivity event a invoke aktivity.
Význam aktivity je definován jeho name polem, které je smysluplné v rámci oboru kanálu.
- Aplikace, která vlastní klienta i server, může pomocí aktivit událostí komunikovat programové informace mezi klientem a serverem.
- Aktivity událostí, jako je většina typů aktivit, jsou asynchronní.
- Direct Line a Webový chat používají aktivity událostí jako mechanismus rozšiřitelnosti.
- Aktivity vyvolání jsou specifické pro aplikaci a ne něco, co by klient definoval.
- Vyvolání aktivit, na rozdíl od jiných typů aktivit, jsou synchronní. (Vyvolání je aktuálně jediným typem aktivity, který v robotovi aktivuje chování odpovědi na požadavek.)
- Microsoft Teams používá aktivity vyvolání a definuje několik aktivit volání specifických pro Teams.
Ověřování
Aby výzva OAuth fungovala s dialogovými okny, TeamsVerification musí se aktivita vyvolání předat do dialogového okna.
Nezařazeno do kategorie
Aktivity installationUpdatea handoff , typingkteré se smysluplně nevejdou do ostatních kategorií.
- Aktivity aktualizace instalace představují instalaci nebo odinstalaci robota v organizační jednotce kanálu.
- Aktivity psaní představují průběžný vstup od uživatele nebo robota.
- Žádost o předání aktivit nebo signál změny fokusu mezi prvky v robotovi Aktivita předání se liší od aktivity události , která má název "předání".
Nevyužité (zahrnuje volání specifické pro platbu)
Tyto typy aktivit se už nepoužívají:
deleteUserDatahandoffpingAddressvyvolatPaymentRequestvyvolat
Další informace
Všechny kanály můžou odesílat a přijímat message aktivity.
Tip
Když do robota přidáváte podporu kanálu, seznamte se s dokumentací pro vývojáře kanálu. Každý kanál má různá omezení pro různé aspekty konverzace. Mezi rozdíly patří:
- Kolik času robot musí zpracovat každý požadavek HTTP.
- Jestli robot může odeslat aktivitu, která není v reakci na konkrétní aktivitu uživatele.
- Kolik zpráv může robot odeslat v daném časovém rámci.
- Jak se karta vykresluje a které karty se podporují.