語言

BotAdapter 類別

定義

表示可將 Bot 連線至服務端點的 Bot 配接器。 這個類別是抽象的。

public abstract class BotAdapter
type BotAdapter = class
Public MustInherit Class BotAdapter
繼承
BotAdapter
衍生

備註

Bot 配接器會封裝驗證程式,並將活動傳送至 Bot Connector Service 並從中接收活動。 當 Bot 收到活動時,配接器會建立內容物件、將它傳遞給 Bot 的應用程式邏輯,並將回應傳回使用者的通道。

用 Use(IMiddleware) 來將物件加入 IMiddleware 你的轉接器的中介軟體集合。 介面卡會處理並引導透過機器人中介軟體管線將輸入的活動送到你的機器人邏輯,然後再返回。 當每個活動流入及流出 Bot 時,每個中介軟體元件都可以檢查活動,或在 Bot 邏輯執行之前和之後對活動進行處理。

建構函式

名稱 Description
BotAdapter()

初始化 BotAdapter 類別的新執行個體。

欄位

名稱 Description
BotIdentityKey

機器人身份鍵的字串值。

InvokeResponseKey

任何 InvokeResponseActivity 在 TurnState 上的關鍵值。

OAuthScopeKey

OAuth 範圍鍵的字串值。

屬性

名稱 Description
MiddlewareSet

取得配接器管線中的中間件集合。

OnTurnError

取得或設定錯誤處理程式,能捕捉中介軟體或應用程式中的異常。

方法

名稱 Description
ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

將主動式訊息傳送至交談。

ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)

將主動式訊息傳送至交談。

ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)

將主動式訊息傳送至交談。

ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)

將主動式訊息傳送至交談。

ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)

將主動式訊息傳送至交談。

ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)

將主動式訊息傳送至交談。

CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)

在指定的通道上建立交談。

DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)

在衍生類別中覆寫時,刪除交談中的現有活動。

ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

建立一個 Turn上下文,並執行中介軟體管線以處理一個被信任的活動。

RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)

啟動目前 Bot 回合的活動處理。

SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)

在衍生類別中覆寫時,將活動傳送至交談。

UpdateActivityAsync(ITurnContext, Activity, CancellationToken)

在衍生類別中覆寫時,取代交談中的現有活動。

Use(IMiddleware)

將中間件新增至配接器的管線。

擴充方法

名稱 Description
UseBotState(BotAdapter, BotState[])

在轉接器中加入中介軟體,以便在回合上下文中註冊一個或多個 BotState 物件。 中介軟體會在每回合開始時,登錄回合上下文中的狀態物件。

UseState(BotAdapter, UserState, ConversationState, Boolean)
已淘汰.

向介面卡註冊使用者及會話狀態物件。 這些物件將透過回合上下文的 TurnState.Get<T>() 方法 提供。

UseStorage(BotAdapter, IStorage)

在轉接器中加入中介軟體,以便在回合上下文中註冊 IStorage 物件。 中介軟體會在每回合開始時,登錄回合上下文中的狀態物件。

適用於

另請參閱