Csatornák referenciája

Cikk
11/14/2023

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Ez a cikk a Különböző Bot Framework-funkciók csatornatámogatását ismerteti:

Az egyes csatornák által küldött vagy fogadott tevékenységtípusok.
Az egyes csatornák megjeleníthető kártyatípusai, beleértve az adaptív kártyákat is.
Kártyaművelet és javasolt művelettámogatás minden csatornán.
A különböző tevékenységtípusok általános besorolása.

A tevékenységek és kártyák protokollszintű szerkezetéről a Bot Framework tevékenységével és kártyasémáival kapcsolatos részletes információk találhatók.

Az adaptív kártyák egy külön technológia. További információ: adaptivecards.io.

Tevékenységtámogatás csatorna szerint

Az alábbi táblázat azt jelzi, hogy egy adott csatorna küldhet-e egy adott tevékenységtípust a robotnak. A táblázatban a következő kifejezések jelentése a következő.

Term	Meaning
Igen	A robot ezt a tevékenységet a csatornáról fogadhatja.
Nem	A robot nem tudja fogadni ezt a tevékenységet a csatornáról.
Meghatározatlan	Jelenleg nincs meghatározva.

Channel	Kapcsolati kapcsolat frissítése	Beszélgetés frissítése	Beszélgetés vége	Esemény	Telepítési frissítés	Meghívás	Üzenet	Üzenet reakciója	Üzenetfrissítés	Üzenet törlése	Gépelés
Alexa	Nem	No	Yes	Yes	No	No	Yes	No	No	No	Nem
Azure Communication Services Chat	Nem	Yes	No	Yes	No	No	Yes	No	Yes	Yes	Igen
Direct Line	Nem	Yes	Yes	Yes	Yes	No	Yes	No	No	No	Igen
Direct Line Speech							Igen
E-mail	Nem	No	Nem	Meghatározatlan	Nem	No	Yes	No	No	No	Nem
Facebook	Nem	Yes	No	Yes	No	No	Yes	Yes	No	No	Nem
GroupMe	Nem	Yes	Nem	Meghatározatlan	Nem	No	Yes	No	No	No	Nem
LINE	Nem	Yes	No	Yes	No	No	Yes	No	No	No	Nem
Microsoft Teams	Nem	Yes	Nem	Meghatározatlan	Nem	Yes	Yes	Yes	Yes	Yes	Nem
Omnichannel							Igen
Outlook (előzetes verzió)							Igen
Keresés (előzetes verzió)							Igen
Slack	Nem	Yes	Nem	Meghatározatlan	Nem	No	Yes	No	Yes	Yes	Nem
Telegram	Nem	Yes	Nem	Meghatározatlan	Nem	No	Yes	No	Igen	Meghatározatlan	Nem
Twilio (SMS)	Nem	No	Nem	Meghatározatlan	Nem	No	Yes	No	No	No	Nem
Webes csevegés	Nem	Yes	Yes	Yes	Yes	No	Yes	No	No	No	Igen

A event tevékenységek támogatása a invoke tevékenység nevétől függően változik, és csatorna szerint változik.

Kártyatámogatás csatorna szerint

Az alábbi táblázat azt jelzi, hogy egy adott csatorna megjeleníthet-e egy adott kártyatípust. Még ha egy csatorna képes is megjeleníteni egy kártyatípust, előfordulhat, hogy a csatorna nem támogatja a kártya összes funkcióját. A robot kiadása előtt tesztelje a robot által elküldhető kártyák viselkedését.

A táblázatban a következő kifejezések jelentése a következő.

