首页 / 操作手册 / 数据源管理

数据源管理

最后更新时间：2026年10月1日

数据源管理用于接入企业外部的业务数据库，让自主规划智能体能够以受控、可审计、可限额的方式查询业务数据。 智能体在运行时通过「数据库查询」与「数据库元数据」两项内置能力，按需读取被授权的表与列，从而回答需要实时数据的业务问题。

与知识管理的区别 数据源管理接入的是数据库连接，用于实时查询结构化数据，与知识库相互独立、没有绑定关系。知识库的文档来源（文件上传、网页抓取等）请在「知识管理」中配置。二者可以服务于同一个智能体：知识库提供静态的企业知识，数据源提供实时的业务数据。

支持的数据库类型

当前版本（V1）仅支持 MySQL（8.0 及以上）数据源。数据库类型下拉中的 PostgreSQL、ClickHouse 等为后续版本预留，暂不可选择。

数据源列表

进入平台左侧导航的「数据源管理」菜单，即可看到数据源列表。列表以卡片形式展示：

信息 说明
数据源名称 数据源的自定义名称，同一账号下不可重名。
连接串 以「主机:端口/数据库名」形式展示，便于快速识别连接目标。
数据库类型 / 可见性 数据库类型标签与可见范围标签。
启用状态 通过开关控制数据源是否可用于智能体查询。
创建人 / 创建时间 数据源的创建账号与创建时间。

页面顶部支持按名称搜索，并按是否启用、数据库类型、可见性筛选。卡片操作菜单提供：

  • 查看结构：查看已抓取的库表结构。
  • 结构刷新：重新抓取数据库当前的库表结构。
  • 共享：授权给指定用户或部门，详见 共享授权。
  • 编辑：修改连接信息与访问策略。
  • 删除：删除数据源（需先停用，且仅创建者可删除）。

卡片底部还提供「测试连接」入口与启用/停用开关。

新增数据源

点击「新增数据源」，按三步向导完成配置。

第一步：连接信息

字段 是否必填 说明
数据源名称 必填 便于识别的名称，同一账号下唯一，例如「订单库-只读」。
数据库类型 必填 当前仅可选择 MySQL。
Host 必填 数据库主机地址或域名。
Port 必填 数据库端口，MySQL 默认 3306。
数据库名 必填 要查询的数据库（schema）名称。
用户名 必填 建议使用仅有只读权限的数据库账号。
密码 新建必填 数据库账号密码。编辑时留空表示不修改原密码。
来源类型 否 标识数据源来源，默认为「手动新建」，仅作区分用途。
备注 否 补充说明信息。

密码会被加密存储，列表与详情均不会返回明文密码。在编辑或测试连接时，密码以掩码形式展示。

第二步：可见性与共享

设置数据源的可见范围：

  • 私有：仅创建者及被授权者可用。
  • 共享授权：授权给指定用户或部门使用。本版本默认启用共享授权。
  • 公开：本版本暂不支持对数据源设置为公开。

选择「共享授权」后，可在同一页面直接添加授权对象（用户或部门）。

第三步：访问策略与限制

访问策略用于约束智能体可以通过该数据源访问哪些数据、以及查询的规模上限，是数据源安全使用的核心配置。

表 / 列权限（允许访问的对象）：

  • 可点击「拉取表结构」读取该数据库的表清单，再逐张添加需要开放的表。
  • 每张表需指定允许访问的列，并可单独设置样本行数限制。
  • 留空表示允许访问所有表（不推荐）；每张表至少需要选择一列，未选择列的表将被视为不可访问。

执行限额：限制单次查询与整体资源消耗，常见配置项包括：

配置项 说明
单次查询最大行数 单条查询最多返回的行数，默认 200。
最大返回行数 / 最大偏移量 控制累计返回规模与分页偏移上限，避免大范围扫描。
单元格最大字节数 单个字段值的最大长度，超出部分会被截断。
查询超时时间 单条查询的最长执行时间，默认 10 秒。
单数据源最大并发 同一数据源允许的并发查询数，默认 5。
允许大对象 是否允许返回大字段（如长文本、二进制），默认关闭。

结果交付策略：控制查询结果如何回传给智能体与对话，例如是否允许生成结果快照、是否在流式输出中展示原始表结构、以及每条消息最大快照行数等。

安全提示 请遵循最小权限原则：仅为确实需要的表开放必要的列，避免使用「允许所有表」，并使用数据库只读账号接入。数据源中的访问策略与限额配置将直接决定智能体可访问的数据边界。
创建后默认停用 出于安全考虑，新建数据源保存后默认为「停用」状态，需在列表中手动启用后，才可被智能体绑定与查询。

测试连接与结构刷新

测试连接

点击「测试连接」，平台会分项验证并给出结果，包括：网络连通、TLS、元数据读取、超时设置与只读校验。全部通过后，说明该数据源可用于后续查询。

结构刷新

当数据库的表结构发生变化（新增表、修改列等）时，使用「结构刷新」重新抓取元数据。刷新成功后，结构版本号会更新，且智能体在后续查询中使用最新的表结构信息。

绑定到自主规划智能体

完成数据源配置并启用后，在「自主规划」智能体的编辑页面中绑定数据源：

  1. 进入智能体的「数据源绑定」区域，选择要绑定的数据源。
  2. 为该绑定设置别名（alias）。别名是智能体在调用时会用到的名称，建议使用简洁、语义清晰的英文或拼音。
  3. 可选：为该绑定进一步收窄可访问的表/列范围。留空表示沿用数据源本身的策略范围；设置为空数组则表示该绑定不可访问任何表。
  4. 保存智能体。

绑定生效后，智能体在规划任务时即可调用「数据库查询」与「数据库元数据」能力：前者执行只读查询，后者用于查看可用的表与列。

安全机制

为保障业务数据安全，数据源查询在运行时有以下约束：

  • 只读执行：查询会话强制以只读事务运行，仅允许查询类 SQL。
  • SQL 白名单：仅允许单条查询语句，禁止增删改（DML）与结构变更（DDL）、禁止 SELECT *、禁止跨库访问；并对查询复杂度（嵌套、连接、子查询数量等）设有限制。
  • 限额与超时：查询行数、偏移量、执行时间、并发数等均受策略限制，超限将被拒绝。
  • 审计与熔断：查询过程会被记录审计状态；当短时间内失败过多时，数据源会自动停用（熔断），需人工排查后重新启用。
  • 网络防护：连接地址经过安全校验，避免访问危险的内部网段。
  • 凭据加密：数据库密码加密存储，接口不回传明文。

此外，数据源查询功能整体受平台全局开关控制，默认关闭，需由管理员开启后方可使用。

权限说明

  • 查看、使用数据源需要具备对应的使用权限（私有资源仅创建者与被授权者可用）。
  • 编辑连接信息、访问策略与启用/停用需要具备该数据源的管理权限。
  • 删除数据源仅创建者可执行，且必须先停用；若数据源仍被智能体绑定，请先解绑。

相关章节