Idioma

BotAdapter Classe

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 endpoint de serviço. Esta aula é 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 e recebe atividades do Bot Connector Service. Quando o bot recebe uma atividade, o adaptador cria um objeto de contexto, passa-o para a lógica do aplicativo do bot e envia respostas de volta para o canal do usuário.

Use Use(IMiddleware) para adicionar IMiddleware objetos à coleção de middleware do seu adaptador. O adaptador processa e direciona as atividades recebidas através do pipeline middleware do bot para a lógica do bot e depois volta a sair. À 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

Name Descrição
BotAdapter()

Inicializa uma nova instância da BotAdapter classe.

Campos

Name Descrição
BotIdentityKey

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

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

O valor da string para a chave de escopo OAuth.

Propriedades

Name Descrição
MiddlewareSet

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

Recebe ou define um gestor de erros que pode detetar exceções no middleware ou aplicação.

Métodos

Name Descrição
ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

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

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

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

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

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

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

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

Quando é sobreposto numa classe derivada, apaga uma atividade existente na conversa.
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

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

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

Quando é sobreposto numa classe derivada, envia atividades para a conversa.
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)

Quando é sobreposto numa classe derivada, substitui uma atividade já existente na conversa.
Use(IMiddleware)

Adiciona middleware ao pipeline do adaptador.

Métodos da Extensão

Name Descrição
UseBotState(BotAdapter, BotState[])

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

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

Adiciona middleware ao adaptador para registar um IStorage objeto no contexto do turn. O middleware regista os objetos de estado no contexto do turno no início de cada turno.

Aplica-se a

Ver também