Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
给字段值建索引，让「阿里巴巴」这类简称命中数据库里存的完整值。
| 项目 | 要求 |
|---|---|
| 权限 | 当前项目里能改配置的角色 |
| 前置 | 数据源状态为正常可用；私有部署需先部署 aisearch，见 部署 AI 搜索 |
| 入口 | 左侧主导航 → 「更多」→ 「数据源」→ 点数据源卡片 → 左侧树选中一张表 |
打开单个字段的索引
看状态图标
| 图标 | 含义 |
|---|---|
| 绿色对勾 | 索引成功 |
| 红色叉 | 索引失败 |
看索引详情
整源重建（可选）
| 项目 | 值或默认 | 在哪里改 |
|---|---|---|
| 会建索引的字段类型 | 字符串类（varchar / string / char）；长文本、日期、数字不建 | — |
| 单数据源值索引字段数 | 默认 10 个；整源构建时按上限截断 | 头像菜单 → 「设置」→ 「数据源」→ 值索引字段数上限 |
| 单字段去重值上限 | 默认 50000；超出时该字段索引失败，原因是去重数量超过限制 | 头像菜单 → 「设置」→ 「数据源」→ 字段唯一值索引上限 |
| 字段平均长度上限 | 196 字节；超出时该字段索引失败，原因是平均长度超过限制 | — |
| 单个值的长度 | 超过 256 字符的值不入索引 | — |
| 数值与日期值 | 不进入索引 | — |
| 整源构建前置 | 数据源状态为正常可用 | 「设置」→ 「索引维护」 |
| 私有部署前置 | 需要配置 AISEARCH_HOST 与 AISEARCH_MASTER_KEY，两个值必须一致 | 部署参数，见 部署 AI 搜索 |
| 企业版 | 未授权时打开开关会被拒绝，提示需要企业版支持 | 联系管理员升级 |
| 现象 | 判定条件 | 处理 |
|---|---|---|
| 开关打开后是红叉 | 打开「AI 索引详情」，状态是失败，底部给出被拒原因 | 原因若是去重数量超限，换一个基数更小的字段；若是平均长度超限，换短文本字段 |
| 打开开关立刻报错 | 提示需要企业版支持 | 升级企业版 |
| 打开开关没成功 | 私有部署未部署 aisearch | 按 部署 AI 搜索 配好两个环境变量后重启 |
| 「构建 Value Index」按钮是灰的 | 数据源状态不是正常可用 | 等元数据同步结束，或先处理同步失败 |
| 索引值数量是 0 | 详情弹窗里索引值数量显示 0 | 该列没有可索引的值（全是数字、日期或超长文本），换字段 |
| 用简称提问还是匹配不到 | 目标字段的 AI 索引开关是关闭状态 | 打开该字段的开关；若字段数已到上限，先关掉不用的字段 |
| 建完等不到生效 | 提示已开始构建，但详情里数据没变 | 构建是后台任务，等它跑完；页面会自动刷新状态 |
