AtBot 逻辑

AtBot 是一种无代码机器人生成服务，可用于快速创建聊天 UI，而无需任何编程体验。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	标准	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 中国区域 - 美国国防部（DoD）
Power Apps	标准	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	标准	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	AtBot 支持
URL	https://admin.atbot.io/Docs
Email	support@atbot.io

连接器元数据
发布者	H3 Solutions Inc.
网站	https://www.atbot.io
隐私策略	https://admin.atbot.io/privacy
类别	人工智能;生产力

AtBot 逻辑连接器用于为 AtBot 服务中内置的机器人创建机器人技能。使用连接器中的作，可以为机器人创建复杂的聊天技能，并使用其他连接器将其连接到其他服务。 AtBot 可以免费在 Microsoft Teams 中试用，并提供了一个高级版本，可在其他平台上生成自定义机器人。有关详细信息，请访问 AtBot 网站。

先决条件

若要使用 AtBot 的免费版本，必须拥有 Microsoft Teams 帐户，并从应用商店下载 AtBot 机器人。

若要使用可在其中生成自己的自定义机器人的高级版本，必须注册 AtBot Premium。注册 Premium 时，你将获得 25 美元的额度来试用该服务。

如何获取凭据

始终使用 Microsoft Entra ID 工作或学校帐户登录到 AtBot 连接器。

已知问题和限制

我们在关键字触发器中弃用了 LUIS 支持。请使用 LUIS 意向矢量创建识别自然语言的技能。

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

从机器人内存中删除	此作用于从机器人的内存中删除一段信息。
从用户获取人员响应	此作用于请求用户输入人员选取器输入。
从用户获取内存响应	此作用于请求用户输入机器人内存。
从用户获取响应	此作用于请求用户输入。
从用户获取意向向量响应	此作用于请求用户输入 NLP。
从用户获取日期/时间响应	此作用于请求用户输入日期/时间。
从用户获取自适应卡片响应	此作用于请求用户通过自适应卡输入。
从用户获取选择列表响应	此作用于请求用户选择列表输入。
从用户获取选择响应	此作用于请求用户输入选择。
保存到机器人内存	此作用于将一段信息保存到机器人中的内存中。
发送事件	此作用于向机器人客户端发送事件。
发送回复	此作用于发送对触发流的活动的回复。
发送自适应卡片回复	此作用于向触发流的活动发送自适应卡片答复。
发送自适应卡片集答复	此作用于发送自适应卡片集回复触发流的活动。该集可以采用 List 或 Carousel 形式。
启动新的私人对话	此作用于与用户启动新的私人对话。
启动新的组对话	此作用于在频道中启动新的组对话。
在两个或多个对话之间注册聊天网桥	此作用于在两个或多个用户之间启动聊天网桥。
按类型获取机器人内存项	按类型获取所有机器人内存项。
更新发送到选项卡的自适应卡片	此作用于更新发送到选项卡的卡片。
生成自适应卡片	此作用于生成自适应卡片，稍后将用于显示卡片的列表或轮播卡。

从机器人内存中删除

操作 ID:: DeleteBotMemory

此作用于从机器人的内存中删除一段信息。

参数

名称	密钥	必需	类型	说明
用户主体名称	user	True	string	要对其保存内存项的用户。
内存类型	type	True	string	内存的类型。
价值	value	True	string	内存项值。

Body: Response_DeleteBotMemory

从用户获取人员响应

操作 ID:: WebHookRegistrations_InputResponse_PEOPLE

此作用于请求用户输入人员选取器输入。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
Message	message	True	string	输入要发送给用户的消息。
模式	mode	True	string	要求用户选择一个或多个人员。
搜索字符串	searchstr		string	（可选）提供起始搜索字符串。
回复活动	activityJson	True	string	来自机器人的回复活动。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
允许分支	allowBranching		string	允许用户在提供响应之前触发分支技能。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。
侦听语音响应	listenForInput		boolean	如果这是 Teams 呼叫，则此属性确定机器人是否侦听语音响应。如果没有，或者 Teams 呼叫机器人不会立即侦听语音响应。

Body: BotResponse_People

从用户获取内存响应

操作 ID:: WebHookRegistrations_InputResponse_MEMORY

此作用于请求用户输入机器人内存。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
Message	message	True	string	输入要发送给用户的消息。
内存类型	type	True	string	提供要列出的内存类型。
回复活动	activityJson	True	string	来自机器人的回复活动。
图标 URL	icon		string	输入要为每个选择项显示的图标的绝对 URL。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
目标用户	targetUserMemory		string	（可选）指定机器人应从中提取内存项的用户的 UPN。如果留空，它将从启动技能的用户拉取内存项。对于从机器人启动的组会话，它将从 Flow 中对用户拉取内存项。
允许分支	allowBranching		string	允许用户在提供响应之前触发分支技能。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。

