连接到 Performance Hub

本页内容

将您的人工智能代理与通用聊天机器人区分开来的是,它已接入您的业务。通过 Performance Hub 的 MCP 连接,代理可以查询客户和会员、检查预订和访问记录、审查设备运行状况、提取报告 —— 与您在 Performance Hub 中看到的运营数据完全相同,并且可在代理的对话和自动化中使用。

您可以精确控制代理能够访问的 Performance Hub 范围:哪些设施、哪些功能,甚至哪些具体的工具。本页将对这些选项进行说明。

MCP access 在设备管理中的配置 → MCP access 下进行配置。

MCP access 部分,允许代理在此设施使用 Performance Hub 工具MCP access 部分,允许代理在此设施使用 Performance Hub 工具

图 1:MCP access 部分 —— 访问范围、功能以及开/关切换按钮

快速参考

设置默认值选项
MCP access开启开启 / 关闭
Access scopeThis facilityThis facility · Selected facilities · Regions · Entire organisation
CapabilitiesAll capabilitiesAll capabilities · Only selected capabilities · All capabilities except selected
Tool selection (位于 Advanced 下)All tools in the granted capabilitiesAll 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。”*