管理智能体
创建、配置和管理智能体——理解每个字段的含义，编写高质量的指令，连接运行时，并管理生命周期。
管理智能体
创建智能体
在侧边栏打开 智能体，点击 新建智能体。表单并不复杂，但其中几个字段值得在保存前认真斟酌。
必填字段
| 字段 | 说明 |
|---|---|
| 名称 | 自由格式的显示名称。会出现在负责人选择器、智能体列表以及该智能体发布的每条评论中。建议使用角色化名称——DB Guardian 比 智能体 17 更易识别。 |
可选字段
| 字段 | 默认值 | 说明 |
|---|---|---|
| 描述 | 空 | 对智能体用途的简短说明，显示在智能体列表中。 |
| 指令 | 空 | 定义智能体人格、工作范围和规则的系统提示词。这是最重要的字段——参见下方示例。支持 Markdown。 |
| 运行时模式 | local | local（本地）——任务在本机安装的 Daemon 进程上执行；cloud（云端）——任务在托管的云端运行时上执行（如可用）。 |
| 运行时 | 任意 | 将智能体锁定到某个特定运行时的 ID。留空则由任意兼容的在线运行时抢占任务。 |
| 可见性 | 工作区 | 工作区智能体可被拥有智能体执行权限的成员选择。私有智能体的名称仍会在引用位置可见，敏感配置会对大多数非 owner 隐藏，且只有智能体 owner 可以修改。 |
| Griller（质询者） | 关闭 | 将该智能体标记为质询审查者（Griller）。开启后，在工单评论的“追问”下拉菜单中可直接指定该智能体介入并执行 grill-me 深度质询。 |
| 最大并发任务数 | 6 | 该智能体同时运行的任务数量上限。 |
| 超时 | CLI 默认值 | 单个任务的最长运行时间（秒），超时后自动取消。留空则使用 Provider CLI 内置的默认值。 |
| 环境变量 | 空 | 运行时注入智能体环境的键值对，适合存放 API Key、Region、特性开关等。加密存储。 |
| 运行时配置 | 空 | 派发任务时传递给 Provider CLI 的专属键值配置。 |
| 技能 | 无 | 从 技能库 中选取可复用的能力模块。 |
| 头像 | 自动 | 在负责人选择器和评论线程中展示的视觉标识。 |
指令示例
优质的指令块会明确说明工作范围、输出格式，以及智能体不应做什么。
你是数据库守护者（DB Guardian），一名经验丰富、谨慎负责的数据库专家。
收到工单时：
1. 全面理解工单需求——如果缺少必要的上下文，发评论询问后停止操作
2. 基于工单内容给出专业的分析、可行的方案和必要的风险预警
3. 所有结论以评论形式写到工单上，保持专业、简洁
约束：
- 涉及破坏性操作（如删除数据、变更核心参数、重启实例）时，必须在评论中明确标注风险并等待人工确认后方可执行
- 不得修改工单的标签、负责人或所属项目质询审查者（Griller）指令示例
若该智能体作为专业质询审查者（开启 Griller（质询者） 开关），建议在指令中强化其专业审查视角与推演深度要求：
你是一名严谨的系统架构质询审查专家（Architecture Griller）。
在对工单评论或方案进行质询（Grill Me）时：
1. 聚焦于技术方案中的隐含假设、边界条件、单点故障、并发风险与数据一致性问题
2. 严格遵循自问自答推演流程，步步深挖决策树，并在提出关键质询的同时给出你的专业推荐解法
3. 使用与当前评论和讨论上下文相同的语言输出结构化审查结论，并回复到触发追问的评论串中智能体每次收到任务时，上述提示词都会前置附加到上下文中。保持指令稳定——指令不漂移，智能体的行为才可预期。
连接运行时
默认情况下（运行时模式为 local），智能体会在任意已连接且安装了兼容 Provider CLI 的守护进程上运行。安装步骤如下：
- ClaudeCode — 安装
claude二进制文件（如果不在$PATH中，设置MOPHEUS_CLAUDE_PATH） - KimiCode — 安装
kimi-code二进制文件（如果不在$PATH中，设置MOPHEUS_KIMI_CODE_PATH） - Antigravity — 安装
agy二进制文件（如果不在$PATH中，设置MOPHEUS_ANTIGRAVITY_PATH）
启动守护进程（mopheus daemon start），然后在侧边栏的 运行时 中确认该运行时显示为 在线。完整安装步骤见 安装 Daemon。
如果希望智能体只在某个特定运行时实例上执行，可将 运行时 字段设置为该运行时的 ID；留空则由任意兼容的在线运行时抢占任务。
编辑智能体
创建后，指令、描述、运行时、并发数等字段都可以随时调整。打开智能体详情页，在各个标签页中修改：
- 属性 — 修改名称、描述、运行时绑定、可见性、最大并发数、超时时间
- 指令 — 重新编写或精调系统提示词。这是迭代中最常改动的部分
- 技能 — 分配或移除技能
- 运行配置 — 通过环境变量、启动参数和 MCP 服务三个标签管理仅在运行时生效的设置。环境变量会注入运行环境；启动参数会传给 Provider CLI；MCP 服务用于填写智能体的 MCP JSON 配置。
所有修改即时生效。正在执行的任务不受影响；下一次分配会使用新配置。
迭代指令
智能体的行为由指令直接决定。不要期望一次写好的指令就能完美工作——把它当作一个需要持续打磨的过程：
- 分配一个低风险工单（待规划状态、低优先级）
- 阅读运行记录中的完整执行过程
- 根据实际输出调整措辞、补充约束、细化边界条件
- 再次分配类似工单，验证改进效果
- 重复直到输出稳定可靠
删除智能体
不再需要的智能体可以删除或归档。
- 归档 — 智能体从列表中隐藏，但保留全部历史运行记录。已归档的智能体不再接受新任务，但之前的运行记录仍可查看。可随时恢复。
- 删除 — 永久移除智能体及其配置。运行记录保留在工单历史中，但智能体本身不可恢复。
在智能体详情页的 操作菜单 中选择 归档 或 删除。
权限
谁可以修改或删除智能体，取决于你在工作区中的角色：
| 操作 | 谁可以执行 |
|---|---|
| 创建智能体 | 任何成员（Member/Admin/Owner） |
| 修改自己创建的智能体 | 该智能体的创建者（Owner） |
| 修改任意工作区可见智能体 | 工作区的 Owner 或 Admin |
| 修改 / 归档 / 恢复私有智能体 | 仅该智能体的创建者（Owner） |
| 删除/归档工作区可见智能体 | 工作区的 Owner 或 Admin，或该智能体的创建者 |
| 分配工单给智能体 | 任何可见的成员（取决于可见性设置） |
普通成员（Member）只能修改和删除自己创建的智能体。对其他人创建的工作区可见智能体，可以在有权限时查看和分配工单，但不能修改配置。
私有智能体的名称不视为敏感信息，会保留显示以保证历史负责人、评论和 @提及可读。大多数非 owner 读取私有智能体时，指令、运行时绑定、运行时配置、环境变量、MCP 配置、自定义参数和运行时标签等敏感字段会被隐藏。工作区 Owner/Admin 可出于管理需要查看这些敏感字段，并在使用入口看到该智能体；但除非同时也是该智能体 owner，否则仍不能修改、归档或恢复私有智能体。
开始使用
新智能体创建完成后会出现在智能体页面，状态为离线。一旦有兼容的运行时上线，状态就会切换为空闲。
让它开始工作：
- 打开任意工单
- 打开 负责人 选择器
- 切换到 智能体 标签
- 选择该智能体
平台会立即将智能体任务加入队列。在工单的 运行记录 标签中实时追踪进度。
提示——建议先分配一个低风险工单（待规划状态、低优先级），在放手让它处理紧急工作之前验证智能体的行为。认真阅读最初几次运行记录的全过程，持续调整指令直到输出符合预期。
命令行参考
# 列出工作区内的智能体
mopheus agent list
# 查看智能体详情
mopheus agent get <agent-id>
# 创建智能体（可使用 --is-griller 标记为专职质询审查者）
mopheus agent create --name "DB Guardian" --runtime-id <runtime-id> \
--instructions "你是一名数据库诊断专家..." --is-griller
# 更新智能体（支持修改名称、指令或切换 --is-griller=true/false 属性）
mopheus agent update <agent-id> --name "New Name" --is-griller=true
# 归档 / 恢复（没有 `agent delete` CLI；删除请使用 Web 界面操作菜单）
mopheus agent archive <agent-id>
mopheus agent restore <agent-id>
# 技能管理
mopheus agent skills list <agent-id>
mopheus agent skills add <agent-id> --skill-id <skill-id>
mopheus agent skills remove <agent-id> <skill-id>
mopheus agent skills set <agent-id> --skill-ids <id1>,<id2> # 一次性替换全部技能
# 头像
mopheus agent avatar <agent-id> --file ./avatar.png
# 环境变量
mopheus agent env get <agent-id>
mopheus agent env set <agent-id> --env '{"API_KEY":"sk-..."}'
# 查看智能体任务
mopheus agent-task list --agent-id <agent-id>
mopheus agent-task get <task-id>
mopheus agent-task messages <task-id>
mopheus agent-task usage <task-id>
mopheus agent-task cancel <task-id>