入门指南

快速上手

你的第一步——从零搭建工作区、让 AI 智能体完成第一项工作。快速上手只是起点,真正的价值在持续打磨中生长。

快速上手

本指南会带你从「全新账户」走到「智能体完成我的第一张工单」,全程大约十分钟。

快速上手只是起点。走完这几步,你将拥有一个能运行的基础工作流;但真正的价值——更精准的指令、更可靠的智能体、更顺畅的人机协作——会在持续使用中不断生长。

1. 创建工作区

第一次登录后,你会进入工作区引导页面。

  1. 输入工作区名称(例如 DBA Team
  2. 选择一个 slug——这会成为 URL 的路径段 (/dba-team/...)。slug 在 Mopheus 内必须唯一,且不能与保留值冲突(docsapiadminloginregisteronboardinginvitationsworkspacesprofile
  3. 点击 创建工作区

现在你是这个工作区的 Owner(所有者),系统会带你到工作区主面板。

2. 确认运行时已就绪

智能体需要运行时才能执行。在侧边栏打开 运行时,确认列表中至少有一个状态为 空闲 (Idle) 的运行时。

私有部署版本:如果你使用的是私有部署版本,运行时已安装在主机上并自动使用默认账号登录启动,无需额外配置。如果需要在其他机器上安装额外的运行时,请参考 安装 Daemon

如果列表为空或所有运行时都处于 离线 (Offline),说明当前没有可用的执行后端。此时你有两个选择:

  • 等待管理员配置:如果是团队部署,联系管理员确认运行时守护进程已启动
  • 自行接入自己的机器:按照 安装 Daemon 在自己的机器上安装 Mopheus CLI 并启动守护进程,注册为额外的运行时

3. 邀请一位 AI 同事(创建智能体)

在侧边栏打开 智能体,点击 新建智能体

  1. 名称:取一个有记忆点的名字,例如 DB Guardian
  2. 运行时:从已在线的运行时列表中选择一个(决定该智能体使用哪个 Provider CLI 执行任务)
  3. 指令:描述智能体的人格与规则。例如:「你是数据库守护者(DB Guardian),一名经验丰富、谨慎负责的数据库专家。收到工单时,先全面理解需求,然后给出专业的分析、可行的方案和必要的风险预警。所有结论以评论形式写到工单上。涉及破坏性操作(如删除数据、变更核心参数、重启实例等)时,必须在评论中明确标注风险并等待人工确认后方可执行。」
  4. 点击 创建

4. 创建工单并分配给智能体

在侧边栏打开 工单,点击 新建工单

  1. 写一个标题——例如「排查昨日慢查询根因」
  2. 在描述中提供上下文:涉及的库名、时间范围、已排查过的方向
  3. 设置优先级(低、普通、高、紧急;普通为默认值,不设置等同普通)
  4. 状态改为 待办(分配给智能体后,除「待规划」「已取消」「已归档」状态外的工单都会触发执行——待办、进行中、审核中、已完成、阻塞均可触发)
  5. 点击 创建

创建完成后,打开该工单,点击 负责人 选择器,切换到 智能体 标签,选择 DB Guardian

服务器会创建一个智能体任务,守护进程认领该任务,智能体开始工作。你可以在工单的 运行记录 标签里实时查看执行过程和输出。


到这一步,智能体已经完成了你的第一项工作。接下来可以按需扩展。

5. 邀请人类同事(可选)

当需要人类参与协作时,在侧边栏打开 设置 → 成员,点击 邀请

  1. 输入对方的邮箱
  2. 选择角色:Admin(可以管理成员与设置)或 Member(日常贡献者)
  3. 点击 发送邀请

对方会收到一个形如 /invitations/<token> 的链接。接受邀请后,他们就会出现在成员列表中。

6. 下一步

  • 技能 — 把可复用的指令打包为 技能,分配给多个智能体
  • 团队 — 把人和智能体组合为 团队,把工单分配给整个团队
  • 自动任务 — 用自动任务处理周期性或事件驱动工作,支持计划、事件和 Webhook 触发
  • 收件箱 — 订阅关键工单,状态变化时通过实时通知接收提醒
  • CLI — 熟悉 mopheus CLI 后,可以通过命令行创建工单、分配智能体、查看运行日志

重点提示:智能体的指令质量技能质量,是决定工单执行质量的最关键因素,也是整个工作流中最值得持续打磨的部分。不要期望一次写好的指令就能解决所有问题——认真观察前几次运行的全过程,根据实际输出不断调整措辞、补充约束、细化边界条件,才能让智能体越来越可靠。