BotAdapter Klasa

Definicja

Przestrzeń nazw:: Microsoft.Bot.Builder

Zestaw:: Microsoft.Bot.Builder.dll

Pakiet:: Microsoft.Bot.Builder v4.22.7

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje adapter bota, który może połączyć bota z punktem końcowym usługi. Ta klasa jest abstrakcyjna.

public abstract class BotAdapter

type BotAdapter = class

Public MustInherit Class BotAdapter

Dziedziczenie: Object
BotAdapter

Pochodne: 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

Więcej…

Uwagi

Karta bota hermetyzuje procesy uwierzytelniania i wysyła działania do i odbiera działania z usługi Bot Connector Service. Gdy bot odbiera działanie, karta tworzy obiekt kontekstu, przekazuje go do logiki aplikacji bota i wysyła odpowiedzi z powrotem do kanału użytkownika.

Użyj Use(IMiddleware) do dodawania IMiddleware obiektów do kolekcji middleware twojego adaptera. Adapter przetwarza i kieruje przychodzące aktywności przez pipeline middleware bota do logiki bota, a następnie z powrotem na zewnątrz. Gdy poszczególne działania wpływają do bota i z niego wypływają, oprogramowanie pośredniczące może je sprawdzać i wykonywać względem nich akcje — zarówno przed uruchomieniem logiki bota, jak i po jej uruchomieniu.

Konstruktory

Nazwa	Opis
BotAdapter()	Inicjuje nowe wystąpienie klasy BotAdapter.

Pola

Nazwa	Opis
BotIdentityKey	Wartość ciągu dla klucza tożsamości bota.
InvokeResponseKey	Wartość kluczowa dla każdej aktywności InvokeResponse, która znajduje się w TurnState.
OAuthScopeKey	Wartość ciągu dla klucza zakresu OAuth.

Właściwości

Nazwa	Opis
MiddlewareSet	Pobiera kolekcję middleware z pipeline'u adaptera.
OnTurnError	Pobiera lub ustawia obsługę błędów, która może wykrywać wyjątki w middleware lub aplikacji.

Metody

Nazwa	Opis
ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Wysyła proaktywną wiadomość do konwersacji.
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)	Wysyła proaktywną wiadomość do konwersacji.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)	Wysyła proaktywną wiadomość do konwersacji.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)	Wysyła proaktywną wiadomość do konwersacji.
ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)	Wysyła proaktywną wiadomość do konwersacji.
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)	Wysyła proaktywną wiadomość do konwersacji.
CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)	Tworzy rozmowę na określonym kanale.
DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)	Po nadpisaniu w klasie pochodnej, usuwa istniejącą aktywność w rozmowie.
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Tworzy kontekst tury i uruchamia pipeline middleware dla nadchodzącej ZAUFANEJ aktywności.
RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)	Rozpoczyna przetwarzanie aktywności na bieżącą turę bota.
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)	Gdy zostanie przejęty w klasie pochodnej, wysyła aktywności do rozmowy.
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)	Gdy zostanie nadpisana w klasie pochodnej, zastępuje istniejącą aktywność w rozmowie.
Use(IMiddleware)	Dodaje middleware do pipeline'u adaptera.

Metody rozszerzania

Nazwa	Opis
UseBotState(BotAdapter, BotState[])	Dodaje middleware do adaptera, aby rejestrować jeden lub więcej BotState obiektów w kontekście tury. Middleware rejestruje obiekty stanu w kontekście tury na początku każdej tury.
UseState(BotAdapter, UserState, ConversationState, Boolean)	Przestarzałe. Rejestruje obiekty stanu użytkownika i rozmowy za pomocą adaptera. Obiekty te będą dostępne za pomocą metody .Get<T>() w kontekście TurnStatetur.
UseStorage(BotAdapter, IStorage)	Dodaje middleware do adaptera, aby rejestrować IStorage obiekt w kontekście tury. Middleware rejestruje obiekty stanu w kontekście tury na początku każdej tury.

Dotyczy