代理使用手册
将 Claude、ChatGPT、Cursor、VS Code 或任何 MCP 客户端连接到你的工作区,选择每个代理能做什么,并始终掌握主动权。
代理能做什么
代理让你已经在用的 AI 应用在 SimuLive 工作区中工作。你用日常语言提出需求,代理会用你允许的工具查询或进行更改。
SimuLive 不提供 AI。你使用自己的应用和账号,SimuLive 为它提供安全的入口。
- 查看系列、运行手册、资料库、统计和账单。
- 创建和更新系列,处理请求并管理文件。
- 操控直播:暂停、跳转和切换幻灯片。
连接代理
在工作区打开“代理”并选择“连接”。选择你使用的应用,按屏幕上的三个简单步骤操作。
应用会在浏览器中打开 SimuLive。确认应用名称和返回地址,选择权限后点击“批准”。你会以登录状态直接回到应用。
无需复制任何密钥。如果先要求登录,登录后请求会继续。
支持的应用
每个应用的连接方式略有不同。“连接”窗口会显示所选应用的具体步骤。
- 网页版和桌面版 Claude:添加自定义连接器并粘贴服务器 URL。
- ChatGPT:开启开发者模式,创建连接器并粘贴服务器 URL。
- Cursor:一键安装服务器,然后点击“连接”。
- VS Code:一键安装服务器,然后在 MCP 列表中启动。
- Claude Code:运行显示的命令,然后输入 /mcp。
- 其他代理:添加服务器 URL,或使用代理密钥。
按区域选择权限
权限按区域设置,例如成员、系列、直播控制、资料库或账单。“快速设置”会为所有区域应用同一级别,之后可单独修改任一区域。
设为“无权限”的区域对代理完全隐藏。你自己的工作区角色仍然生效,因此代理永远不会超出你的权限。
- 无权限:代理看不到此区域。
- 读取:仅能查看。
- 更改:还能创建和更新,每次更改都需要你确认。
- 完全:还能删除并重新开始直播。
建议先从“只读”开始,需要时再增加。
用于其他工具的代理密钥
无法登录的工具(例如 Slack 机器人或自动化脚本)使用代理密钥。选择“创建代理密钥”,命名并选择区域,然后复制密钥。密钥只显示一次。
将密钥作为 Bearer 令牌发送到服务器 URL。可轮换的密钥之后可以生成新密钥值,而不改变名称和权限。
- 请把密钥保存在密钥管理工具中,切勿放在共享文件里。
- 不再需要时请立即撤销密钥。
代理的直播控制
拥有直播控制权限后,代理可以列出正在直播的场次,并查看每场正在播放的内容。
拥有“更改”权限时,它还能暂停、继续、跳转和切换幻灯片。重新开始和重新加载需要“完全”权限,因为观众会看到。
- list_live_runs 和 get_live_state 仅读取。
- control_series_run 可暂停、跳转和切换幻灯片。
- change_series_run_content 可重新开始或重新加载内容。
- 代理操作时,场次所有者和管理员会收到铃铛通知。
内置安全
所有代理都在同样的限制内工作。
- 每次更改都会先在聊天中请你确认。
- 更改有频率限制,直播控制在两次操作之间会等待几秒。
- 每次更改都会记录在审计日志中。
- 代理把文件和工单中的文字视为数据,而不是指令。
- 付款、席位、存储包、取消订阅和密钥只在网站上管理。
查看和撤销连接
每个连接都显示在“代理密钥”中,标记为“已连接应用”,并显示权限和最近使用时间。
选择“撤销”即可断开。访问会立即停止,应用需要重新连接。管理员可以查看并撤销工作区中的所有连接。
成员离开工作区或被暂停后,其连接也会停止工作。
遇到问题时
以下是常见情况。
- 连接请求已过期:请从应用重新连接。
- 工具不可用:为该区域提高权限,或检查你的角色。
- 请等几秒再试:直播控制刚刚被使用过。
- 应用中已退出登录:请重新连接并批准。