Body: BotResponse_Memory

从用户获取响应

操作 ID:: WebHookRegistrations_InputResponse

此作用于请求用户输入。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
Message	message	True	string	输入要发送给用户的消息。
回复活动	activityJson	True	string	来自机器人的回复活动。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。

Body: BotResponse

从用户获取意向向量响应

操作 ID:: WebHookRegistrations_InputResponse_INTENTVECTOR

此作用于请求用户输入 NLP。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
Message	message	True	string	输入要发送给用户的消息。
LUIS 意向向量	intentVector	True	string	选取 LUIS 意向矢量。
回复活动	activityJson	True	string	来自机器人的回复活动。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
允许分支	allowBranching		string	允许用户在提供响应之前触发分支技能。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。

此操作输出是动态内容。

从用户获取日期/时间响应

操作 ID:: WebHookRegistrations_InputResponse_DATE

此作用于请求用户输入日期/时间。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
日期范围	dateScope	True	string	选择日期值的范围。
Message	message	True	string	输入要发送给用户的消息。
回复活动	activityJson	True	string	来自机器人的回复活动。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
允许分支	allowBranching		string	允许用户在提供响应之前触发分支技能。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。

Body: BotResponse_Date

从用户获取自适应卡片响应

操作 ID:: WebHookRegistrations_InputResponse_ADAPTIVECARD

此作用于请求用户通过自适应卡输入。

参数

名称	密钥	必需	类型	说明
所选自适应卡片	selectedCard	True	string	选择自适应卡片。
webHook	webHook		dynamic

此操作输出是动态内容。

从用户获取选择列表响应

操作 ID:: WebHookRegistrations_InputResponse_CHOICELIST

此作用于请求用户选择列表输入。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
图标 URL	icon		string	输入要为每个选择项显示的图标的绝对 URL。
Message	message	True	string	输入要发送给用户的消息。
选择值	choices	True	object	提供选择数组对象。
回复活动	activityJson	True	string	来自机器人的回复活动。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
允许分支	allowBranching		string	允许用户在提供响应之前触发分支技能。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。
侦听语音响应	listenForInput		boolean	如果这是 Teams 呼叫，则此属性确定机器人是否侦听语音响应。如果没有，或者 Teams 呼叫机器人不会立即侦听语音响应。

Body: BotResponse_ChoiceList

从用户获取选择响应

操作 ID:: WebHookRegistrations_InputResponse_CHOICE

此作用于请求用户输入选择。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
Message	message	True	string	输入要发送给用户的消息。
选择值	choices	True	string	在单独的行上提供每个选项。
回复活动	activityJson	True	string	来自机器人的回复活动。
接受来自	acceptResponseFrom		string	接受来自特定用户或任何用户的响应。
允许分支	allowBranching		string	允许用户在提供响应之前触发分支技能。
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。
侦听语音响应	listenForInput		boolean	如果这是 Teams 呼叫，则此属性确定机器人是否侦听语音响应。如果没有，或者 Teams 呼叫机器人不会立即侦听语音响应。

Body: BotResponse_Choice

保存到机器人内存

操作 ID:: SaveBotMemory

此作用于将一段信息保存到机器人中的内存中。

参数

名称	密钥	必需	类型	说明
用户主体名称	user	True	string	要对其保存内存项的用户。
内存类型	type	True	string	内存的类型。
Title	title	True	string	内存项标题。
价值	value	True	string	内存项值。

Body: Response_SaveBotMemory

发送事件

操作 ID:: SendBridgeEvent

此作用于向机器人客户端发送事件。

参数

名称	密钥	必需	类型	说明
回复活动	activityJson	True	string	来自机器人的回复活动
事件 JSON	eventObject	True	object	要在聊天事件中发送的 JSON 对象。

发送回复

操作 ID:: SendReply

此作用于发送对触发流的活动的回复。

参数

名称	密钥	必需	类型	说明
回复文本	message	True	string	要答复用户的消息。
回复活动	activityJson	True	string	来自机器人的回复活动
在聊天中显示	showInChat		boolean	如果这是 Teams 呼叫，在聊天中显示此消息。否则，机器人将仅朗讲消息。
自定义频道数据	customChannelDataJson		string	消息的自定义通道数据 Json（仅在 Direct Line 中受支持）
信号响应 JSON	signalResponse		string	信号响应 JSON 字符串
消息 ID	messageId		string	（可选）要替换的同一对话中上一条消息的 ID。如果已提供，机器人会将现有聊天消息替换为此消息。

Body: BotReplyResponse

发送自适应卡片回复

操作 ID:: SendReplyWithAdaptiveCard

