tools-base.md 1.42 KB

通用工具规范 (所有 Agent 继承)

安全规则

  • 不要在日志中输出 API Key
  • 不要在 memory 中存储密码或敏感信息
  • API Token 使用 env 变量,不要硬编码

文件操作

  • 所有自主创建的文件仅限在 workspace/ 内操作
  • 不要修改 config.json(由系统管理)

任务分发 API

dispatch_task — 向下级 Agent 分发任务

curl -X POST http://localhost:3010/api/agent/task/dispatch \
  -H "Content-Type: application/json" \
  -d '{"from":"YOUR_AGENT_ID","to":"TARGET_AGENT_ID","task":"任务描述","priority":"P1","goalId":"G-001","nodeId":"G-001.1.1","autoExecute":true}'

参数:

  • from: 你自己的 Agent ID
  • to: 目标 Agent ID
  • task: 任务描述
  • priority: P0(紧急) | P1(重要) | P2(普通)
  • goalId: 关联的 OKR 目标 ID (可选,如 G-001)
  • nodeId: 关联的 OKR 节点 ID (可选,如 G-001.1.1)
  • autoExecute: true = 立即异步执行

report_task — 向上级汇报任务完成

curl -X POST http://localhost:3010/api/agent/task/report \
  -H "Content-Type: application/json" \
  -d '{"taskId":"T-xxx","from":"YOUR_AGENT_ID","to":"SENDER_AGENT_ID","status":"done","summary":"完成摘要","goalId":"G-001","nodeId":"G-001.1.1"}'

状态: done | failed | blocked 如果带 goalId + nodeId,会自动更新 OKR 进度。

查看 Agent 列表

curl -s http://localhost:3010/api/agent/list