共用方式為

AtBot 邏輯

AtBot 是一種無代碼機器人構建服務，允許您快速創建對話式 UI，無需任何編程經驗。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 標準 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 標準 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 標準 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 AtBot 支持
URL https://admin.atbot.io/Docs
Email support@atbot.io
連接器中繼資料
Publisher H3 解決方案公司
網站 https://www.atbot.io
隱私策略 https://admin.atbot.io/privacy
類別 人工智慧;生產力

AtBot Logic 連接器可用來為 AtBot 服務中建置的機器人建立機器人技能。 使用連接器中的動作，您可以為機器人建立複雜的交談技能，並使用其他連接器將它們連線到其他服務。 AtBot 可在 Microsoft Teams 中免費試用，高級版本可用於在其他平台上構建自定義機器人。 訪問 AtBot 網站 了解更多信息。

先決條件

為了使用免費版本的 AtBot，您必須擁有 Microsoft Teams 帳戶並從 應用程式商店下載 AtBot 機器人。

要使用可以構建自己的自定義機器人的高級版本，您必須 註冊 AtBot Premium。 當您註冊 Premium 時，您將獲得 25 美元的積分來試用該服務。

如何取得認證

您一律會使用 Microsoft Entra ID 公司或學校帳戶登入 AtBot 連接器。

已知問題與限制

我們已在關鍵字觸發程式中取代 LUIS 支援。 請使用 LUIS 意圖向量 來建立辨識自然語言的技能。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

依類型取得機器人記憶體項目

依類型取得所有機器人記憶體項目。
傳送事件

此作業可用來將事件傳送至機器人用戶端。
傳送最適化卡片回覆

此作業可用來將調適型卡片回覆傳送至觸發流程的活動。
傳送最適化卡片集回覆

此作業可用來傳送調適型卡片集回覆至觸發流程之活動。 該集合可以是清單或輪播形式。
儲存至機器人記憶體

此操作用於將一條信息保存到機器人中的內存中。
取得使用者的調適型卡片回應

此作業可用來要求使用者透過調適型卡片輸入。
在兩個或多個對話之間註冊聊天橋接器

此操作用於在兩個或多個使用者之間啟動聊天橋接器。
從使用者取得回應

此作業可用來要求使用者輸入。
從使用者取得意圖向量回應

此作業可用來要求使用者輸入 NLP 輸入。
從使用者取得日期時間回應

此作業可用來要求使用者輸入日期時間。
從使用者取得記憶體回應

此作業可用來要求使用者輸入機器人記憶體。
從使用者取得選擇清單回應

此作業可用來要求使用者輸入選擇清單。
從機器人記憶體中刪除

此作業可用來從機器人的記憶體中移除一段資訊。
從用戶那裡獲得人們的回應

此作業可用來要求使用者人員選擇器輸入。
從用戶那裡獲得選擇回應

此作業可用來要求使用者輸入選擇。
更新傳送至索引標籤的最適化卡片

此作業可用來更新傳送至索引標籤的卡片。
產生最適化卡片

此作業可用來產生調適型卡片，稍後用來顯示卡片清單或輪播。
發送回复

此作業可用來傳送回覆至觸發流程的活動。
開始新的私人對話

此作業可用來與使用者開始新的私人交談。
開始新的群組對話

此作業可用來在頻道中啟動新的群組交談。

依類型取得機器人記憶體項目

作業識別碼：
GetMemoryItemsByType

依類型取得所有機器人記憶體項目。

參數

名稱 機碼 必要 類型 Description
使用者主體名稱。
 user True string

提供使用者主體名稱。
記憶體類型
 type True string

提供要列出的記憶體類型。

傳回

response
array of MemoryItem

傳送事件

作業識別碼：
SendBridgeEvent

此作業可用來將事件傳送至機器人用戶端。

參數

名稱 機碼 必要 類型 Description
回覆活動
 activityJson True string

來自機器人的回覆活動
事件JSON
 eventObject True object

要在聊天事件中傳送的 JSON 物件。

傳送最適化卡片回覆

