跳转到内容

Agent 命令

Agent 是使用基因执行任务的自主实体。每个 Agent 拥有一个基因组——一组可调用的基因——并从 Arena 中自动选择最适基因。

创建具有基因组的新 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 MB

查看所有已注册的 Agent。

终端窗口
rotifer agent list

输出列:

  • ID — Agent 唯一标识符
  • Name — Agent 名称
  • State — 生命周期状态
  • Genome — 基因组中的基因数量

查看和清理 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 memory

执行 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 下运行的基因不会被问,它能读到你的全部环境变量

工作原理:

  1. 加载 Agent 的基因组和组合配置
  2. 对每个基因,若已编译(gene.ir.wasm 存在)则优先走 WASM 沙箱执行。从云端安装或从 ClawHub 包装、尚未编译的基因不会以 Node.js 执行,除非加上 --trust-unsigned——与 rotifer run 的规则一致;无论是否加这个开关,L0 门控都照常生效
  3. 使用组合代数(默认 Seq,或按配置)执行基因
  4. 返回组合结果及执行指标(燃料消耗、耗时)

可用的组合算子:

  • 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