SQL AI Agent 节点#
功能已移除 n8n 已于 2025 年 2 月移除了此功能。 SQL Agent 使用 SQL 数据库作为数据源。它能够理解自然语言提出的问题,将其转换为 SQL 查询,执行查询,并以用户友好的格式呈现结果。该 Agent 在构建数据库的自然语言接口方面非常有价值。 有关 AI Agent 节点本身的更多信息,请参阅 AI Agent。
节点参数#
使用以下参数配置 SQL Agent。
数据源(Data Source)#
选择用作节点数据源的数据库。选项包括:
- MySQL :选择此项以使用 MySQL 数据库。
- 同时选择 MySQL 凭据(Credential for MySQL)。
- SQLite :选择此项以使用 SQLite 数据库。
- 必须在 Agent 节点之前添加一个 从磁盘读写文件(Read/Write File From Disk) 节点,用于读取你的 SQLite 文件。
- 同时输入来自“从磁盘读写文件”节点的 SQLite 文件的 输入二进制字段(Input Binary Field) 名称。
- Postgres :选择此项以使用 Postgres 数据库。
- 同时选择 Postgres 凭据(Credential for Postgres)。
Postgres 和 MySQL Agent 如果你正在使用 Postgres 或 MySQL,该 Agent 不支持凭据隧道(credential tunnel)选项。
提示词(Prompt)#
选择节点构造提示词(也称为用户的查询或聊天输入)的方式。 可选选项包括:
- 自动从上一节点获取 :如果选择此项,节点将期望从前一个节点接收名为
chatInput的输入。 - 在下方定义 :如果选择此项,请在 提示词(用户消息)(Prompt (User Message)) 字段中提供静态文本或表达式,以作为动态内容的提示词。
节点选项#
使用以下选项来调整 SQL Agent 节点的行为:
忽略的表(Ignored Tables)#
如果您希望节点忽略数据库中的某些表,请输入一个以逗号分隔的、需要忽略的表名列表。 如果留空,则代理不会忽略任何表。
包含示例行(Include Sample Rows)#
输入要包含在发送给代理的提示(prompt)中的示例行数量。默认值为 3。
示例行有助于代理理解数据库的结构,但也会增加所使用的 token 数量。
包含的表(Included Tables)#
如果您只想包含数据库中的特定表,请输入一个以逗号分隔的、需要包含的表名列表。 如果留空,则代理会包含所有表。
前缀提示(Prefix Prompt)#
在此处输入一段消息,该消息将在 提示(Prompt) 内容之前发送给代理。此初始消息可以为代理提供更多上下文和指导,说明它可以做什么、不可以做什么,以及如何格式化响应。 n8n 会在此字段中预填一个示例。
后缀提示(Suffix Prompt)#
在此处输入一段消息,该消息将在 提示(Prompt) 内容之后发送给代理。
可用的 LangChain 表达式:
{chatHistory}:本次对话的消息历史,用于保持上下文。{input}:包含用户的提示内容。{agent_scratchpad}:用于在下一次迭代中保留的信息。
n8n 会在此字段中填充一个示例。
限制
输入返回结果的最大数量。
默认值为 10。
模板与示例
请参考主 AI Agent 节点的 模板与示例 部分。
常见问题
关于常见问题及建议解决方案,请参阅 常见问题(Common issues)。
聊天查看文档 本页面是否对你有帮助?!赞有帮助 !踩没有帮助 感谢你的反馈! 提交 上一页 ReAct Agent 下一页 Tools Agent 由 Material for MkDocs Insiders 提供支持