作業識別碼：
SendReplyWithAdaptiveCard

此作業可用來將調適型卡片回覆傳送至觸發流程的活動。

參數

名稱 機碼 必要 類型 Description
選取的最適化卡片
 selectedCard True string

選取最適化卡片。
內容
 content True dynamic

傳回

身體
BotReplyResponse

傳送最適化卡片集回覆

作業識別碼：
SendReplyWithAdaptiveCardSet

此作業可用來傳送調適型卡片集回覆至觸發流程之活動。 該集合可以是清單或輪播形式。

參數

名稱 機碼 必要 類型 Description
最適化卡片集
 cards True object

提供卡片集物件。
顯示樣式
 displayStyle True string

選取要使用的顯示樣式。
回覆活動
 activityJson True string

回覆機器人的活動。
顯示在標籤中
 showInTab boolean

在索引標籤中顯示此卡片集，而不是內嵌聊天。
標籤按鈕標籤
 deepLinkButtonLabel string

用於在索引標籤中顯示的按鈕標籤。
標籤按鈕訊息
 deepLinkMessage string

在索引標籤中顯示時，要使用按鈕傳送的訊息。

傳回

身體
BotReplyResponse

儲存至機器人記憶體

作業識別碼：
SaveBotMemory

此操作用於將一條信息保存到機器人中的內存中。

參數

名稱 機碼 必要 類型 Description
使用者主體名稱
 user True string

要儲存記憶體項目的使用者。
記憶體類型
 type True string

記憶體的類型。
Title
 title True string

記憶體項目標題。
價值觀
 value True string

記憶體項目值。

傳回

身體
Response_SaveBotMemory

取得使用者的調適型卡片回應

作業識別碼：
WebHookRegistrations_InputResponse_ADAPTIVECARD

此作業可用來要求使用者透過調適型卡片輸入。

參數

名稱 機碼 必要 類型 Description
選取的最適化卡片
 selectedCard True string

選取最適化卡片。
網路鉤子
 webHook dynamic

傳回

此作業會輸出隨機的結果。

在兩個或多個對話之間註冊聊天橋接器

作業識別碼：
WebHookRegistrations_InitiateBridge

此操作用於在兩個或多個使用者之間啟動聊天橋接器。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
使用者名
 chatUserName True string

聊天使用者的顯示名稱。
啟動訊息
 chatInitiationMessage string

建立聊天橋接器時要傳送給此使用者的訊息。
回覆活動
 activityJson True string

聊天使用者的回覆活動。
結束聊天指令
 endBridgeCommand True string

要傳送給機器人以結束聊天橋接器的關鍵字命令。
閒置逾時
 idleTimeoutDuration True integer

觸發逾時的閒置活動持續時間 （以分鐘為單位）。

傳回

身體
BridgeOutcome

從使用者取得回應

作業識別碼：
WebHookRegistrations_InputResponse

此作業可用來要求使用者輸入。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
Message
 message True string

輸入要傳送給使用者的訊息。
回覆活動
 activityJson True string

回覆機器人的活動。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。

傳回

身體
BotResponse

從使用者取得意圖向量回應

作業識別碼：
WebHookRegistrations_InputResponse_INTENTVECTOR

此作業可用來要求使用者輸入 NLP 輸入。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
Message
 message True string

輸入要傳送給使用者的訊息。
LUIS 意圖向量
 intentVector True string

挑選您的 LUIS 意圖向量。
回覆活動
 activityJson True string

回覆機器人的活動。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
允許分支
 allowBranching string

允許使用者在提供回應之前觸發分支技能。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。

傳回

此作業會輸出隨機的結果。

從使用者取得日期時間回應

作業識別碼：
WebHookRegistrations_InputResponse_DATE

此作業可用來要求使用者輸入日期時間。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
日期範圍
 dateScope True string

選取日期值的範圍。
Message
 message True string

輸入要傳送給使用者的訊息。
回覆活動
 activityJson True string

回覆機器人的活動。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
允許分支
 allowBranching string

