Agent 命令
Agent 是使用基因执行任务的自主实体。每个 Agent 拥有一个基因组——一组可调用的基因——并从 Arena 中自动选择最适基因。
rotifer agent create
Section titled “rotifer agent create”创建具有基因组的新 Agent。
rotifer agent create <agent-name> [选项]参数:
| 参数 | 必填 | 说明 |
|---|---|---|
agent-name | 是 | Agent 名称 |
选项:
| 标志 | 说明 |
|---|---|
-g, --genes <基因...> | 纳入基因组的基因名称 |
--composition <类型> | 组合类型:Seq(默认)、Par、Cond、Try、TryPool |
--par-merge <策略> | Par 分支合并策略:first(默认)、concat、merge |
--domain <域> | 从指定域自动选择排名靠前的基因 |
--top <n> | 自动选择的基因数量(默认:2) |
--strategy <策略> | 基因选择策略(默认:greedy) |
--memory-quota <大小> | Agent 的记忆配额:带 KB、MB 或 GB 的数,例如 50MB(默认:10MB)。见 Memory API。 |
生命周期状态:
Initializing→Active→Terminated
Agent 在创建时自动激活。
示例:
# 顺序管线(默认)$ rotifer agent create search-agent --genes web-search code-format ✓ Agent 'search-agent' 已创建 基因组:web-search → code-format (Seq)
# 并行执行$ rotifer agent create multi-search --genes web-search doc-search --composition Par --par-merge concat 基因组:web-search ∥ doc-search (Par)
# 条件分支$ rotifer agent create smart-agent --genes fast-search deep-search --composition Cond 基因组:fast-search / deep-search (Cond)
# 设更大的记忆配额$ rotifer agent create my-agent --genes hello-world --memory-quota=50MB ✓ Agent 'my-agent' 已创建 记忆配额:50 MBrotifer agent list
Section titled “rotifer agent list”查看所有已注册的 Agent。
rotifer agent list输出列:
- ID — Agent 唯一标识符
- Name — Agent 名称
- State — 生命周期状态
- Genome — 基因组中的基因数量
rotifer agent memory
Section titled “rotifer agent memory”查看和清理 Agent 在记忆里存了什么。两个命令都以 Agent 部署者的身份执行,不受条目访问策略的限制。条目是什么,见 Memory API。
rotifer agent memory list <agent-name> [options]rotifer agent memory delete <agent-name> (--key <键名> | --category <类别>)list 选项:
| 参数 | 说明 |
|---|---|
-c, --category <category> | 只列这一类:PREFERENCE、PATTERN、CONTEXT 或 CACHE |
list 列出每条记忆的键名、类别、大小、创建它的 Gene 和最近更新时间,最后显示配额用了多少。它从不显示值。
delete 选项(必须给且只给一个):
| 参数 | 说明 |
|---|---|
-k, --key <key> | 删除这个键名的条目 |
-c, --category <category> | 删除这一类的全部条目 |
delete 会显示删了几条。删除不存在的键会返回 MEMORY_NOT_FOUND。PREFERENCE 条目不会为腾地方被清掉,记忆写满时就用它来清。每次删除都会记进审计日志。
示例:
$ rotifer agent memory list my-agent --category PREFERENCE$ rotifer agent memory delete my-agent --category CACHE✓ Deleted 3 entries from my-agent's memoryrotifer agent run
Section titled “rotifer agent run”执行 Agent 的基因组管线。Agent 根据 Arena 适应度排名选择并调用基因。
rotifer agent run <agent-name>参数:
| 参数 | 必填 | 说明 |
|---|---|---|
agent-name | 是 | 要运行的 Agent 名称 |
选项:
| 标志 | 说明 |
|---|---|
--input <json> | 管线的输入 JSON(默认:{"name":"world"}) |
--verbose | 显示每步中间输入/输出 |
--no-sandbox | 强制使用 Node.js 执行(跳过 WASM 沙箱) |
--trust-unsigned | 允许从云端安装或从 ClawHub 包装的基因以 Node.js 执行 |
--allow-credentials <list> | 允许外来基因使用你环境变量里的这些凭证,每个只发往对应的 host:KEY@api.example.com,KEY2@other.example.com。不加时,在沙箱里运行的外来基因声明了凭证,命令会在终端里问一次(默认不给),不在终端里运行则以 credentials_not_granted 退出 1。这只管沙箱里的基因:加 --trust-unsigned 在 Node.js 下运行的基因不会被问,它能读到你的全部环境变量 |
工作原理:
- 加载 Agent 的基因组和组合配置
- 对每个基因,若已编译(
gene.ir.wasm存在)则优先走 WASM 沙箱执行。从云端安装或从 ClawHub 包装、尚未编译的基因不会以 Node.js 执行,除非加上--trust-unsigned——与rotifer run的规则一致;无论是否加这个开关,L0 门控都照常生效 - 使用组合代数(默认 Seq,或按配置)执行基因
- 返回组合结果及执行指标(燃料消耗、耗时)
可用的组合算子:
- Seq — 顺序执行,输出传递给下一个输入
- Par — 并行执行,收集所有结果
- Cond — 基于运行时条件的条件执行
- Try — 执行主基因,失败时回退到备选
- TryPool — 在候选池中依次尝试,返回首个成功结果
示例:
$ rotifer agent run search-agent --verbose 正在运行 Agent 'search-agent'...
[1/2] genesis-web-search 通过 WASM 沙箱完成 (23ms, 燃料: 42000) 输入:{ "query": "rotifer protocol" } 输出:{ "results": [...] }
[2/2] genesis-code-format 通过 WASM 沙箱完成 (12ms, 燃料: 18500) 输入:{ "code": "..." } 输出:{ "formatted": "..." }
✓ 管线执行完成 执行基因数:2 耗时:35ms