跳到主要内容

SQL AI Agent（SQL AI 智能体） 节点

注意

功能可用性

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 破坏性变更。

SQL Agent 以 SQL 数据库为数据源，可理解自然语言问题，将其转换为 SQL 查询、执行查询，再以易读的格式呈现结果，适合构建数据库的自然语言接口。

AI Agent 节点本身的更多信息，请参阅 AI Agent。

节点参数 ​

使用以下参数配置 SQL Agent。

Data Source（数据源） ​

选择节点使用的数据库数据源，可选：

  • MySQL：使用 MySQL 数据库。
    • 还需选择 Credential for MySQL（MySQL 凭据）。
  • SQLite：使用 SQLite 数据库。
    • 必须在 Agent 前添加 Read/Write File From Disk 节点，读取 SQLite 文件。
    • 还需输入 Read/Write File From Disk 节点传入 SQLite 文件的 Input Binary Field（输入二进制字段）名称。
  • Postgres：使用 Postgres 数据库。
    • 还需选择 Credential for Postgres（Postgres 凭据）。
注意

Postgres 和 MySQL 智能体

使用 Postgres 或 MySQL 时，此智能体不支持凭据的隧道选项。

Prompt（提示词） ​

选择节点构建提示词的方式，提示词也称为用户查询或聊天输入。

可选择：

  • Take from previous node automatically（自动取自上一个节点）：选择后，节点期望从上一个节点接收名为 chatInput 的输入。
  • Define below（在下方定义）：选择后，在 Prompt (User Message)（提示词，用户消息）字段中提供静态文本或用于动态内容的表达式，作为提示词。

节点选项 ​

使用以下选项调整 SQL Agent 节点的行为：

Ignored Tables（忽略的表） ​

希望节点忽略数据库中的某些表时，输入以逗号分隔的表名称列表。

留空时，智能体不忽略任何表。

Include Sample Rows（包含示例行） ​

输入发送给智能体的提示词中包含的示例行数，默认为 3。

示例行有助于智能体理解数据库架构，但也会增加 token 用量。

Included Tables（包含的表） ​

希望仅包含数据库中的指定表时，输入以逗号分隔的表名称列表。

留空时，智能体包含所有表。

Prefix Prompt（前缀提示词） ​

输入放在 Prompt（提示词）文本之前发送给智能体的消息，可为智能体提供更多上下文和指引，说明允许和不允许的操作，以及响应的格式。

n8n 会在此字段中填入示例。

Suffix Prompt（后缀提示词） ​

输入放在 Prompt（提示词）文本之后发送给智能体的消息。

可用的 LangChain 表达式：

  • {chatHistory}：本次对话的消息历史，用于保持上下文。
  • {input}：包含用户提示词。
  • {agent_scratchpad}：需要为下一次迭代记住的信息。

n8n 会在此字段中填入示例。

Limit（上限） ​

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

默认为 10。

Tracing Metadata（追踪元数据） ​

为此智能体的追踪事件添加自定义键值元数据，便于在 LangSmith 等追踪工具中筛选和调试运行。

键或值为空的条目会被忽略。

模板与示例 ​

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

常见问题 ​

常见问题及建议的解决办法，请参阅常见问题。

本文为社区中文翻译。查看对应英文原文