允許使用者在提供回應之前觸發分支技能。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。

傳回

身體
BotResponse_Date

從使用者取得記憶體回應

作業識別碼：
WebHookRegistrations_InputResponse_MEMORY

此作業可用來要求使用者輸入機器人記憶體。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
Message
 message True string

輸入要傳送給使用者的訊息。
記憶體類型
 type True string

提供要列出的記憶體類型。
回覆活動
 activityJson True string

回覆機器人的活動。
Icon URL (圖示 URL)
 icon string

輸入要針對每個選擇項目顯示的圖示的絕對 URL。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
目標使用者
 targetUserMemory string

選擇性地指定 Bot 應該從中提取記憶體專案之使用者的 UPN。 如果留空，它會從起始技能的使用者中提取記憶體項目。 如果是從機器人啟動的群組交談，它將從在 Flow 中驗證的使用者中提取記憶體項目。
允許分支
 allowBranching string

允許使用者在提供回應之前觸發分支技能。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。

傳回

身體
BotResponse_Memory

從使用者取得選擇清單回應

作業識別碼：
WebHookRegistrations_InputResponse_CHOICELIST

此作業可用來要求使用者輸入選擇清單。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
Icon URL (圖示 URL)
 icon string

輸入要針對每個選擇項目顯示的圖示的絕對 URL。
Message
 message True string

輸入要傳送給使用者的訊息。
選擇值
 choices True object

提供選擇陣列物件。
回覆活動
 activityJson True string

回覆機器人的活動。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
允許分支
 allowBranching string

允許使用者在提供回應之前觸發分支技能。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。
監聽語音回應
 listenForInput boolean

如果這是 Teams 通話，此屬性會決定 Bot 是否接聽語音回應。 如果否，或不是 Teams 呼叫，Bot 將不會立即接聽語音回應。

傳回

身體
BotResponse_ChoiceList

從機器人記憶體中刪除

作業識別碼：
DeleteBotMemory

此作業可用來從機器人的記憶體中移除一段資訊。

參數

名稱 機碼 必要 類型 Description
使用者主體名稱
 user True string

要儲存記憶體項目的使用者。
記憶體類型
 type True string

記憶體的類型。
價值觀
 value True string

記憶體項目值。

傳回

身體
Response_DeleteBotMemory

從用戶那裡獲得人們的回應

作業識別碼：
WebHookRegistrations_InputResponse_PEOPLE

此作業可用來要求使用者人員選擇器輸入。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
Message
 message True string

輸入要傳送給使用者的訊息。
Mode
 mode True string

要求使用者選取一或多個人員。
搜尋字串
 searchstr string

選擇性地提供起始搜尋字串。
回覆活動
 activityJson True string

回覆機器人的活動。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
允許分支
 allowBranching string

允許使用者在提供回應之前觸發分支技能。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。
監聽語音回應
 listenForInput boolean

如果這是 Teams 通話，此屬性會決定 Bot 是否接聽語音回應。 如果否，或不是 Teams 呼叫，Bot 將不會立即接聽語音回應。

傳回

身體
BotResponse_People

從用戶那裡獲得選擇回應

作業識別碼：
WebHookRegistrations_InputResponse_CHOICE

此作業可用來要求使用者輸入選擇。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
Message
 message True string

輸入要傳送給使用者的訊息。
選擇值
 choices True string

在單獨的行中提供每個選項。
回覆活動
 activityJson True string

回覆機器人的活動。
接受來自的回應
 acceptResponseFrom string

接受特定用戶或任何用戶的響應。
允許分支
 allowBranching string

允許使用者在提供回應之前觸發分支技能。
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。
監聽語音回應
 listenForInput boolean

如果這是 Teams 通話，此屬性會決定 Bot 是否接聽語音回應。 如果否，或不是 Teams 呼叫，Bot 將不會立即接聽語音回應。

傳回

身體
BotResponse_Choice

更新傳送至索引標籤的最適化卡片

作業識別碼：
UpdateAdaptiveCard

此作業可用來更新傳送至索引標籤的卡片。

