調適型對話中的動作 - 參考指南

適用于： SDK v4

本文列出 Bot Framework SDK 中定義的動作，依其一般用途分組。

• 如需本主題的簡介，請參閱 Composer 檔中的 Actions 主題。

回應和問題

動作名稱	動作標題	描述
Ask	傳送回應以詢問問題	使用活動作為提示使用者的方式。
AttachmentInput	提示輸入檔案或附件	詢問使用者是否有檔案或影像。
ChoiceInput	使用多重選取提示	要求使用者從挑選清單中挑選。
ConfirmInput	確認提示	詢問使用者進行確認（是-否問題）。
DateTimeInput	提示日期或時間	詢問使用者是否有日期或時間值。
NumberInput	提示輸入數位	要求使用者輸入數值。
OAuthInput	OAuth 登入	要求使用者使用 OAuth 識別提供者登入。
SendActivity	傳送回應	傳送活動，例如對使用者的回應。
TextInput	提示輸入文字	要求使用者輸入回應。

條件和迴圈

條件式動作旨在協助您的 Bot 根據您所建立的任何預先定義條件做出決策。 這些動作是由一組具有布林運算式的條件陳述式所指定，其會評估為 true 或 false 的布林值。

其餘動作與迴圈語句相關，可讓您針對集合中的每個元素重複執行程式碼區塊。

動作名稱	動作標題	描述
BreakLoop	中斷迴圈	結束封入迴圈。
ContinueLoop	Continue 迴圈	啟動封入迴圈的下一個反復專案。
ForEach	迴圈：針對每個專案	在集合中的每個專案上執行一組動作。
ForEachPage	迴圈：針對每個頁面 （多個專案）	在集合中的每個頁面（專案子集）上執行一組動作。
IfCondition	分支：If/else	根據布林運算式執行一組動作。
SwitchCondition	分支：交換器（多個選項）	根據屬性的值執行一組動作。

對話方塊管理

動作名稱	動作標題	描述
BeginDialog	開始新的對話	開始新的對話方塊，並將其新增至堆疊。 您可以提供新對話方塊的輸入參數。 當新的對話方塊結束時，控制項會回到此觸發程式中的下一個步驟。
CancelAllDialogs	取消所有使用中的對話方塊	取消所有使用中的對話方塊。 選擇性地傳送可攔截的自訂事件，以防止取消傳播。
CancelDialog	取消對話方塊	取消使用中的對話方塊。 選擇性地傳送可攔截的自訂事件，以防止取消。
ContinueConversation	繼續交談	傳送主動式訊息。 需要具有已設定儲存體佇列的 Bot。
ContinueConversationLater	稍後繼續交談	將主動式訊息排入佇列，以在延遲之後傳送。 要求 Bot 設定儲存體佇列。
EndDialog	結束此對話方塊	結束目前的對話方塊，並傳回選擇性的結果。
EndTurn	結束回合	結束目前的回合，而不明確結束對話。
GetConversationReference	取得交談參考	將目前的交談參考儲存至記憶體。 用於繼續交談動作。
GotoAction	移至動作	跳至目前觸發程式中的另一個動作。
RepeatDialog	重複此對話方塊	重新開機目前的對話方塊。 您可以提供對話方塊的輸入參數。
ReplaceDialog	取代此對話方塊	以新的對話方塊取代目前的對話方塊。 您可以提供新對話方塊的輸入參數。

受控屬性

動作名稱	動作標題	描述
DeleteActivity	刪除活動	刪除先前傳送給使用者的活動。
DeleteProperties	刪除屬性	一次移除多個屬性。
DeleteProperty	刪除屬性	從記憶體中移除屬性。
EditArray	編輯陣列屬性	在陣列上執行作業。
GetActivityMembers	取得活動成員	取得參與活動的成員。 只有 BotFrameworkAdapter 連接器支援。
GetConversationMembers	取得交談成員	取得參與交談的成員。 只有 BotFrameworkAdapter 連接器支援。
SetProperties	設定屬性	一次設定多個屬性的值。
SetProperty	設定屬性	在記憶體中設定屬性的值。
UpdateActivity	更新活動	更新先前傳送給使用者的活動。

存取外部資源

注意

Azure AI QnA Maker 將于 2025 年 3 月 31 日淘汰。 從 2022 年 10 月起，您將無法建立新的 QnA Maker 資源或知識庫。 較新版的問題和解答功能現在隨附於 Azure AI 語言。

自訂問題解答是 Azure AI 語言的一項功能，是 QnA Maker 服務的更新版本。 如需 Bot Framework SDK 中問答支援的詳細資訊，請參閱 自然語言理解 。

動作名稱	動作標題	描述
BeginSkill	技能連線	開始技能，並將活動轉送至技能，直到技能結束為止。
EmitEvent	發出自訂事件	引發自訂事件。 若要允許對話回應事件，請將自訂事件觸發程式新增至對話方塊。
HttpRequest	傳送 HTTP 要求	對端點提出 HTTP 要求。
OAuthInput	OAuth 登入	要求使用者使用 OAuth 識別提供者登入。
QnAMakerDialog	QnAMaker 對話方塊	使用 QnA Maker 知識庫回答使用者問題。
SendHandoffActivity	傳送遞交要求	已取代。 請勿使用此動作。
SignOutUser	登出使用者	從 OAuth 識別提供者登出使用者。

偵錯選項

動作名稱	動作標題	描述
LogAction	登入主控台	寫入主控台，並選擇性地將訊息傳送為追蹤活動。
TelemetryTrackEventAction	遙測 - 追蹤事件	使用已註冊的遙測用戶端來追蹤自訂事件。
ThrowException	擲回例外狀況	擲回例外狀況。 若要允許對話方塊攔截例外狀況，請將發生錯誤的觸發程式新增至對話方塊。
TraceActivity	發出追蹤事件	傳送追蹤活動。

其他資訊

• 若要瞭解收集使用者輸入的特定動作，請參閱 使用調適型對話 要求使用者輸入一文。
• 若要深入瞭解調適型運算式， 請參閱調適型運算式 一文。