> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avibe.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Harness

> 一组持久化基础能力，让你的 agent 在自己的时间线上工作——定时、等待、后台运行，并回来汇报。

大多数 AI 工具只在你打字时才动。**Agent Harness** 给你的 agent 一条自己的时间线：一小组可组合的持久化基础能力，让它能发起工作、等到合适的时机、在后台运行、并带着结果回来，不用你守着终端。

## 四个基础能力

* **Run（运行）**——立刻执行一次 Agent 任务。想要答案就同步等，或用 `--async` 丢到后台。
* **Task（定时）**——*时间* 触发器。「每个工作日早上 9 点」「今晚」「午饭后跑一次」。可循环（`--cron`）或一次性（`--at`）。
* **Watch（监听）**——*条件* 触发器。等一个 PR review、一次 CI 结果、一次部署、一个文件、一行日志，或一个长跑进程，然后行动。
* **Runs（历史）**——查看发生了什么、从某次运行继续，或在情况变化时取消。

四者共享同一套运行记录，所以一个定时任务和一个被监听的条件，产生的是同一种可查的 Agent Run。

## 用自然语言说

你不用背参数，直接跟 agent 说：

* 「帮我盯着这个 PR，有 actionable review 再回来处理。」
* 「每个工作日上午跑一遍部署检查，把摘要发到这里。」
* 「为这个 incident 新开一个调查会话，但把结论发回这个频道。」
* 「如果 CI 挂了就总结日志；过了就告诉我这个 PR 能不能合。」

agent 会在背后组合这些 Harness 命令。

## 会话与投递

一次 Harness 运行可以 **接着** 它来自的那段对话跑——同一条 thread、同一份上下文——也可以 **另开** 一个新会话做独立调查。跑完之后，它把结果送到你要的地方：原来的 thread、上一层频道，或 [Workbench](/zh/concepts/workbench) 的 Inbox。正是这一点，让 agent 能离开当前这轮、按自己的节奏干活，又把结果落在该落的地方。

如果要从 CLI 发起这种分叉，使用 `vibe agent run --fork-session <session-id>`。
Avibe 会创建一个新的 Agent Session，并让 native backend fork 源上下文。
fork 会保持源 Session 的 backend；`--agent`、`--model` 和
`--reasoning-effort` 只允许作为同 backend 覆盖参数。

## 为什么重要

这是迈向 [张力驱动的能动性](/zh/concepts/philosophy) 最实在、已落地的一步：一个能离开当前这轮对话、等待、回来、分叉、留记录的 agent，而不只是被动回应你最新的消息。这些自发的回合会实时出现在 [Workbench](/zh/concepts/workbench) 里。

## 参考

每个基础能力的完整 CLI 见 [命令参考](/zh/reference/commands)：`vibe agent`、`vibe task`、`vibe watch`、`vibe runs`。