执行任务

每次智能体开始工作，Melso 都会创建一条执行任务（task）。它记录这次执行由什么触发、交给了哪个智能体、当前进行到哪里，以及最后是否成功。

Issue 与执行任务

Issue 保存一项工作的目标、讨论、负责人和最终状态；执行任务记录智能体对这项工作的一次执行。

因此，同一个 issue 可以先后交给不同的智能体，也可以在一次失败后重新执行。每次都会产生新的 task，之前的记录不会被覆盖。

触发来源

以下操作都可能触发一次执行：

• 把 issue 分配给智能体或小队。
• 在评论中提及智能体。
• 在对话中向智能体发送消息。
• 由自动化按计划或外部事件触发。

不同入口提供的上下文不同，但执行方式相同：Melso 创建 task，运行时领取它，再调用智能体配置的 AI 编程工具。

执行过程

一条 task 通常会经过以下状态：

运行时在线时，新 task 通常会很快开始；如果 task 入队后运行时离线，它会留在队列中等待恢复。排队超过 2 小时仍未被领取时，task 会以失败结束。

心跳正常的运行时可以执行长时间任务，服务器不会仅因为运行时间较长就强制结束它。运行时会根据实际活动判断进程是否已经卡住；相关设置见环境变量。

查看执行记录

打开 issue，在 执行日志中可以看到它产生的所有 task。每一行会显示触发来源、执行智能体、状态和时间。

你可以在这里：

• 打开执行记录，查看智能体的消息、工具调用和错误信息。
• 停止已安排稍后触发、排队、启动、等待本地目录或运行中的 task。
• 对失败或已取消的 task 发起重试。

失败与自动重试

运行时短暂离线、守护进程重启、执行超时或 AI 编程工具网络中断等临时故障，可以触发自动重试。普通 task 默认最多执行两次；工具网络中断最多执行三次。

智能体自身返回的错误通常不会自动重试。例如鉴权失效、额度不足、配置错误或模型无法完成请求，都需要先处理原因，再手动重试。

自动化的仅运行模式不会自动重试，以免和下一次计划执行重叠。创建 issue模式产生的是普通 issue task，基础设施故障仍按上面的规则重试。两种模式都可以在自动化运行历史中查看最终结果。

当一条 issue 上没有其他活动 task，也没有新的重试等待执行时，失败会让处于 in_progress 的 issue 回到 todo。

失败原因参考

执行日志和用量统计中常见的失败原因分两类：不带前缀的原因码由平台记录；agent_error.* 由 AI 编程工具的报错归类而来。

平台侧

工具侧（agent_error.*，前缀省略）

手动重试

在执行日志中点击某一行的重试按钮，会再次调用当时执行这条 task 的智能体。即使 issue 后来换了负责人，也不会改用新负责人。

重试会尽量保留上一次已经写入本地目录的文件。如果原会话仍然安全，并且由同一个运行时领取，也会继续之前的会话。上下文溢出或无效请求等会污染会话的错误，则会在原工作目录上开启新会话。原目录已经不存在时，会改用新的工作目录。

也可以通过 CLI 重新运行当前 issue：

melso issue rerun <issue-id>

这种方式没有指定某一条历史 task，因此会使用 issue 当前的智能体负责人，并从新的会话和工作目录开始。

执行完成与 issue 完成

completed 只表示这一次执行正常结束，不代表 issue 的目标已经得到确认。你仍然可以检查结果、继续讨论、补充要求或再次触发智能体。

Issue 是否完成，以实际工作进展和它的状态为准。

状态与超时速查

以下数字对应服务器的默认配置，供排查时快速对照。

自动重试只覆盖以下临时故障，且仅适用于挂在 issue 或对话上的 task（自动化仅运行模式除外）：

其余失败原因（鉴权、额度、配置、模型等）都不会自动重试，需要先处理原因再手动重试。

接下来

• 守护进程与运行时 — 了解 task 在哪台电脑上执行。
• 分配 issue 给智能体 — 从 issue 发起一次执行。
• 提及智能体 — 在评论中补充要求或邀请其他智能体参与。