BotAdapter Klasse

Referenz

Definition

Namespace:: Microsoft.Bot.Builder

Assembly:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.18.1

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Botadapter dar, der einen Bot mit einem Dienstendpunkt verbinden kann. Diese Klasse ist abstrakt.

public abstract class BotAdapter

type BotAdapter = class

Public MustInherit Class BotAdapter

Vererbung: Object
BotAdapter

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

Mehr …

Hinweise

Der Botadapter kapselt Authentifizierungsprozesse ein und sendet Aktivitäten an bzw. empfängt Aktivitäten vom Bot Connector Service. Wenn Ihr Bot eine Aktivität empfängt, erstellt der Adapter ein Kontextobjekt, übergibt es an die Anwendungslogik Ihres Bots und sendet Antworten zurück an den Kanal des Benutzers.

Verwenden Sie Use(IMiddleware) zum Hinzufügen IMiddleware von Objekten zur Middlewaresammlung Ihres Adapters. Der Adapter verarbeitet und leitet eingehende Aktivitäten durch die Bot-Middlewarepipeline zur Logik Ihres Bots und wieder zurück. Während jede Aktivität den Bot durchläuft, kann jede Middleware die Aktivität überprüfen und beeinflussen, sowohl bevor als auch nachdem die Bot-Logik ausgeführt wurde.

Konstruktoren

BotAdapter()

Initialisiert eine neue Instanz der BotAdapter-Klasse.

Felder

BotIdentityKey	Der Zeichenfolgenwert für den Botidentitätsschlüssel.
InvokeResponseKey	Der Schlüsselwert für alle InvokeResponseActivity-Elemente, die sich im TurnState-Objekt finden würden.
OAuthScopeKey	Der Zeichenfolgenwert für den OAuth-Bereichsschlüssel.

Eigenschaften

MiddlewareSet	Ruft die Auflistung der Middleware in der Pipeline des Adapters ab.
OnTurnError	Ruft einen Fehlerhandler ab, der Ausnahmen in der Middleware oder Anwendung abfangen kann, oder legt diesen fest.

Methoden

ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Sendet eine proaktive Nachricht an eine Unterhaltung.
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)	Sendet eine proaktive Nachricht an eine Unterhaltung.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)	Sendet eine proaktive Nachricht an eine Unterhaltung.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)	Sendet eine proaktive Nachricht an eine Unterhaltung.
ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)	Sendet eine proaktive Nachricht an eine Unterhaltung.
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)	Sendet eine proaktive Nachricht an eine Unterhaltung.
CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)	Erstellt eine Unterhaltung im angegebenen Kanal.
DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)	Löscht beim Überschreiben in einer abgeleiteten Klasse eine vorhandene Aktivität in der Konversation.
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Erstellt einen Turnkontext und führt die Middlewarepipeline für eine eingehende TRUSTED-Aktivität aus.
RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)	Startet die Aktivitätsverarbeitung für den aktuellen Botwechsel.
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)	Wenn Sie in einer abgeleiteten Klasse überschrieben werden, werden Aktivitäten an die Konversation gesendet.
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)	Ersetzt beim Überschreiben in einer abgeleiteten Klasse eine vorhandene Aktivität in der Konversation.
Use(IMiddleware)	Fügt der Pipeline des Adapters Middleware hinzu.

Erweiterungsmethoden

UseBotState(BotAdapter, BotState[])	Fügt dem Adapter Middleware hinzu, um ein oder mehrere BotState Objekte im Turnkontext zu registrieren. Die Middleware registriert die Zustandsobjekte zu Beginn jedes Turns im Turnkontext.
UseState(BotAdapter, UserState, ConversationState, Boolean)	Veraltet. Registriert Benutzer- und Unterhaltungsstatusobjekte beim Adapter. Diese Objekte sind über die .Get<T>()-Methode des turn-Kontexts TurnStateverfügbar.
UseStorage(BotAdapter, IStorage)	Fügt dem Adapter Middleware hinzu, um ein IStorage Objekt im Turnkontext zu registrieren. Die Middleware registriert die Zustandsobjekte zu Beginn jedes Turns im Turnkontext.

Gilt für: