连接到 Performance Hub
本页内容
将您的人工智能代理与通用聊天机器人区分开来的是,它已接入您的业务。通过 Performance Hub 的 MCP 连接,代理可以查询客户和会员、检查预订和访问记录、审查设备运行状况、提取报告 —— 与您在 Performance Hub 中看到的运营数据完全相同,并且可在代理的对话和自动化中使用。
您可以精确控制代理能够访问的 Performance Hub 范围:哪些设施、哪些功能,甚至哪些具体的工具。本页将对这些选项进行说明。
MCP access 在设备管理中的配置 → MCP access 下进行配置。


图 1:MCP access 部分 —— 访问范围、功能以及开/关切换按钮
快速参考
| 设置 | 默认值 | 选项 |
|---|---|---|
| MCP access | 开启 | 开启 / 关闭 |
| Access scope | This facility | This facility · Selected facilities · Regions · Entire organisation |
| Capabilities | All capabilities | All capabilities · Only selected capabilities · All capabilities except selected |
| Tool selection (位于 Advanced 下) | All tools in the granted capabilities | All tools in the granted capabilities · Only selected tools · All except selected tools |
**建议:**保持 MCP access 开启(默认设置)。此连接使代理真正对您的业务有用,并且在默认情况下,它被安全地限制在添加代理的设施范围内。如果您稍后需要代理处理更广泛的数据(多个站点、某个地区或整个组织),请扩大 Access scope,而不是在没有连接的情况下运行。“如果关闭此功能,代理将无法访问任何 Performance Hub 功能、工具或数据。”
连接为代理提供的内容
MCP (Model Context Protocol) 是代理用于调用 Performance Hub 的开放标准:“允许该代理通过服务账户调用 Performance Hub 工具。设备上不存储密钥 —— 每次请求都会验证访问权限,并在您关闭此功能时立即撤销。” 实际上,这意味着您可以提出如下问题:
- “本周前台签到的访客人数与上周相比如何?”
- “当前有哪些门禁控制器处于离线状态?”
- “查找昨天付款失败的客户并总结其账户信息。”
……代理将根据实时 Performance Hub 数据进行回答,并受限于您授予的权限。相同的连接支持自动化功能(例如昨日预订的早间摘要、每周设备健康状况摘要)以及技能中描述的内置运营手册。
代理在 Performance Hub 中充当其自身的身份(绑定到设备的服务账户),而不是某个特定的人。它发出的每个调用都会根据您在此处授予的访问权限在 Performance Hub 端进行检查 —— 权限是在中心端强制执行的,而不是基于信任。
Access scope —— 代理可以看到哪些设施
- This facility(默认)—— 添加代理的设施。适用于单站点代理。
- Selected facilities —— 仅您列出的设施。适用于服务于少数站点的代理。
- Regions —— 所选地区中的每个设施。适用于区域经理的代理。
- Entire organisation —— 所有内容。适合进行跨站点报告的总部代理。
“您只能在您自己的设施、地区和权限范围内授予访问权限。”
Capabilities —— 代理可以使用什么
Capabilities 是绑定到 Performance Hub 模块的工具组。
- All capabilities(默认)—— “代理可以使用所有可用功能,包括后续添加的新功能。”
- Only selected capabilities —— “代理只能使用您在下面选择的功能。” 代理仅获得这些功能,绝无其他功能,即使您的订阅发生更改也是如此。
- All capabilities except selected —— “代理可以使用除您在下面选择的功能之外的所有功能。新功能会自动包含在内。” 这是一个很好的折中方案:既能全面实用,又排除了某些功能(例如计费)。
该部分还有一个只读开关:将其打开后,代理可以查询信息但不能更改任何内容,因为会隐藏和拒绝执行会产生更改的工具。这是运行严格信息型代理的最简单方法。
Tool selection(高级)
如需进行精细控制,请展开 Advanced 并选择 Tool selection(Only selected tools 或 All except selected tools),以在所授予的功能中包含或排除单个工具。例如,您可能允许客户查询,但拒绝客户更新。大多数设施从不需要此功能;功能级别的控制已是实用的粒度。
Last updated by 显示最后更改授权的人员。
关于写入操作的说明
除非您开启了只读开关,否则授权将涵盖功能所公开的所有内容——在模块提供此类功能的情况下,甚至包括更改数据的操作,而不仅仅是读取数据。要使代理保持纯信息提供状态,请使用只读开关,或将其限制为以报告为导向的功能,或者排除特定的工具。代理在采取重要操作之前,也会在对话中进行确认。
关闭并撤销访问权限
- 将 MCP access 关闭,代理将立即断开与 Performance Hub 的连接——它将继续作为带有文件和 Memory 的通用助手正常工作,但无法再查看您的业务数据。更改(开启、关闭或范围编辑)在保存后片刻即可生效;无需重启。
- 移除或重置代理将彻底撤销其凭据。
谁可以授予什么权限
授权受限于授权者本人:您在组织中拥有的范围和功能,就是您能授予代理的上限。如果某个选项不可用,是因为您自己的角色不包含该权限——拥有必要访问权限的管理员可以代为设置。如果您完全无法更改 MCP access,该部分将显示*“您没有权限为此设备配置 MCP access。”*
相关页面
- Skills — 使此连接投入运作的操作手册
- Agent capabilities — 将代理连接到您的其他应用
- Automations & scheduled tasks — 使用 Performance Hub 数据的无人值守作业
- Access control — 谁可以与代理对话(这与代理可以访问什么内容是两个独立的问题)
- Security & privacy