Skip to content

SQL AI Agent 节点#

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

请参考 AI Agent 获取有关 AI Agent 节点本身的更多信息。

节点参数#

使用以下参数配置 SQL Agent。

Data Source 数据源#

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

  • MySQL:选择此选项使用 MySQL 数据库。
    • 还要选择 Credential for 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 和 MySQL Agents

如果您使用 PostgresMySQL,此代理不支持凭据隧道选项。

Prompt 提示#

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

选择:

  • 自动从前一个节点获取:如果您选择此选项,节点期望从名为 chatInput 的前一个节点获取输入。
  • 在下方定义:如果您选择此选项,在提示(用户消息)字段中提供静态文本或动态内容的表达式作为提示。

节点选项#

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

Ignored Tables 忽略的表#

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

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

Include Sample Rows 包含示例行#

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

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

Included Tables 包含的表#

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

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

Prefix Prompt 前缀提示#

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

n8n 用示例填充此字段。

Suffix Prompt 后缀提示#

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

可用的 LangChain 表达式:

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

n8n 用示例填充此字段。

Limit 限制#

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

默认值为 10

模板和示例#

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

常见问题#

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

AI 术语表#

  • completion(完成/补全): 完成是由 GPT 等模型生成的响应。
  • hallucinations(幻觉): AI 中的幻觉是指大语言模型(LLM)错误地感知到不存在的模式或对象。
  • vector database(向量数据库): 向量数据库存储信息的数学表示。与嵌入和检索器一起使用,创建 AI 在回答问题时可以访问的数据库。
  • vector store(向量存储): 向量存储或向量数据库,存储信息的数学表示。与嵌入和检索器一起使用,创建 AI 在回答问题时可以访问的数据库。