数据库调用指南 ​

前言 ​

你已经成功地创建并配置了数据库，现在是时候让你的应用真正地使用这些数据了。平台提供了两种核心的数据库调用方式，以适应不同的应用场景：

1. 在智能助手中调用：通过自然语言与数据库进行交互，实现智能问答和数据探索。
2. 在工作流中调用：通过精确的SQL语句执行查询，实现自动化流程中的数据提取。

本指南将分别详细介绍这两种调用方式的配置和使用方法。

一、在智能助手中调用 ​

此方式将数据库作为一个“可查询的数据源”接入Agent，让大模型能够理解用户的自然语言提问，并自动查询数据库来寻找答案。

适用场景 ​

• 构建一个能够回答业务数据的智能客服，例如“帮我查一下A客户上个月的订单”。
• 终端用户不具备SQL编写能力，需要一个更友好的交互方式。

操作步骤 ​

1. 在Agent的构建界面中，从可用的组件列表中找到并点击 “数据库” 组件。
2. 界面会弹出一个窗口，展示你所有已创建的数据库及其包含的数据表。
3. 选择一个数据库：首先，你需要选择一个你希望接入的数据库。请注意，一个Agent组件仅支持添加1个数据库。
4. 选择数据表：你可以根据需求，勾选一张或多张数据表。Agent将会在你勾选的这些表范围内进行查询。
5. 点击 “添加” 按钮，数据库组件便成功添加到了你的Agent中。

现在，你的智能助手已经具备了与数据库对话的能力。你可以在调试窗口中，直接用自然语言向它提问，检验查询效果。

二、在工作流中调用 ​

此方式通过一个专门的“SQL自定义节点”来执行数据库操作，适用于需要精确、稳定地获取结构化数据的自动化流程。

适用场景 ​

• 在自动化流程中，需要从数据库中提取特定数据，传递给下游节点。
• 需要执行固定或模板化的SQL查询，确保结果的稳定性和可预测性。
• 对数据查询的精确性要求较高。

操作步骤 ​

1. 在工作流的画布中，从节点列表中点击或拖拽添加一个 “SQL自定义节点”。
2. 点击该节点，进入其配置界面。首先，点击 “数据库添加” 按钮。
3. 在弹出的窗口中，你会看到所有数据库和数据表的列表。请选择一张具体的数据表。请注意，SQL自定义节点每次仅能针对一张表进行操作。
4. 在 “SQL查询语句” 输入框中，编写你的SQL代码。这里支持两种模式：
   • 固定查询：输入一条完整的SQL语句(暂不支持select *），例如 SELECT user_id FROM Users WHERE username = 'alice'。
   • 动态查询：通过 {变量名} 的方式，插入来自工作流上游节点的动态变量。例如，如果上游节点输出了一个名为 user_id 的变量，你可以这样编写SQL：SELECT user_id FROM Users WHERE username = '{user_id}'。
5. 配置完成后，该节点的输出将会是你SQL语句执行后返回的文本结果（string格式），你可以将这个输出连接到工作流的下一个节点继续使用。