Term	Meaning
Igen	A kártya ezen a csatornán támogatott; azonban bármely adott csatorna csak a kártyaműveletek egy részét támogathatja, vagy korlátozhatja az egyes kártyákon engedélyezett műveletek számát.
Nem	A kártya ezen a csatornán nem támogatott.
Részleges	Részleges támogatás. Előfordulhat, hogy ez a csatorna nem jeleníti meg a kártyát, ha a kártya bemeneteket vagy gombokat tartalmaz. A támogatás szintje csatorna szerint változik.
Image	A rendszer képpé alakítja a kártyát.
SMS	A kártya formázatlan szöveggé alakul. Előfordulhat, hogy a hivatkozások nem kattinthatók, a képek nem jelennek meg, és előfordulhat, hogy a média nem játszható le. A támogatás szintje csatorna szerint változik.

Channel	Adaptív kártya	Animációs kártya	Hangkártya	Fő képkártya	Nyugtakártya	Bejelentkezési kártya	Miniatűr kártya	Videokártya
Alexa	Nem	No	No	Yes	No	Yes	No	Nem
Azure Communication Services Chat	Igen*	Igen	Yes	Yes	Yes	Yes	Yes	Igen
E-mail	Image	SMS	SMS	Igen	Yes	Yes	Igen	Szöveges
Facebook	Kép, részleges	Igen	Yes	Yes	Yes	Yes	Yes	Igen
GroupMe	Image	SMS	SMS	SMS	SMS	SMS	SMS	SMS
LINE	Kép, részleges	Igen	Szöveges	Igen	Yes	Yes	Igen	Szöveges
Microsoft Teams	Igen	No	No	Yes	Yes	Yes	Yes	Nem
Omnichannel
Outlook (előzetes verzió)
Keresés (előzetes verzió)
Slack	Image	Igen	Szöveges	SMS	Igen	Igen	Szöveges	SMS
Telegram	Kép, részleges	Igen	Szöveges	Igen	Yes	Yes	Yes	Igen
Twilio (SMS)	Image	SMS	No	Szöveges	SMS	SMS	SMS	Nem
Webes csevegés	Igen	Yes	Yes	Yes	Yes	Yes	Yes	Igen

Megjegyzés:

A Direct Line csatorna technikailag támogatja az összes kártyát, de az ügyfélen múlik, hogy implementálja őket.
*Az Azure Communication Services-csevegés esetében az adaptív kártyák csak az Azure Communication Services használati eseteiben támogatottak, az Azure Communication Services és a Teams közötti használati esetek esetében nem.

Kártyaművelet támogatása csatorna szerint

Az alábbi táblázat az adott csatorna által támogatott javasolt műveletek és kártyaműveletek maximális számát mutatja. A "Nincs" érték azt jelzi, hogy a művelettípus nem támogatott a csatornában.

Channel	Javasolt műveletek	Kártyaműveletek
Alexa	None	None
Azure Communication Services Chat
Direct Line	100	100
Direct Line Speech	100	100
E-mail	None	None
Facebook	11	3
GroupMe	None	None
LINE	13	99
Microsoft Teams	None	3
Omnichannel
Outlook (előzetes verzió)
Keresés (előzetes verzió)
Slack	None	100
Telegram	100	100
Twilio (SMS)	None	None
Webes csevegés	100	100

A kártyaműveletekkel kapcsolatos további információkért lásd : Események feldolgozása a gazdag kártyákon belül a Média hozzáadása üzenetekhez című cikkben.
A javasolt műveletekkel kapcsolatos további információkért tekintse meg a beviteli gombok használatát ismertető témakört.

Tevékenységkategóriák

A tevékenységek külön kategóriákra oszthatók. Az egyes tevékenységtípusok részletes leírását és az egyes tevékenységtípusok által tartalmazott információkat a Bot Framework tevékenységséma tartalmazza.

Welcome

Ebbe a kategóriába tartoznak a tevékenységek és contactRelationUpdate a conversationUpdate tevékenységek.