參數

名稱 機碼 必要 類型 Description
最適化卡片
 card True object

提供要用作更新的卡片。
回覆活動
 activityJson True string

回覆機器人的活動。

傳回

身體
BotReplyResponse

產生最適化卡片

作業識別碼：
GenerateAdaptiveCard

此作業可用來產生調適型卡片，稍後用來顯示卡片清單或輪播。

參數

名稱 機碼 必要 類型 Description
選取的最適化卡片
 selectedCard True string

選取最適化卡片。
內容
 content dynamic

傳回

response
object

發送回复

作業識別碼：
SendReply

此作業可用來傳送回覆至觸發流程的活動。

參數

名稱 機碼 必要 類型 Description
回覆文字
 message True string

要回覆使用者的訊息。
回覆活動
 activityJson True string

來自機器人的回覆活動
在聊天室中顯示
 showInChat boolean

如果這是 Teams 通話，請在聊天中顯示此訊息。 否則，機器人只會說出訊息。
自訂通道資料
 customChannelDataJson string

訊息的自訂管道資料 Json （僅在 Direct Line 中支援）
訊號回應JSON
 signalResponse string

訊號回應 JSON 字串
訊息 ID
 messageId string

（選用）要取代的相同交談中先前訊息的識別碼。 如果提供，機器人會以此訊息取代現有的聊天訊息。

傳回

身體
BotReplyResponse

開始新的私人對話

作業識別碼：
StartConversation

此作業可用來與使用者開始新的私人交談。

參數

名稱 機碼 必要 類型 Description
目標機器人
 EnterpriseBot True string

選取機器人。
對話文字
 message True string

要開始對話的訊息。
User
 user True string

使用者主體名稱 （UPN）。

傳回

身體
BotConversationStartResponse

開始新的群組對話

作業識別碼：
StartGroupConversation

此作業可用來在頻道中啟動新的群組交談。

參數

名稱 機碼 必要 類型 Description
目標機器人
 EnterpriseBot True string

選取機器人。
頻道列表
 teamIDStr True object

頻道清單輸出。
頻道名稱
 channelId True string

要將對話張貼到的頻道。 輸入名稱。
對話文字
 message True string

要開始對話的訊息。

傳回

身體
BotGroupConversationStartResponse

觸發程序

使用關鍵字時

當機器人使用指定的關鍵字時，會觸發此作業。 以分號分隔格式提供多個關鍵字。
辨識意圖向量時

當機器人辨識指定的 LUIS 意圖向量時，會觸發此作業。

使用關鍵字時

作業識別碼：
WebHookRegistrations_Post

當機器人使用指定的關鍵字時，會觸發此作業。 以分號分隔格式提供多個關鍵字。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
觸發器說明
 triggerDescription True string

機器人說明對話方塊中顯示的描述
機器人觸發器類型
 triggerType True string

選取觸發程式的類型。
關鍵字
 keywords string

輸入將觸發流程的自訂關鍵字。
（已棄用）LUIS API 金鑰
 luisApiKey string

（已棄用）提供 AtBot 您的 LUIS API 金鑰。 此參數已被取代。 請使用意圖向量觸發程序來進行 LUIS 使用。
（已棄用）LUIS 應用程式
 luisAppId string

（已棄用）挑選您的 LUIS 應用程式。 此參數已被取代。 請使用意圖向量觸發程序來進行 LUIS 使用。
（已棄用）LUIS 意圖
 luisIntent string

（已棄用）挑選要使用的 LUIS 意圖。 此參數已被取代。 請使用意圖向量觸發程序來進行 LUIS 使用。

傳回

此作業會輸出隨機的結果。

辨識意圖向量時

作業識別碼：
WebHookRegistrationsVector_Post

當機器人辨識指定的 LUIS 意圖向量時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
filters
 filters array of string
headers
 headers object
properties
 properties object
觸發器說明
 triggerDescription True string

機器人說明對話方塊中顯示的描述。
機器人觸發器類型
 triggerType True string

