你的dbt描述才是AI Agent真正的提示词

📋总体概括

一位工程师为让AI Agent查询公司数据搭建了MCP服务器，却发现真正的难点不在服务端，而在于Agent频繁选错表。他复盘后发现根因是dbt文档质量：Agent检索时只能看到描述首行和列描述前两句，模型一多人工维护不过来，让AI自动生成YAML反而埋雷。文章给出实操建议：把表的粒度、用途和NULL的特殊含义写进第一句，禁止AI从模型反推文档，把dbt描述当作Agent的真正提示词来治理。