此作用于向触发流的活动发送自适应卡片答复。

参数

名称	密钥	必需	类型	说明
所选自适应卡片	selectedCard	True	string	选择自适应卡片。
内容	content	True	dynamic

Body: BotReplyResponse

发送自适应卡片集答复

操作 ID:: SendReplyWithAdaptiveCardSet

此作用于发送自适应卡片集回复触发流的活动。该集可以采用 List 或 Carousel 形式。

参数

名称	密钥	必需	类型	说明
自适应卡片集	cards	True	object	提供卡片集对象。
显示样式	displayStyle	True	string	选择要使用的显示样式。
回复活动	activityJson	True	string	来自机器人的回复活动。
在选项卡中显示	showInTab		boolean	在选项卡中显示此卡片集，而不是内联聊天。
选项卡按钮标签	deepLinkButtonLabel		string	用于在选项卡中显示的按钮标签。
Tab 按钮消息	deepLinkMessage		string	在选项卡中显示时要随按钮一起发送的消息。

Body: BotReplyResponse

启动新的私人对话

操作 ID:: StartConversation

此作用于与用户启动新的私人对话。

参数

名称	密钥	必需	类型	说明
目标机器人	EnterpriseBot	True	string	选择机器人。
对话文本	message	True	string	要与其进行对话的消息。
用户	user	True	string	用户主体名称（UPN）。

Body: BotConversationStartResponse

启动新的组对话

操作 ID:: StartGroupConversation

此作用于在频道中启动新的组对话。

参数

名称	密钥	必需	类型	说明
目标机器人	EnterpriseBot	True	string	选择机器人。
频道列表	teamIDStr	True	object	频道列表输出。
通道名称	channelId	True	string	要发布到对话的频道。键入名称。
对话文本	message	True	string	要与其进行对话的消息。

Body: BotGroupConversationStartResponse

在两个或多个对话之间注册聊天网桥

操作 ID:: WebHookRegistrations_InitiateBridge

此作用于在两个或多个用户之间启动聊天网桥。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
用户名	chatUserName	True	string	聊天用户的显示名称。
初始消息	chatInitiationMessage		string	建立聊天网桥时要发送给此用户的消息。
回复活动	activityJson	True	string	聊天用户的回复活动。
结束聊天命令	endBridgeCommand	True	string	要发送到机器人以结束聊天桥的关键字命令。
空闲超时	idleTimeoutDuration	True	integer	要触发超时的空闲活动的持续时间（以分钟为单位）。

Body: BridgeOutcome

按类型获取机器人内存项

操作 ID:: GetMemoryItemsByType

按类型获取所有机器人内存项。

参数

名称	密钥	必需	类型	说明
用户主体名称。	user	True	string	提供用户主体名称。
内存类型	type	True	string	提供要列出的内存类型。

response: array of MemoryItem

更新发送到选项卡的自适应卡片

操作 ID:: UpdateAdaptiveCard

此作用于更新发送到选项卡的卡片。

参数

名称	密钥	必需	类型	说明
自适应卡片	card	True	object	提供要用作更新的卡片。
回复活动	activityJson	True	string	来自机器人的回复活动。

Body: BotReplyResponse

生成自适应卡片

操作 ID:: GenerateAdaptiveCard

此作用于生成自适应卡片，稍后将用于显示卡片的列表或轮播卡。

参数

名称	密钥	必需	类型	说明
所选自适应卡片	selectedCard	True	string	选择自适应卡片。
内容	content		dynamic

response: object

触发器

使用关键字时	当机器人使用给定关键字时，此作将触发。以分号分隔格式提供多个关键字。
识别意向向量时	当机器人识别给定的 LUIS 意向向量时，此作将触发。

使用关键字时

操作 ID:: WebHookRegistrations_Post

当机器人使用给定关键字时，此作将触发。以分号分隔格式提供多个关键字。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
触发器说明	triggerDescription	True	string	机器人帮助对话框中显示的说明
机器人触发器类型	triggerType	True	string	选择触发器的类型。
关键字	keywords		string	输入将触发 Flow 的自定义关键字。
（已弃用）LUIS API 密钥	luisApiKey		string	（已弃用）为 AtBot 提供 LUIS API 密钥。此参数已弃用。请今后使用 LUIS 的意向向量触发器。
（已弃用）LUIS 应用	luisAppId		string	（已弃用）选取 LUIS 应用。此参数已弃用。请今后使用 LUIS 的意向向量触发器。
（已弃用）LUIS 意向	luisIntent		string	（已弃用）选取要使用的 LUIS 意向。此参数已弃用。请今后使用 LUIS 的意向向量触发器。

此操作输出是动态内容。

识别意向向量时

操作 ID:: WebHookRegistrationsVector_Post

