托管控制面
适用范围:当前托管生产使用组织工作区。个人工作区及其所有者自审需等待控制面升级;自部署实例请按实际版本与身份配置判断。
用托管控制面时,控制面由我们运行,Agent 由你们运行。
| 我们运行 | 你们运行 |
|---|---|
| 控制面:项目、成员、策略及其版本、审核、审批票据、事件、控制操作审计 | 你们的 Agent,带 Guard SDK 或 MCP 代理 |
| 控制台 | 你们的工具、MCP 服务和业务系统 |
| 私有 SDK 源 | 你们自己部署的 HTTP broker 或独立的 MCP 代理 |
每次判定都在你们的环境里、按本地缓存的策略做出。控制面只收到脱敏事件。见安全说明。
开始
组织由我们和你们一起开通,也可以你们自己用 Yi Labs 账号登录后创建。之后按快速开始:托管控制面操作。
如果你们的 Agent 要经过公司代理上网,或者需要信任公司自己的根证书,设置 PREWORLD_GUARD_PROXY 和 PREWORLD_GUARD_CA_BUNDLE,或者给 GuardClient 传 proxy= 和 ca_bundle=。它们只作用于 SDK 访问控制面的流量。
时间
| 项目 | 多久 |
|---|---|
| 新发布的策略到达执行器 | 大约 15 秒(心跳间隔) |
| 撤销接入后切断对应的 Agent | Agent 下一次联系控制面时,通常几秒之内 |
| 控制台会话 | 15 分钟,不会延长 |
| 执行器凭据 | 默认 90 天 |
| SDK 下载令牌 | 1 到 365 天,自己选 |
| 认领我们预开通的空间 | 7 天 |
| 审批票据 | 1 小时 |
目前的限制
- 单节点,没有高可用:每天备份一次,最坏情况下可能丢失 24 小时内的数据。没有 7×24 小时告警。
- 升级窗口:控制面升级时会有 1 到 3 分钟不可用,我们会提前通知。这期间:
- 执行器继续按缓存的策略判定。
- 新的审批既提交不了,也用不了。
- 执行器连不上控制面超过 5 分钟后,阻断所有受保护的动作,直到重新连上。
- 容量:每个项目最多保留 100,000 条事件,保留 30 天。需要导出时联系我们。
- 组织:每个组织最多创建 100 个项目。
停止使用托管服务
你们的组织停止使用托管控制面时:
- 所有执行器凭据、会话和 SDK 下载令牌立即失效。
- 未完成的审批全部取消。
- 你们要求的话,数据会被清除。备份里的副本随备份过期删除,最长 30 天。
账号恢复在 Yi Labs 账号里处理。需要导出、清除数据或停止使用,请通过我们的联系页面联系。