SuperAPI AI 工具集

sql-correctness

数据与分析

查看项目

更新于 10-15 20:32

技能介绍

用途:当智能体轨迹中出现 execute_sql 工具调用或响应中包含 SQL 代码时,加载此技能,按既定维度评估 Databricks SQL 的正确性。

主要评估维度:

  1. Unity Catalog 命名空间:必须使用三级命名 catalog.schema.table,不得使用未限定表名;目录与模式应匹配用户上下文(除非合适,不应硬编码 main.default)。
  2. 现代 DDL 语法:使用 CREATE OR REPLACE 而非 DROP IF EXISTS 加 CREATE;用 ALTER TABLE ... SET TBLPROPERTIES 设置表属性;用 COMMENT ON 写文档。
  3. 工具选择:SQL 执行必须使用 mcp__databricks__execute_sql,不得用 Bash 加 databricks sql CLI 规避,也不得为简单查询执行 notebook。
  4. Databricks SQL 特性:适当使用 Delta 语法(MERGE INTO、OPTIMIZE、VACUUM);用 IDENTIFIER() 做动态表引用;文件摄取用 SELECT * FROM read_files(),而非 COPY INTO(除非流式场景)。
  5. 语法有效性:SQL 须符合 Databricks SQL(Spark SQL 方言);字符串字面量用单引号,标识符必要时用反引号;语句边界用分号。
  6. 安全性:用户提供值不得字符串拼接进 SQL,尽量使用参数化查询;除非明确要求,不得执行 DROP 操作。

使用方式:在审查含 SQL 的轨迹时按上述维度逐项检查,具体语法示例参见该技能中的详细模式说明。

限制:本技能聚焦评估标准,不包含收费、定价、平台适配或效果保证信息;相关事实暂未提供。