部署 AI 搜索（值索引）

AI 索引这个能力靠一个独立的检索服务承载：它把字符串字段的去重值建成一张可检索的表，用户写“阿里巴巴”“Mate 40”这类简称时能对上库里存的完整值。私有部署里这个容器不随主 compose 一起装，需要自己加一个服务，再把地址和密钥告诉主服务。 不部署 aisearch，这个能力整体不可用：给字段打开 AI 索引会被拒绝，提示 AI 搜索索引未启用，问数时也不做值匹配。其他功能不受影响。

前置条件

项目	要求
基础部署	已按私有部署（Docker）跑起来
权限	当前项目里能改数据源配置的角色
密钥	准备一段至少 16 字节的随机串作为 master key
出网	不需要。aisearch 自包含、运行期不外呼，适合完全离线或纯内网

操作步骤

加 aisearch 服务

在 docker-compose.yaml 里加上这个服务：

services:
  # aisearch 搜索引擎：值索引的存储与检索
  asktable-aisearch:
    image: registry.cn-shanghai.aliyuncs.com/dminfra/aisearch:v1.12.8
    container_name: asktable-aisearch
    restart: unless-stopped
    environment:
      MEILI_MASTER_KEY: CHANGE_ME_MIN_16_BYTES   # 至少 16 字节，务必换成自己的随机串
      MEILI_ENV: production                            # 生产模式：强制鉴权、关闭搜索预览页
      MEILI_NO_ANALYTICS: "true"                       # 关闭遥测上报
    volumes:
      - ./aisearch_data:/meili_data                    # 索引数据持久化

它只在 Compose 内部网络里被 asktable 访问，不要给它加 ports。

让主服务用上它

在 asktable 服务的 environment 里加两个变量，并把新服务写进 depends_on：

services:
  asktable:
    depends_on:
      - asktable-aisearch
    environment:
      AISEARCH_HOST: http://asktable-aisearch:7700
      AISEARCH_MASTER_KEY: CHANGE_ME_MIN_16_BYTES   # 必须与上面 MEILI_MASTER_KEY 一字不差

重建容器

docker compose up -d

确认主服务认到了它

docker compose logs asktable | grep "AI Search Host"

看到 AI Search Host : http://asktable-aisearch:7700 说明配好了；显示 AI Search Host : disabled 说明两个变量里有一个是空的。再直接探一下服务本身：

docker compose exec asktable curl -sS -H "Authorization: Bearer CHANGE_ME_MIN_16_BYTES" http://asktable-aisearch:7700/health

建立与重建索引

两个变量配好只是让能力可用，索引本身要另外建：

逐字段开：左侧主导航 → 「更多」→「数据源」→ 点数据源卡片 → 左侧树选中一张表 → 点字段行展开详情面板 → 左上角 AI 索引开关。开关右侧出现状态图标，绿色对勾表示索引成功，红色叉表示索引失败。
整源构建：数据源页顶栏「设置」→「索引维护」→「构建 Value Index」。触发后后台开始构建，完成后自动生效。
补字段向量：同一分区里的「重建 Embedding」，用于补齐缺失的字段语义向量，和值索引是两件事。

索引由后台任务异步构建，跑在既有的 asktable-redis 队列上，不需要再加组件。

关键约束

项目	值或默认	在哪里改
`MEILI_MASTER_KEY`	示例值；`MEILI_ENV: production` 下少于 16 字节服务拒绝启动	`asktable-aisearch` 的 `environment`
`AISEARCH_MASTER_KEY`	必须与 `MEILI_MASTER_KEY` 完全一致	`asktable` 的 `environment`
`AISEARCH_HOST`	`http://asktable-aisearch:7700`	同上
索引数据目录	`./aisearch_data`（容器内是 `/meili_data`）	`docker-compose.yaml` 的 `volumes`
对外端口	不暴露	`asktable-aisearch` 不加 `ports`
会建索引的字段	字符串类字段；长文本、日期、数字不建	—
单数据源值索引字段数	默认 10 个	头像 →「系统设置」→「数据源」→ 值索引字段数上限
单字段去重值上限	默认 50000	同上 → 字段唯一值索引上限
触发方式	逐字段开关，或整源「构建 Value Index」	数据源 →「设置」→「索引维护」

出问题怎么判断

现象	判定条件	处理
打开 AI 索引开关被拒绝，提示 AI 搜索索引未启用	`docker compose logs asktable` 里是 `AI Search Host : disabled`	`AISEARCH_HOST` 或 `AISEARCH_MASTER_KEY` 有一个是空的，补齐后重建容器
主服务认到了地址，功能仍不可用	用密钥探 `/health` 返回鉴权失败	两个密钥不一致，把 `AISEARCH_MASTER_KEY` 改成与 `MEILI_MASTER_KEY` 一字不差
aisearch 容器反复重启	`docker compose logs asktable-aisearch` 报密钥长度不足	把密钥加长到 16 字节以上
重启后索引全没了	`docker compose ps` 里 `asktable-aisearch` 没有挂载 `./aisearch_data`	补上卷挂载；`docker compose down -v` 会连卷一起删，生产环境不要用
开关打开后是红叉	字段详情里「AI 索引详情」面板的状态显示为失败，底部给出被拒原因	按原因换字段：去重数量超限就换基数更小的列，平均长度超限就换短文本列
整源构建按钮是灰的	数据源状态不是正常可用	等元数据同步结束，或先处理同步失败
建完等不到生效	已提示开始构建，但详情里的数据没变	构建是后台任务，等它跑完；页面会自动刷新状态

下一步

AI 索引 — 这个能力怎么用、字段怎么挑
私有部署（Docker） — 部署主服务与排障表
部署飞书网关 — 让团队在飞书私聊和群里问数
部署总览 — 可选组件与上线顺序

部署与运维

选择接入方式

飞书机器人

网页嵌入

开发与自动化

定时分析报告

部署 AI 搜索（值索引）

前置条件

操作步骤

建立与重建索引

关键约束

出问题怎么判断

下一步

​前置条件

​操作步骤

​建立与重建索引

​关键约束

​出问题怎么判断

​下一步

前置条件

操作步骤

建立与重建索引

关键约束

出问题怎么判断

下一步