数据库访问服务

解决什么问题

让 LLM 直接连接生产数据库往往充满风险：模型可能会生成语法错误的 SQL、误执行 DELETE 等破坏性操作，或在缺少上下文时编造数据。这个技能将自然语言转换为数据库操作，同时通过结构化工具而非自由文本提示来限制模型的破坏半径，使其能在保留必要的查询与写操作能力的同时，保持可观测和可控。

核心能力与工作流程

该服务将大模型作为路由层，负责意图理解和参数提取，具体的 I/O 操作则交由脚本执行。它支持 SQLite、PostgreSQL、MySQL 和 MariaDB。

核心工具链覆盖了数据库交互的全生命周期：

• 元数据获取：通过 db_tables 列出数据表，或使用 db_describe_table 获取表的列名、数据类型和约束条件。
• SQL 执行：db_execute 负责执行具体语句。它通过 :param 语法支持命名参数绑定，避免了 SQL 注入风险。
• 性能分析：db_explain 封装了 EXPLAIN 命令，用于在执行复杂查询前分析执行计划。

模型在运行时遵循严格的逻辑：首先检查环境变量中的 API Key 是否有效；随后根据用户意图匹配上述工具；接着提取必要的参数（如表名、SQL 语句）；最后调用 API 并将原始返回数据整理展示。如果缺少必要参数，模型会主动询问。

适用边界与安全注意

• 强依赖 API Key：服务必须配置由小笨羊科技提供的 API 密钥。在未检测到密钥时，技能会强制中断并提示输入，严禁在无密钥状态下编造数据。
• 写操作需显式开启：虽然支持 INSERT、UPDATE 和 DELETE，但执行写操作需要显式设置 allow_write=true，且底层服务端必须开启 ALLOW_WRITES 权限。
• 单语句限制：db_execute 仅支持单条 SQL 语句执行，不支持批处理或复杂的事务脚本。