工具调用（Tool-Use）· 函数调用与编排

让 agent 从"只会说"变成"能做事"：把意图变成可执行的 tool_call，并按 schema 安全调度真实工具。这是 agent 行动力的核心一环，也是元进化循环能从"规划"落到"执行"的关键。

适用场景

• 给大模型/agent 设计可用的工具清单（function schema）
• 把用户一句话意图解析成 {name, arguments} 并分发执行
• 在 agent 编排中管理多个工具的注册、校验、调用
• 把已有脚本/命令封装成可被 agent 调用的工具

标准工作流

1) 生成工具 schema

python scripts/schema.py --spec tool_spec.json --out schema.json

tool_spec.json 示例：

{"name":"get_weather","description":"查询城市天气","parameters":[
  {"name":"city","type":"string","required":true,"description":"城市名"}]}

输出 OpenAI 风格：{"type":"function","function":{"name":...,"parameters":{"type":"object","properties":{...},"required":[...]}}}

2) 注册并调度工具

python scripts/dispatch.py --registry reg.json --call '{"name":"echo","arguments":{"text":"hi"}}' --out result.json

reg.json：{"echo":{"type":"command","cmd":"echo {text}"}}（也支持 type:python 调用已注册函数）

安全边界

• 只执行注册表中显式声明的工具，拒绝任意代码执行
• 参数先按 schema 校验（类型/必填）再执行，避免注入
• command 类型工具默认禁用 shell 通配/重定向等非必要能力；危险命令需人工确认

自进化学习系统

python scripts/learner.py record . --capability "工具调用" [--fail --error <类型> --note <说明>]
python scripts/learner.py insight .
python scripts/learner.py reflect .

• 某类工具的 schema 常被模型填错参数 → 记录，reflect 建议收紧参数描述/枚举
• 高频工具 → prefer 记录，未来默认预注册