n8n 中文文档

SQL AI 代理节点

警告

Feature availability 功能可用性

SQL Agent 已自 n8n 1.82.0 起弃用。新增或更新的 AI Agent 节点会改用 Tools Agent。只有仍在使用 AI Agent 节点版本 1 的工作流才能选择 SQL Agent。

AI Agent 节点版本 1 会在 n8n 3.0 中移除,因此所有工作流中的 SQL Agent 都将停止工作。详情请参阅 n8n 3.0 breaking changes。

SQL Agent 使用 SQL 数据库作为数据源。它可以理解自然语言问题,将其转换为 SQL 查询,执行查询,并以用户友好的格式呈现结果。此代理对于构建数据库的自然语言界面很有价值。

有关 AI Agent 节点本身的更多信息,请参阅 AI Agent。

节点参数

使用以下参数配置 SQL Agent。

数据源

选择要用作节点数据源的数据库。选项包括:

  • MySQL:选择此选项以使用 MySQL 数据库。
    • 同时选择 Credential for MySQL MySQL 的凭据。
  • SQLite:选择此选项可使用 SQLite 数据库。
    • 您必须在 Agent 之前添加一个 Read/Write File From Disk 节点才能读取您的 SQLite 文件。
    • 还要输入来自“从磁盘读取/写入文件”节点的 SQLite 文件的 Input Binary Field 输入二进制字段 名称。
  • Postgres:选择此选项可使用 Postgres 数据库。
    • 同时选择 Credential for Postgres Postgres 的凭证。

警告

Postgres and MySQL Agents Postgres 和 MySQL 代理

如果您使用 Postgres 或 MySQL,则此代理不支持凭证隧道选项。

提示

选择您希望节点如何构造提示(也称为用户的查询或聊天输入)。

选择:

  • Take from previous node automatically 自动从前一个节点获取:如果选择此选项,节点将期望来自名为 chatInput 的前一个节点的输入。
  • Define below 定义如下:如果选择此选项,请提供静态文本或动态内容表达式,以用作 Prompt (User Message) 提示(用户消息) 字段中的提示。

节点选项

使用这些选项来调整 SQL Agent 节点的行为:

忽略表

如果您希望节点忽略数据库中的任何表,请输入您希望它忽略的表的逗号分隔列表。

如果留空,代理不会忽略任何表。

包括示例行

输入要在提示中包含给代理的示例行数。默认值为 3。

示例行帮助代理理解数据库的模式,但它们也会增加使用的令牌数量。

包含的表

如果您只想包含数据库中的特定表,请输入要包含的表的逗号分隔列表。

如果留空,代理会包含所有表。

前缀提示

输入您希望在 Prompt 文本之前发送给代理的消息。此初始消息可以为代理提供更多关于它能做什么和不能做什么以及如何格式化响应的上下文和指导。

n8n 用示例填充此字段。

后缀提示

输入您希望在 Prompt 文本之后发送给代理的消息。

可用的 LangChain 表达式:

  • {chatHistory}:此对话中的消息历史记录,对维护上下文有用。
  • {input}:包含用户提示。
  • {agent_scratchpad}:要为下一次迭代记住的信息。

n8n 用示例填充此字段。

限制

输入要返回的最大结果数。

默认值为 10。

跟踪元数据

为此 agent 的 tracing event 添加自定义键值 metadata。这有助于在 LangSmith 等 tracing 工具中过滤和调试运行。

key 或 value 为空的条目会被忽略。

模板和示例

请参阅主 AI Agent 节点的 模板和示例 部分。

常见问题

有关常见问题和建议的解决方案,请参阅常见问题。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。