Informazioni di riferimento sui canali
SI APPLICA A: SDK v4
Questo articolo illustra il supporto del canale per varie funzionalità di Bot Framework:
- I tipi di attività che ogni canale può inviare o ricevere.
- I tipi di scheda possono visualizzare ogni canale, incluse le schede adattive.
- Azione scheda e supporto dell'azione suggerita in ogni canale.
- Classificazione generale dei diversi tipi di attività.
Per informazioni dettagliate sulla struttura delle attività e delle schede a livello di protocollo, vedere l'attività e gli schemi delle schede di Bot Framework.
Le schede adattive sono una tecnologia separata. Per altre informazioni, vedere adaptivecards.io.
Supporto delle attività in base al canale
La tabella seguente indica se un determinato canale può inviare un determinato tipo di attività al bot. All'interno della tabella, i termini seguenti hanno i significati seguenti.
| Termine | Significato |
|---|---|
| Sì | Il bot può ricevere questa attività dal canale. |
| No | Il bot non può ricevere questa attività dal canale. |
| Indeterminato | Attualmente indeterminato. |
| Canale | Aggiornamento delle relazioni di contatto | Aggiornamento della conversazione | Fine della conversazione | Event | Aggiornamento dell'installazione | Invoke | Message | Reazione al messaggio | Aggiornamento dei messaggi | Eliminazione del messaggio | Digitazione |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Alexa | No | No | Sì | Sì | No | No | Sì | No | No | No | No |
| Azure Communication Services Chat | No | Sì | No | Sì | No | No | Sì | No | Sì | Sì | Sì |
| Direct Line | No | Sì | Sì | Sì | Sì | No | Sì | No | No | No | Sì |
| Direct Line Speech | Sì | ||||||||||
| Messaggio e-mail | No | No | No | Indeterminato | No | No | Sì | No | No | No | No |
| No | Sì | No | Sì | No | No | Sì | Sì | No | No | No | |
| GroupMe | No | Sì | No | Indeterminato | No | No | Sì | No | No | No | No |
| LINE | No | Sì | No | Sì | No | No | Sì | No | No | No | No |
| Microsoft Teams | No | Sì | No | Indeterminato | No | Sì | Sì | Sì | Sì | Sì | No |
| Multicanale | Sì | ||||||||||
| Outlook (anteprima) | Sì | ||||||||||
| Ricerca (anteprima) | Sì | ||||||||||
| Slack | No | Sì | No | Indeterminato | No | No | Sì | No | Sì | Sì | No |
| Telegram | No | Sì | No | Indeterminato | No | No | Sì | No | Sì | Indeterminato | No |
| Twilio (SMS) | No | No | No | Indeterminato | No | No | Sì | No | No | No | No |
| Chat Web | No | Sì | Sì | Sì | Sì | No | Sì | No | No | No | Sì |
Il supporto per event le attività e invoke varia in base al nome dell'attività e varia in base al canale.
Supporto delle schede per canale
La tabella seguente indica se un determinato canale può eseguire il rendering di un determinato tipo di scheda. Anche se un canale può eseguire il rendering di un tipo di scheda, il canale potrebbe non supportare tutte le funzionalità della scheda. Prima di rilasciare il bot, testare il comportamento di ogni scheda che il bot può inviare.
All'interno della tabella, i termini seguenti hanno i significati seguenti.
| Termine | Significato |
|---|---|
| Sì | La scheda è supportata in questo canale; Tuttavia, qualsiasi canale specifico può supportare solo un subset di azioni scheda o può limitare il numero di azioni consentite in ogni scheda. |
| No | La scheda non è supportata in questo canale. |
| Parziale | Supporto parziale. Questo canale potrebbe non visualizzare la scheda se la scheda contiene input o pulsanti. Il livello di supporto varia in base al canale. |
| Immagine | La scheda viene convertita in immagine. |
| Testo | La scheda viene convertita in testo non formattato. I collegamenti potrebbero non essere selezionabili, le immagini potrebbero non essere visualizzate e i supporti potrebbero non essere riproducibili. Il livello di supporto varia in base al canale. |
| Canale | Scheda adattiva | Scheda animazione | Scheda audio | Scheda banner | Scheda di ricevuta | Scheda di accesso | Scheda anteprima | Scheda video |
|---|---|---|---|---|---|---|---|---|
| Alexa | No | No | No | Sì | No | Sì | No | No |
| Azure Communication Services Chat | Sì* | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Messaggio e-mail | Immagine | Testo | Testo | Sì | Sì | Sì | Sì | Testo |
| Immagine, parziale | Sì | Sì | Sì | Sì | Sì | Sì | Sì | |
| GroupMe | Immagine | Testo | Testo | Testo | Testo | Testo | Testo | Testo |
| LINE | Immagine, parziale | Sì | Testo | Sì | Sì | Sì | Sì | Testo |
| Microsoft Teams | Sì | No | No | Sì | Sì | Sì | Sì | No |
| Multicanale | ||||||||
| Outlook (anteprima) | ||||||||
| Ricerca (anteprima) | ||||||||
| Slack | Image | Sì | Testo | Testo | Sì | Sì | Testo | Testo |
| Telegram | Immagine, parziale | Sì | Testo | Sì | Sì | Sì | Sì | Sì |
| Twilio (SMS) | Immagine | Testo | No | Testo | Testo | Testo | Testo | No |
| Chat Web | Sì | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
Nota
- Il canale Direct Line supporta tecnicamente tutte le schede, ma spetta al client implementarle.
- *Per Servizi di comunicazione di Azure Chat, le schede adattive sono supportate solo nei casi d'uso Servizi di comunicazione di Azure e non per i casi d'uso di Servizi di comunicazione di Azure a Teams.
Supporto delle azioni scheda per canale
La tabella seguente illustra il numero massimo di azioni suggerite e azioni della scheda supportate da un determinato canale. Un valore "None" indica che il tipo di azione non è supportato nel canale.
| Canale | Azioni consigliate | Azioni scheda |
|---|---|---|
| Alexa | None | None |
| Azure Communication Services Chat | ||
| Direct Line | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| None | None | |
| 11 | 3 | |
| GroupMe | None | None |
| LINE | 13 | 99 |
| Microsoft Teams | None | 3 |
| Multicanale | ||
| Outlook (anteprima) | ||
| Ricerca (anteprima) | ||
| Slack | None | 100 |
| Telegram | 100 | 100 |
| Twilio (SMS) | None | None |
| Chat Web | 100 | 100 |
- Per altre informazioni sulle azioni delle schede, vedere Elaborare gli eventi all'interno di schede avanzate nell'articolo Aggiungere elementi multimediali ai messaggi .
- Per altre informazioni sulle azioni suggerite, vedere Come usare i pulsanti per l'input.
Categorie di attività
Le attività possono essere suddivise in categorie separate. Per una descrizione dettagliata di ogni tipo di attività e delle informazioni contenute in ogni tipo di attività, vedere lo schema dell'attività di Bot Framework.
Introduzione
Questa categoria include le conversationUpdate attività e contactRelationUpdate .
- Molti canali inviano attività di aggiornamento della conversazione.
- Spesso, il comportamento di benvenuto del bot viene attivato dall'attività di aggiornamento della conversazione. Tuttavia, la produzione di un comportamento di benvenuto affidabile potrebbe richiedere l'uso della conversazione o dello stato dell'utente.
- Alcuni canali inviano attività di aggiornamento delle relazioni di contatto.
- Se il bot usa questi canali, potrebbe essere necessario includere la logica per questa attività nel comportamento di benvenuto del bot.
Conversazione
Questa categoria include le messageattività , messageReactione endOfConversation .
- Tutti i canali possono inviare e ricevere attività di messaggio.
- Per i bot che usano i dialoghi, le attività dei messaggi devono in genere essere passate nella finestra di dialogo.
- Alcuni canali possono inviare e ricevere attività di reazione ai messaggi.
- A seconda della progettazione del bot, è possibile passare le attività di reazione al messaggio in un dialogo.
- Le attività di reazione al messaggio fanno riferimento ai messaggi precedenti in base all'ID.
- La fine delle attività di conversazione segnala la fine di una conversazione dal punto di vista del mittente.
- Le attività di fine conversazione vengono usate nella comunicazione da bot a bot per le competenze.
Suggerimento
Una reazione al messaggio include elementi come un pollice su un commento precedente. Possono verificarsi non in ordine e possono quindi essere considerate simili a pulsanti. Questo tipo di attività può essere inviato dal canale Teams.
Aggiornamento ed eliminazione dei messaggi
Questa categoria include le messageUpdate attività e messageDelete .
- Teams supporta le attività di aggiornamento ed eliminazione dei messaggi.
Estendibilità dell'applicazione
Questa categoria include le event attività e invoke .
Il significato dell'attività è definito dal relativo name campo, che è significativo nell'ambito di un canale.
- Un'applicazione proprietaria sia del client che del server può usare attività di evento per comunicare informazioni a livello di codice tra il client e il server.
- Le attività degli eventi, come la maggior parte dei tipi di attività, sono asincrone.
- Direct Line e chat Web usare le attività degli eventi come meccanismo di estendibilità.
- Le attività invoke sono specifiche di un'applicazione e non un client definisce.
- Le attività invoke, a differenza di altri tipi di attività, sono sincrone. Invoke è attualmente l'unico tipo di attività che attiva un comportamento request-reply nel bot.
- Microsoft Teams usa le attività invoke e definisce alcune attività di richiamo specifiche di Teams.
Authentication
Affinché il prompt OAuth funzioni con i dialoghi, l'attività TeamsVerification invoke deve essere inoltrata alla finestra di dialogo.
Senza categoria
Le installationUpdateattività , typinge handoff non rientrano in modo significativo nelle altre categorie.
- Le attività di aggiornamento dell'installazione rappresentano un'installazione o una disinstallazione di un bot all'interno di un'unità organizzativa di un canale.
- Le attività di digitazione rappresentano l'input in corso da un utente o un bot.
- Le attività di handoff richiedono o segnalano una modifica dello stato attivo tra gli elementi all'interno di un bot. L'attività handoff è diversa da un'attività evento con il nome "handoff".
Uso non usato (include un richiamo specifico per il pagamento)
Questi tipi di attività non sono più in uso:
deleteUserDatahandoffpingAddressevocarePaymentRequestevocare
Informazioni aggiuntive
Tutti i canali possono inviare e ricevere message attività.
Suggerimento
Quando si aggiunge il supporto per un canale al bot, acquisire familiarità con la documentazione per sviluppatori del canale. Ogni canale presenta limitazioni diverse per vari aspetti di una conversazione. Alcune delle differenze includono:
- Quanto tempo il bot deve gestire ogni richiesta HTTP.
- Indica se un bot può inviare un'attività che non è in risposta a un'attività utente specifica.
- Numero di messaggi che il bot può inviare entro un determinato intervallo di tempo.
- Rendering di una scheda e delle schede supportate.