選取觸發程式的類型。
LUIS 意圖向量
 intentVector string

挑選您的 LUIS 意圖向量。
允許分支
 allowBranching string

允許使用者在回答後續問題時觸發分支技能。

傳回

此作業會輸出隨機的結果。

定義

機器人回覆回應

名稱 路徑 類型 Description
訊息標識碼
 id string

從回覆建立之訊息的識別碼。 用來更新訊息。

機器人回應

名稱 路徑 類型 Description
回應文字
 text string

使用者輸入的回應。
取消通知
 cancelNotice boolean

如果使用者使用取消關鍵字回應，此旗標將會是 True。
回應使用者
 respondingUser string

回應機器人的使用者。
files
 files array of object
檔案名稱
 files.name string

檔名。
檔案類型
 files.content-type string

檔案類型。
檔案位元組
 files.bytes byte

檔案位元組。

BotResponse_Date

名稱 路徑 類型 Description
回應日期
 text date-time

使用者輸入的回應日期時間。
回應日期 UTC
 text_UTC date-time

使用者輸入的回應日期時間，以 UTC 格式。
取消通知
 cancelNotice boolean

如果使用者使用取消關鍵字回應，此旗標將會是 True。
回應使用者
 respondingUser string

回應機器人的使用者。

BotResponse_Choice

名稱 路徑 類型 Description
回應選擇
 text string

使用者輸入的回應選項。
取消通知
 cancelNotice boolean

如果使用者使用取消關鍵字回應，此旗標將會是 True。
回應使用者
 respondingUser string

回應機器人的使用者。

BotResponse_ChoiceList

名稱 路徑 類型 Description
選取的選擇清單標題
 title string

選取的選擇清單標題。
選定的選擇清單字幕
 subtitle string

選取的選擇清單副標題。
選取的選擇清單值
 value string

選取的選擇清單值。
取消通知
 cancelNotice boolean

如果使用者使用取消關鍵字回應，此旗標將會是 True。
回應使用者
 respondingUser string

回應機器人的使用者。

BotResponse_People

名稱 路徑 類型 Description
人員
 people array of object
使用者主體名稱
 people.upn string

用戶主體名稱。
使用者 ID
 people.userid string

使用者 ID。
全名
 people.fullname string

使用者全名。
Email
 people.email string

使用者電子郵件。
取消通知
 cancelNotice boolean

如果使用者使用取消關鍵字回應，此旗標將會是 True。
回應使用者
 respondingUser string

回應機器人的使用者。

BotResponse_Memory

名稱 路徑 類型 Description
記憶物品標題
 title string

記憶體項目的標題。
記憶體項目值
 value string

記憶體項目的值。
取消通知
 cancelNotice boolean

如果使用者使用取消關鍵字回應，此旗標將會是 True。
回應使用者
 respondingUser string

回應機器人的使用者。

Response_SaveBotMemory

名稱 路徑 類型 Description
機器人記憶體儲存結果
 text string

儲存至機器人記憶體的結果。

Response_DeleteBotMemory

名稱 路徑 類型 Description
機器人記憶體刪除結果
 text string

從機器人記憶體中刪除的結果。

BotGroupConversationStartResponse 回應

名稱 路徑 類型 Description
交談 Id
 id string

從開始群組交談建立之交談的識別碼。 用於更新對話。
訊息標識碼
 messageId string

從開始群組交談建立之訊息的識別碼。 用來更新訊息。
回覆活動
 activityJson string

活動 json。

BotConversationStart回應

名稱 路徑 類型 Description
訊息標識碼
 id string

從回覆建立之訊息的識別碼。 用來更新訊息。
回覆活動
 activityJson string

活動 json。

橋樑成果

名稱 路徑 類型 Description
結果
 outcome string

橋樑的結果。
橋樑關閉
 bridgeClosedBy string

關閉橋接器的使用者。

記憶體項目

名稱 路徑 類型 Description
記憶物品標題
 title string

記憶體項目的標題。
記憶體項目值
 value string

記憶體項目的值。

物件

這是類型 'object'。