雨鸟 （预览版）
Rainbird 是一个无代码智能自动化平台，可用于自动执行复杂的决策。 此连接器使你能够与在 Rainbird 中构建的知识地图进行交互。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | 雨鸟技术有限公司 |
| URL | https://rainbird.ai/contact-us/ |
| support@rainbird.zohodesk.eu |
| 连接器元数据 | |
|---|---|
| 发布者 | 雨鸟技术有限公司 |
| 网站 | https://rainbird.ai/ |
| 隐私策略 | https://rainbird.ai/privacy-policy/ |
| 类别 | 人工智能;商业智能 |
Rainbird 使你的组织能够大规模自动执行复杂的决策。 利用自己的中小企业专业知识，在无代码工作室中编码其决策逻辑，然后连接到工作流，提供高质量、高性能和可审核的决策，使你能够创建完全自动化的端到端解决方案。
有关更多详细信息 ，请访问雨鸟的网站 。
先决条件
若要使用此连接器，需要访问 Rainbird 帐户。
现在可以注册以获取免费社区帐户的访问权限： 注册。 对于高级帐户，请与我们联系： 联系我们。
如何获取凭据
若要使用此连接器，需要以下各项：-API 密钥（ApiKey）-Knowledge 映射 ID （KmID）
可以在 ApiKey 雨鸟工作室中找到和 KmID 。
- 登录到帐户
- 打开知识图（或根据需要创建新的知识图）
- 转到“发布”页
ApiKey需要使用雨鸟进行身份验证。 身份验证使用 ApiKey 用户名时，不需要密码（如果需要密码时输入任何字符）。
有关更多详细信息 ，请访问 Rainbird 的文档 。
连接器入门
在想要使用 Rainbird 自动执行决策的任何方案中，都需要执行以下作：
-在“知识”地图上启动会话，你希望在会话中使用 -Provide 数据（可选）-Query“雨鸟”会话
如果需要更多信息，则可以使用 Response 作回答雨鸟的问题，或者提供结果。
如何启动会话：
任何决定都将从一个 Start 作开始，以启动会话并获取该 SessionID作。
在作中 Start ，提供 KmID 生成一个 SessionID。 然后，必须将此 ID 用于进一步的作，以在同一会话中与知识映射进行交互。
如何向会话提供批处理数据：
Inject在查询之前使用作来提供做出决策所需的任何数据。
如何进行查询：
若要进行查询，请使用 Query 该作提供 SessionID、关系名称以及关系的主题/对象或两者。
请访问 Rainbird 的文档 ，查看此请求的示例。
如何回答问题
使用 Response 作回答雨鸟返回的任何问题。 作QueryResponse将返回询问详细信息或结果的问题。 问题/响应循环是递归的，直到 Rainnbird 有足够的信息来提供结果。
有关请求流的详细信息，请访问 Rainbird 的文档 。
已知问题和限制
当前连接器配置不允许用户使用证据作的安全密钥。 如果用户想要使用证据作，则必须确保在每个地图的“发布”部分的 Rainbird Studio 中停用证据安全性。
常见错误和补救措施
使用错误的环境变量：
-错误代码：此错误可以输出各种错误消息，例如 Session ID not found 或 401: Unauthorized。
-Resolution：需要针对正确的环境（链接到帐户的作）执行每个作。 确保每个步骤都与环境匹配。
### 使用错误的数据结构。
-错误代码： 400: bad request -Resolution：这可能会导致数据不兼容。 阅读错误详细信息以获取更多上下文，并确保流中使用的数据与 Rainbird 模型的数据匹配。
FAQ
如何知道需要使用哪个环境？
可以在雨鸟帐户中找到环境。 登录到帐户，然后转到 Account 页面（左侧导航菜单底部）。 在 About 本节中，你将找到与帐户环境（企业或社区）相关的信息。
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| Api 密钥 | securestring | 与你的 Rainbird 帐户关联的 API 密钥 | True |
| 可选密码 | securestring | 无需密码，请键入任何字符 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 启动 - 启动新会话 |
在知识映射上创建新的会话 ID。 第一步将允许你针对雨鸟模型执行进一步作，例如注入事实或执行查询。 |
| 响应 - 回答问题 |
给雨鸟一个答案。 当 Rainbird 返回查询时，它需要用户或系统输入更多数据。 此作提供回复。 |
| 撤消 - 撤消以前与引擎的交互 |
撤消上一作。 此作将删除执行的最后一个作。 它删除了给 Rainbird 的最后一段数据。 |
| 查询 - 查询正在运行的会话 |
向知识图提问。 此作触发了 Rainbird 的决策引擎。 它执行自动决策，然后提供最终答案。 如果雨鸟需要更多信息来得出结论，它将提出一个问题。 |
| 注入 - 将事实注入会话 |
针对特定会话 ID 在知识映射中注入数据。 这通常在查询之前执行。 这是将数据上传到雨鸟模型的一种方法。 |
| 版本 - 报告引擎版本 |
返回当前雨鸟的推理引擎版本。 |
| 证据 - 返回给定事实的证据 |
基于事实 ID 生成证据。 由雨鸟推断的知识总是附带数据来解释决策过程。 可通过此作访问此数据。 注意：确保证据密钥在雨鸟工作室中处于关闭状态。 |
启动 - 启动新会话
在知识映射上创建新的会话 ID。 第一步将允许你针对雨鸟模型执行进一步作，例如注入事实或执行查询。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
|
知识地图 ID （kmId）
|
kmID | True | string |
要针对其启动会话的知识映射 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | string |
新建会话的 ID |
|
id
|
kmVersion.id | string |
正在查询的版本 ID，在查询知识映射的实时版本时，该 ID 将不同于知识映射 ID |
响应 - 回答问题
给雨鸟一个答案。 当 Rainbird 返回查询时，它需要用户或系统输入更多数据。 此作提供回复。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
|
会话 ID
|
sessionID | True | string |
要向其发送响应的会话 |
|
主题
|
subject | True |
主题端概念实例或值 |
|
|
关系
|
relationship | True |
链接使用者和对象的关系 |
|
|
对象
|
object | True |
对象端概念实例或值 |
|
|
确定性
|
certainty | True | number |
此事实或答案的确定程度 |
返回
- response
- object
撤消 - 撤消以前与引擎的交互
撤消上一作。 此作将删除执行的最后一个作。 它删除了给 Rainbird 的最后一段数据。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
|
会话 ID
|
sessionID | True | string |
使用撤消后退的会话 ID |
返回
- response
- object
查询 - 查询正在运行的会话
向知识图提问。 此作触发了 Rainbird 的决策引擎。 它执行自动决策，然后提供最终答案。 如果雨鸟需要更多信息来得出结论，它将提出一个问题。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
|
会话 ID
|
sessionID | True | string |
要查询的会话 |
|
主题
|
subject | string |
主题端概念实例（对象或主题必需） |
|
|
关系
|
relationship | True | string |
要查询的关系 |
|
对象
|
object | string |
对象端概念实例（对象或主题必需） |
返回
- response
- object
注入 - 将事实注入会话
针对特定会话 ID 在知识映射中注入数据。 这通常在查询之前执行。 这是将数据上传到雨鸟模型的一种方法。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
|
会话 ID
|
sessionID | True | string |
将事实注入到的会话 |
|
主题
|
subject | True |
主题端概念实例或值 |
|
|
关系
|
relationship | True |
链接使用者和对象的关系 |
|
|
对象
|
object | True |
对象端概念实例或值 |
|
|
确定性
|
certainty | True | number |
此事实或答案的确定程度 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
结果
|
result | string |
版本 - 报告引擎版本
返回当前雨鸟的推理引擎版本。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
返回
- response
- string
证据 - 返回给定事实的证据
基于事实 ID 生成证据。 由雨鸟推断的知识总是附带数据来解释决策过程。 可通过此作访问此数据。 注意：确保证据密钥在雨鸟工作室中处于关闭状态。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
环境
|
environment | True | string |
帐户环境：社区（api.rainbird.ai）或企业（enterprise-api.rainbird.ai）。 |
|
事实 ID
|
factID | True | string |
要检索证据的事实 ID |
|
会话 ID
|
sessionID | True | string |
SESSIONID WITH EVIDENCE SECURITY OFF（请参阅模型设置），其中创建了事实 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
确定性
|
fact.certainty | Certainty |
此事实或答案的确定程度 |
|
数据类型
|
fact.object.dataType | string | |
|
类型
|
fact.object.type | string | |
|
value
|
fact.object.value | Object |
对象端概念实例或值 |
|
类型
|
fact.relationship.type | string | |
|
数据类型
|
fact.subject.dataType | string | |
|
类型
|
fact.subject.type | string | |
|
value
|
fact.subject.value | string | |
|
factID
|
factID | string | |
|
conditions
|
rule.bindings.conditions | array of object | |
|
确定性
|
rule.bindings.conditions.certainty | Certainty |
此事实或答案的确定程度 |
|
factID
|
rule.bindings.conditions.factID | factID |
用于提取导致此决定的证据的 ID |
|
对象
|
rule.bindings.conditions.object | Object |
对象端概念实例或值 |
|
objectType
|
rule.bindings.conditions.objectType | string | |
|
关系
|
rule.bindings.conditions.relationship | Relationship |
链接使用者和对象的关系 |
|
凸显
|
rule.bindings.conditions.salience | number | |
|
主题
|
rule.bindings.conditions.subject | Subject |
主题端概念实例或值 |
|
源
|
source | string | |
|
time
|
time | number |
定义
确定性
Subject
关系
物体
factID
对象
这是类型“object”。
字符串
这是基本数据类型“string”。