当机器人识别给定的 LUIS 意向向量时，此作将触发。

参数

名称	密钥	必需	类型	说明
filters	filters		array of string
标题	headers		object
属性	properties		object
触发器说明	triggerDescription	True	string	机器人帮助对话框中显示的说明。
机器人触发器类型	triggerType	True	string	选择触发器的类型。
LUIS 意向向量	intentVector		string	选取 LUIS 意向矢量。
允许分支	allowBranching		string	允许用户在回答后续问题时触发分支技能。

此操作输出是动态内容。

定义

BotReplyResponse

名称	路径	类型	说明
消息 ID	id	string	从回复创建的邮件的 ID。用于更新消息。

BotResponse

名称	路径	类型	说明
响应文本	text	string	用户输入的响应。
取消通知	cancelNotice	boolean	如果用户使用取消关键字进行响应，则此标志为 True。
响应用户	respondingUser	string	响应机器人的用户。
files	files	array of object
文件名	files.name	string	文件名。
文件类型	files.content-type	string	文件类型。
文件字节数	files.bytes	byte	文件字节。

BotResponse_Date

名称	路径	类型	说明
响应日期	text	date-time	用户输入的响应日期时间。
响应日期 UTC	text_UTC	date-time	用户输入的响应日期/时间（采用 UTC 格式）。
取消通知	cancelNotice	boolean	如果用户使用取消关键字进行响应，则此标志为 True。
响应用户	respondingUser	string	响应机器人的用户。

BotResponse_Choice

名称	路径	类型	说明
响应选择	text	string	用户输入的响应选项。
取消通知	cancelNotice	boolean	如果用户使用取消关键字进行响应，则此标志为 True。
响应用户	respondingUser	string	响应机器人的用户。

BotResponse_ChoiceList

名称	路径	类型	说明
所选选项列表标题	title	string	所选的选择列表标题。
所选选项列表副标题	subtitle	string	所选的选择列表副标题。
所选选项列表值	value	string	所选选项列表值。
取消通知	cancelNotice	boolean	如果用户使用取消关键字进行响应，则此标志为 True。
响应用户	respondingUser	string	响应机器人的用户。

BotResponse_People

名称	路径	类型	说明
people	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

名称	路径	类型	说明
内存项标题	title	string	内存项的标题。
内存项值	value	string	内存项的值。
取消通知	cancelNotice	boolean	如果用户使用取消关键字进行响应，则此标志为 True。
响应用户	respondingUser	string	响应机器人的用户。

Response_SaveBotMemory

名称	路径	类型	说明
机器人内存保存结果	text	string	保存到机器人内存的结果。

Response_DeleteBotMemory

名称	路径	类型	说明
机器人内存删除结果	text	string	从机器人内存中删除的结果。

BotGroupConversationStartResponse

名称	路径	类型	说明
对话 ID	id	string	从开始组对话创建的会话的 ID。用于更新对话。
消息 ID	messageId	string	从开始组对话创建的消息的 ID。用于更新消息。
回复活动	activityJson	string	活动 Json。

BotConversationStartResponse

名称	路径	类型	说明
消息 ID	id	string	从回复创建的邮件的 ID。用于更新消息。
回复活动	activityJson	string	活动 Json。

BridgeOutcome

名称	路径	类型	说明
结果	outcome	string	桥的结果。
桥关闭者	bridgeClosedBy	string	关闭桥的用户。

MemoryItem

名称	路径	类型	说明
内存项标题	title	string	内存项的标题。
内存项值	value	string	内存项的值。

对象

这是 'object' 类型。

通过

AtBot 逻辑

先决条件

如何获取凭据

已知问题和限制

限制

操作

从机器人内存中删除

参数

返回

从用户获取人员响应

参数

返回

从用户获取内存响应

参数

返回

从用户获取响应

参数

返回

从用户获取意向向量响应

参数

返回

从用户获取日期/时间响应

参数

返回

从用户获取自适应卡片响应

参数

返回

从用户获取选择列表响应

参数

返回

从用户获取选择响应

参数

返回

保存到机器人内存

参数

返回

发送事件

参数

发送回复

参数

返回

发送自适应卡片回复

参数

返回

发送自适应卡片集答复

参数

返回

启动新的私人对话

参数

返回

启动新的组对话

参数

返回

在两个或多个对话之间注册聊天网桥

参数

返回

按类型获取机器人内存项

参数

返回

更新发送到选项卡的自适应卡片

参数

返回

生成自适应卡片

参数

返回

触发器

使用关键字时

参数

返回

识别意向向量时

参数

返回

定义

BotReplyResponse

BotResponse

BotResponse_Date

BotResponse_Choice

BotResponse_ChoiceList

BotResponse_People