Builtin 内置工具
进程内确定性能力:错误归类、本地再解析、美化与 diff。不访问外部服务,也不执行业务 SQL。
为什么需要 Builtin
- 给 Agent 一个稳定、可复现的「收口」能力:修正 SQL 必须能通过本地 Parser。
- 错误归类先做规则映射,减少纯模型猜测,便于选择后续 Skill / MCP。
- format / diff 方便前端展示「改了什么」,不依赖模型自己排版。
工具清单(输入 → 输出)
| 工具名 | 作用 | 输入 | 输出 |
|---|---|---|---|
classify_db_error |
错误码/消息映射到错误类别 | status, code, message | category, hints |
validate_sql_syntax |
Druid SQL Parser 本地再解析 | sql, dialect | ok / parseError |
format_sql |
SQL 美化,便于对照阅读 | sql | formattedSql |
diff_sql |
原 SQL 与修正 SQL 差异 | originalSql, fixedSql | diff hunks |
硬约束:Builtin 不执行业务 SQL;
validate_sql_syntax 仅做本地解析,与执行门禁中的 Parser 同源,保证「Agent 认为可解析」与「再次提交可过解析」一致。