BotAdapter Classe

Definizione

Spazio dei nomi:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Pacchetto:: Microsoft.Bot.Builder v4.22.7

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un adattatore bot in grado di connettere un bot a un endpoint di servizio. Questa classe è astratta.

public abstract class BotAdapter

type BotAdapter = class

Public MustInherit Class BotAdapter

Ereditarietà: Object
BotAdapter

Derivato: Microsoft.Bot.Builder.Adapters.Facebook.FacebookAdapter

Microsoft.Bot.Builder.Adapters.Slack.SlackAdapter

Microsoft.Bot.Builder.Adapters.TestAdapter

Microsoft.Bot.Builder.Adapters.Twilio.TwilioAdapter

Microsoft.Bot.Builder.Adapters.Webex.WebexAdapter

Altro…

Commenti

L'adapter bot incapsula i processi di autenticazione e invia attività a e riceve attività dal servizio Bot Connector. Quando il bot riceve un'attività, l'adapter crea un oggetto contesto, lo passa alla logica dell'applicazione del bot e invia le risposte al canale dell'utente.

Usalo Use(IMiddleware) per aggiungere IMiddleware oggetti alla collezione middleware del tuo adattatore. L'adattatore elabora e indirizza le attività in arrivo attraverso la pipeline middleware del bot verso la logica del bot e poi di nuovo in uscita. Quando ogni attività entra ed esce dal bot, ogni componente del middleware può ispezionare o agire in risposta all'attività, prima e dopo l'esecuzione della logica del bot.

Costruttori

Nome	Descrizione
BotAdapter()	Inizializza una nuova istanza della classe BotAdapter.

Campi

Nome	Descrizione
BotIdentityKey	Il valore della stringa per la chiave identità del bot.
InvokeResponseKey	Il valore chiave per qualsiasi InvokeResponseActivity che si troverebbe sul TurnState.
OAuthScopeKey	Il valore della stringa per la chiave di scope OAuth.

Proprietà

Nome	Descrizione
MiddlewareSet	Ottiene la raccolta di middleware nella pipeline dell'adattatore.
OnTurnError	Ottiene o imposta un gestore di errore che può rilevare eccezioni nel middleware o nell'applicazione.

Metodi

Nome	Descrizione
ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Invia un messaggio proattivo a una conversazione.
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)	Invia un messaggio proattivo a una conversazione.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)	Invia un messaggio proattivo a una conversazione.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)	Invia un messaggio proattivo a una conversazione.
ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)	Invia un messaggio proattivo a una conversazione.
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)	Invia un messaggio proattivo a una conversazione.
CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)	Crea una conversazione sul canale specificato.
DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)	Quando sottoposto a override in una classe derivata, elimina un'attività esistente nella conversazione.
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Crea un contesto di turno ed esegue la pipeline middleware per un'attività TRUSTED in ingresso.
RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)	Avvia l'elaborazione delle attività per il turno corrente del bot.
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)	Quando sottoposto a override in una classe derivata, invia attività alla conversazione.
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)	Quando sottoposto a override in una classe derivata, sostituisce un'attività esistente nella conversazione.
Use(IMiddleware)	Aggiunge middleware alla pipeline dell'adapter.

Metodi di estensione

Nome	Descrizione
UseBotState(BotAdapter, BotState[])	Aggiunge middleware all'adattatore per registrare uno o più BotState oggetti nel contesto di turn. Il middleware registra gli oggetti di stato nel contesto del turno all'inizio di ogni turno.
UseState(BotAdapter, UserState, ConversationState, Boolean)	Obsoleti. Registra gli oggetti di stato utente e conversazione con l'adattatore. Questi oggetti saranno disponibili tramite il metodo .TurnState del Get<T>()contesto di turno.
UseStorage(BotAdapter, IStorage)	Aggiunge middleware all'adattatore per registrare un IStorage oggetto nel contesto del turn. Il middleware registra gli oggetti di stato nel contesto del turno all'inizio di ogni turno.

Si applica a