Partilhar via

BotAdapter Classe

  • Referência

Definição

Espaço de Nomes:
Microsoft.Bot.Builder
Assemblagem:
Microsoft.Bot.Builder.dll
Pacote:
Microsoft.Bot.Builder v4.22.7

Representa um adaptador de bot que pode ligar um bot a um ponto final de serviço. Esta classe é abstrata.

public abstract class BotAdapter
type BotAdapter = class
Public MustInherit Class BotAdapter
Herança
Object
BotAdapter
Derivado

Observações

O adaptador de bot encapsula processos de autenticação e envia atividades para e recebe atividades do Bot Connector Service. Quando o bot recebe uma atividade, o adaptador cria um objeto de contexto, transmite-o para a lógica de aplicação do bot e envia respostas de volta para o canal do utilizador.

Utilize Use(IMiddleware) para adicionar IMiddleware objetos à coleção de middleware do adaptador. O adaptador processa e direciona as atividades que entram através do pipeline do middleware do bot para a lógica do seu bot e que depois saem novamente. À medida que cada atividade entra e sai do bot, cada peça de middleware pode inspecionar ou agir sobre a atividade, tanto antes como depois da lógica do bot ser executada.

Construtores

BotAdapter()

Inicializa uma nova instância da BotAdapter classe.

Campos

BotIdentityKey

O valor da cadeia para a chave de identidade do bot.
InvokeResponseKey

O valor-chave de qualquer InvokeResponseActivity que esteja no TurnState.
OAuthScopeKey

O valor da cadeia para a chave de âmbito OAuth.

Propriedades

MiddlewareSet

Obtém a coleção de middleware no pipeline do adaptador.
OnTurnError

Obtém ou define um processador de erros que pode capturar exceções no middleware ou na aplicação.

Métodos

ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

Envia uma mensagem proativa para uma conversação.
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)

Envia uma mensagem proativa para uma conversação.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)

Envia uma mensagem proativa para uma conversação.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)

Envia uma mensagem proativa para uma conversação.
ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)

Envia uma mensagem proativa para uma conversação.
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)

Envia uma mensagem proativa para uma conversação.
CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)

Cria uma conversação no canal especificado.
DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)

Quando substituída numa classe derivada, elimina uma atividade existente na conversação.
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

Cria um contexto de viragem e executa o pipeline de middleware para uma atividade TRUSTED recebida.
RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)

Inicia o processamento de atividade para a curva atual do bot.
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)

Quando substituído numa classe derivada, envia atividades para a conversação.
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)

Quando substituído numa classe derivada, substitui uma atividade existente na conversação.
Use(IMiddleware)

Adiciona middleware ao pipeline do adaptador.

Métodos da Extensão

UseBotState(BotAdapter, BotState[])

Adiciona middleware ao adaptador para registar um ou mais BotState objetos no contexto de ativação. O middleware regista os objetos de estado no contexto de ativação no início de cada curva.
UseState(BotAdapter, UserState, ConversationState, Boolean)
Obsoleto.

Regista objetos de estado de conversação e utilizador com o adaptador. Estes objetos estarão disponíveis através do TurnStatemétodo .Get<T>()
UseStorage(BotAdapter, IStorage)

Adiciona middleware ao adaptador para registar um IStorage objeto no contexto de ativação. O middleware regista os objetos de estado no contexto de ativação no início de cada curva.

Aplica-se a

Ver também