必须安装agentrouter并注册8大agent运行时，才能实现按任务自动选agent、统一调度与会话管理；未安装则仍需手动调用各agent。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Agent Space中按任务自动挑选最合适的Agent并集中调度管理，必须通过AgentRouter统一接入所有运行时，否则每个Agent仍需单独调用、各自解析、手动续会话。
安装并启用AgentRouter调度层
执行 npm install -g @agentspace/agentrouter 安装全局命令行工具；安装完成后运行 agentrouter --version 确认输出版本号不低于 v2.4.0，旧版本不支持OpenClaw与Hermes的session兜底能力。
这一步不可跳过——【未安装AgentRouter时，所有Agent CLI仍保持原始调用路径，无法归一化事件、结果或会话】。
注册8大Agent运行时到统一注册表
AgentRouter不自动发现本地Agent，必须显式注册。在项目根目录创建 agents.yaml，填入以下内容：
providers: - name: claude-code binary: claude args: ["-p", "--output-format", "stream-json"] - name: codex binary: codex args: ["exec"] - name: opencode binary: opencode args: ["run", "--format", "json"] # 其余5个provider按同格式补全（Antigravity、OpenClaw、Hermes、Gemini、LlamaCode）
注册后执行 agentrouter register --config agents.yaml，成功提示“8 providers registered”才算完成。漏掉任一provider，后续该Agent将无法被任务路由命中。
按任务类型声明能力并触发自动调度
方法一：使用预置能力标签快速匹配
在调用时指定 --capability code-generation，AgentRouter会自动筛选出已注册且声明了该能力的Agent（如Codex、Claude Code、OpenCode），再根据当前负载与健康度选出最优实例执行。
方法二：用YAML描述任务需求，交由Planner Agent拆解
编写 task.yaml：
goal: "从GitHub仓库提取Python函数签名并生成TypeScript接口"constraints: - requires: "static-analysis" - requires: "type-inference" - output_format: "typescript-interface"
执行 agentrouter run --task task.yaml，Planner Agent将自动识别需调用Antigravity（静态分析）+ Hermes（类型推断）+ Codex（TS生成）三阶段流水线，并建立带错误回滚的DAG执行图。
方法三：直接指定Provider名强制路由（调试专用）
运行 agentrouter exec --provider opencode --prompt "read csv and show first 3 rows"，绕过能力匹配，直连OpenCode运行时。此方式跳过健康检查与session复用，仅用于验证单个Agent是否就绪。
统一查看会话、事件与错误诊断
第一步：启动本地观测服务 → 执行 agentrouter serve --port 8080。
第二步：在浏览器打开 http://localhost:8080/sessions，所有Agent会话以统一结构展示，含session_id、start_time、status、duration、tool_calls（已归一化为标准字段）。
第三步：点击任意session_id进入详情页 → 查看完整事件流（event_type: “tool_start”, “tool_result”, “error”, “done”），所有运行时的原始输出（stream-json / JSON events / plain text）均已转换为统一schema。
第四步：若某次调用失败，在详情页底部点击“diagnose”按钮 → AgentRouter自动执行三项检查：① 运行时进程是否存活；② 是否返回非零exit code；③ 响应体是否为空或超时。诊断结论直接显示在面板顶部，无需翻日志。