Számos csatorna küld beszélgetésfrissítési tevékenységeket.
- A robotok üdvözlő viselkedését gyakran a beszélgetésfrissítési tevékenység váltja ki. A megbízható üdvözlő viselkedés létrehozása azonban szükségessé teheti a beszélgetés vagy a felhasználói állapot használatát.
Egyes csatornák partnerkapcsolat-frissítési tevékenységeket küldenek.
- Ha a robot ezeket a csatornákat használja, előfordulhat, hogy a robot üdvözlő viselkedésében meg kell adnia a tevékenység logikáját.

Természetes kommunikációs

Ebbe a kategóriába tartoznak a message, messageReactionés endOfConversation a tevékenységek.

Minden csatorna küldhet és fogadhat üzeneteket.
- A párbeszédpaneleket használó robotok esetében az üzenettevékenységeket általában át kell adni a párbeszédpanelre.
Egyes csatornák üzenetek reakciótevékenységeket küldhetnek és fogadhatnak.
- A robot kialakításától függően előfordulhat, hogy üzenetreakciós tevékenységeket ad át egy párbeszédpanelen.
- Az üzenetválasz-tevékenységek azonosító alapján hivatkoznak a korábbi üzenetekre.
A beszélgetés vége a beszélgetés végét jelzi a feladó szemszögéből.
- A beszélgetési tevékenységek vége a robotok közötti kommunikációban használatos a készségek terén.

Tipp.

Az üzenet reakciója olyan dolgokat tartalmaz, mint egy hüvelykujj egy korábbi megjegyzéshez. Ezek sorrenden kívül is történhetnek, így a gombokhoz hasonlónak tekinthetők. Ezt a tevékenységtípust a Teams-csatorna küldheti el.

Üzenet frissítése és törlése

Ebbe a kategóriába tartoznak a tevékenységek és messageDelete a messageUpdate tevékenységek.

A Teams támogatja az üzenetfrissítési és -törlési tevékenységeket.

Alkalmazás bővíthetősége

Ebbe a kategóriába tartoznak a tevékenységek és invoke a event tevékenységek. A tevékenység jelentését a mező határozza name meg, amely a csatorna hatókörén belül értelmezhető.

Az ügyfél és a kiszolgáló tulajdonában lévő alkalmazások eseménytevékenységekkel kommunikálhatnak programozott információkkal az ügyfél és a kiszolgáló között.
- Az eseménytevékenységek, mint a legtöbb tevékenységtípus, aszinkronok.
- A Direct Line és a webchat bővíthetőségi mechanizmusként használják az eseménytevékenységeket.
A meghívási tevékenységek egy alkalmazásra vonatkoznak, és nem olyasmire, amit az ügyfél definiálna.
- A többi tevékenységtípustól eltérően a meghívási tevékenységek szinkronok. (A meghívás jelenleg az egyetlen tevékenységtípus, amely a robot kérés-válasz viselkedését aktiválja.)
- A Microsoft Teams meghívási tevékenységeket használ, és meghatároz néhány Teams-specifikus meghívási tevékenységet.

Authentication

Ahhoz, hogy az OAuth-üzenet párbeszédablakokkal működjön, a TeamsVerification meghívási tevékenységet továbbítani kell a párbeszédpanelre.

Uncategorized (Kategorizálatlan)

A installationUpdate, typingés handoff tevékenységek nem illeszkednek megfelelően a többi kategóriába.

A telepítési frissítési tevékenységek egy robot telepítését vagy eltávolítását jelentik egy csatorna szervezeti egységén belül.
A gépelési tevékenységek egy felhasználó vagy egy robot folyamatos bemenetét jelölik.
A átadási tevékenységek a robot elemei közötti fókusz változását kérik vagy jelzik. Az átadási tevékenység eltér egy "handoff" nevű eseménytevékenységtől .

Használaton kívül (beleértve a fizetésre vonatkozó meghívást is)

Ezek a tevékenységtípusok már nincsenek használatban:

deleteUserData
handoff
ping
Address Hivatkozhat
PaymentRequest Hivatkozhat

További információk

Minden csatorna küldhet és fogadhat message tevékenységeket.