首先完成“ foundations: AI代理如何感知、计划和行动”即可解锁本课程。转到上一课

介绍

当 AI 代理在用户代表下能够直接与关系数据库交互时,其用途会大大增加——例如回答“上一季度热销产品有哪些?”或“更新这个客户的送货地址”,无需人工手写 SQL。挑战在于在给予代理强大数据库能力的同时,避免其执行破坏性或不安全的查询。本课将介绍实际构建块:让代理读取你的模式、生成 SQL、验证 SQL,然后再对真实数据库执行。

授予代理对模式的感知能力

如果代理不知道有哪些表和列,便无法写出正确的 SQL。常用做法是在系统提示中或检索上下文块中提供对数据库模式的简要描述。对于 PostgreSQL 数据库,可以使用 information_schema 转储表和列,然后在传递给模型前对输出进行裁剪。

sql
SELECT table_name, column_name, data_type
FROM information_schema.columns
WHERE table_schema = 'public'
ORDER BY table_name, ordinal_position;

返回的行数将变为代理可在构建查询时引用的文本摘要。没有这一步,模型将产生幻象式的列名并屡次出错。

流程图:代理接收用户问题、从数据库元数据中检索模式上下文、生成 SQL 候选、验证 SQL、然后执行或拒绝

生成和验证 SQL

一旦代理具备模式上下文,你就要求它在用户请求下生成单一 SQL 语句。将输出包裹在解析器中,以便在执行前进行检查。一个健壮的流水线按顺序完成三件事:(1) 拒绝任何非单语句的输出,(2) 拒绝任何首个动词在禁止列表中的语句(DROP、TRUNCATE、DELETE 加 WHERE、UPDATE 加 WHERE、GRANT 等),(3) 根据意图使用只读或参数受限的连接来执行语句。

python
import sqlparse
FORBIDDEN = {"drop", "truncate", "grant", "revoke"}
def safe_sql(raw: str) -> str:
parsed = sqlparse.parse(raw)
if len(parsed) != 1:
raise ValueError("Must be exactly one statement")
stmt = parsed[0]
first_token = stmt.get_type().lower()
head = stmt.token_first(skip_cm=True).value.lower()
if head in FORBIDDEN:
raise ValueError(f"Forbidden verb: {head}")
return str(stmt)

这个验证层在 SQL 触碰数据库之前就运行。它是整条流水线中最重要的防护措施。

在受限连接下执行

即使经过验证,纵深防御仍然重要。以权限已受限制的用户连接到数据库:分析问题用只读角色,应用只需要的特定INSERT/UPDATE权限使用单独的角色。将会话级设置一个较短的语句超时,这样 runaway 查询就不能把表锁定数分钟。

sql
SET statement_timeout = '3s';
SET idle_in_transaction_session_timeout = '5s';

将这些超时设置与在生成的 SELECT 语句中附加的行数限制配对(例如,始终添加 LIMIT 100,除非用户明确选择退出),以便代理不能把百万行的表拉进内存并造成停滞。

对比两种数据库连接角色的框图——一个是只读分析角色,一个是有作用域的写入角色——显示每个角色被允许执行的 SQL 语句。

常见的陷阱

最常见的失败是让代理在聊天中回显原始 SQL 而从不执行它——用户随后自行复制并运行,导致审计轨迹丢失。另一种是信任模型在同一提示中“决定查询是否安全”;自我监管并不可靠,因此始终在代码中强制验证。最后,避免一次性传递庞大数据库的完整架构信息:模型会把对其根本不需要的表消耗在上下文中,因此按请求筛选相关表或使用嵌入检索仅匹配的表。

摘要

将代理连接到 SQL 是一个分层的问题。首先暴露模式元数据,以便模型能够编写真实的 SQL,然后在执行前在代码中生成、解析并验证每条语句。用基于角色的权限和连接级超时来支撑验证程序,这样一次错误或恶意提示都永远不会让表被清空。通过这四个层次——模式上下文、代码级验证、受限角色和超时——代理就能回答数据问题并执行安全写操作,而不会让数据库处于风险之中。

课后练习

课程检查点

巩固所学知识,获取作业反馈。

0/8
01为什么将模式元数据提供给代理是准确的 SQL 生成的前提?
02不论上下文如何,验证层应明确拒绝哪一个 SQL 动词?
03在 safe_sql Python 函数中,检查 len(parsed) != 1 的目的是什么?
04为什么在会话级别应用 statement_timeout 而不仅仅在代码中验证 SQL?
05当你把大型数据库的完整模式传入代理的提示中会出现什么问题?
06为什么让代理在提示中“自我监督”其 SQL 被认为不可靠?
07在这种设置中只读数据库用户的角色是什么?
08哪种顺序最能描述由代理驱动的SQL的分层防御?
已回答 · 0/8