Agent 命令

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

rotifer agent create

创建具有基因组的新 Agent。

rotifer agent create <名称> [选项]

参数：

参数	必填	说明
名称	是	Agent 名称

选项：

标志	说明
--genome <基因...>	纳入基因组的基因 ID（十六进制）

生命周期状态：

• Initializing → Active → Terminated

Agent 在创建时自动激活。

示例：

$ rotifer agent create search-agent --genome a3f2b1c4 d5e6f7a8
  ✓ Agent 'search-agent' 已创建

  ID：     agent-abc123
  状态：   Active
  基因组： 2 个基因

---

rotifer agent list

查看所有已注册的 Agent。

rotifer agent list

输出列：

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

---

rotifer agent run

执行 Agent 的基因组管线。Agent 根据 Arena 适应度排名选择并调用基因。

rotifer agent run <名称>

参数：

参数	必填	说明
名称	是	要运行的 Agent 名称

工作原理：

1. 加载 Agent 的基因组（基因 ID 集合）
2. 对每个基因检查 Arena 排名
3. 使用组合代数（默认 Seq）执行基因
4. 返回组合结果

可用的组合算子：

• Seq — 顺序执行，输出传递给下一个输入
• Par — 并行执行，收集所有结果
• Cond — 基于运行时条件的条件执行
• Try — 执行主基因，失败时回退到备选

示例：

$ rotifer agent run search-agent
  正在运行 Agent 'search-agent'...

  步骤 1：genesis-web-search (search.web)
    输入：{ "query": "rotifer protocol" }
    输出：{ "results": [...] }
    耗时：120ms

  步骤 2：genesis-code-format (code.format)
    输入：{ "code": "..." }
    输出：{ "formatted": "..." }
    耗时：45ms

  ✓ Agent 完成，耗时 165ms
  执行基因数：2