N8N中文教程
集成节点/Built in_nodes/Cluster_nodes/Root_nodes/AI_Agent

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 提供支持