四件工具：列出、描述、抽样、执行

观远把问数工具收成四类，覆盖发现-理解-验证-执行：

| 工具 | 作用 | 落地要点 | | 列出表 | 发现有哪些资产 | 先知道「有哪些房间」 | | 描述结构 | 字段、类型、约束 | Join 键和口径验证 | | 抽样行 | 看形态和枚举值 | 限行、脱敏 | | 执行 SQL | 拿结果或错误 | 只读、限时、限行 |

这和交互式 Text-to-SQL 论文里的「主动检索工具」是同一类设计：不要把整库一次性塞进上下文。BIRD 的错误分析里，ChatGPT 一类基线大约 41.6% 错在结构链接，40.8% 错在误解库内容（包括臆造表名）。抽样和描述就是为了把「臆造」挡住。

软件实现时，四件工具要带理由字段（为什么调它），方便复盘。抽样默认去掉手机号、证件、邮箱。执行默认拒绝非 SELECT。列出表可以按权限过滤，不要把看不到的表名泄漏给对话。

出处

• 观远数据，四件工具表
• BIRD 论文错误分析：结构链接 41.6%，误解库内容 40.8%
• JimXiongGM/Interactive-Text-to-SQL，多轮工具调用