VeapAI 实战（三）知识主题与召回参数

最新推荐文章于 2026-08-28 16:15:34 发布

原创最新推荐文章于 2026-08-28 16:15:34 发布 · 204 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

人工智能

摘要：本文是 VeapAI 企业 AI 知识库实战系列的第三篇，聚焦知识主题与召回参数。文章先厘清知识主题在链路中的三重职责（组织层级、绑定字段标准、承接问答召回参数），再拆解两张核心表的设计要点，随后演示页面操作流程，并走读前后端源码入口。最后指出「参数外置」这一最值得借鉴的设计思路，以及 enabled 字段类型等容易抄错的细节，并给出可复现的两级主题与召回参数配置步骤。

# 从零打通企业 AI 知识库全链路：VeapAI 实战（三）知识主题与召回参数

> 关键词：开源知识库、知识主题、RAG 召回参数 | 首发：CSDN | 同步：知乎 / 掘金

![本系列 8 步流程总览（当前：③ 创建知识主题）]

## 主题这层，到底管什么

知识主题在链路里是个"分类器"，但只做分类就浅了。VeapAI 里主题同时干了三件事：组织层级（父子主题）、绑定字段标准（standard_code）、承接问答的召回参数（通过配置表）。第三件最容易被低估，放最后说。

## 表设计

`ai_knowledge_topic` 关键字段：

| 字段 | 说明 |

| ---- | ---- |

| `parent_id` | 上级主题，默认 0。预算评审项目 → 类别清单 → 费用明细项就是多级主题的用法 |

| `code` / `title` | 主题编码和标题 |

| `standard_code` | 绑定的元数据标准编码 |

| `status` / `approval_status` / `open_status` | 状态、审核状态、开放状态三件套 |

注意 `standard_code` 是编码不是主键。标准本身有版本概念，主题绑定编码比绑定 ID 稳，标准的版本演进不影响主题这一侧的引用语义。

主题和知识点是一对多（`ai_knowledge_entry.topic_id`），知识点留到第 5 篇讲。

第二张表是 `ai_app_topic_knowledge_config`，应用主题和知识主题之间的桥：

| 字段 | 说明 |

| ---- | ---- |

| `app_topic_id` / `knowledge_topic_id` | 两侧主键 |

| `query_limit` | 该知识主题最大召回条数，必须正整数 |

| `min_score` | 最低匹配度阈值，decimal(10,4)，建议范围 0.0000–1.0000 |

| `prepend_title` | 命中知识点展示的前置标题 |

| `sort` | 同一应用主题下多个知识主题的追加顺序，越小越靠前 |

| `weight_factor` / `permission_factor` | 权重系数、权限系数 |

| `enabled` | 0 停用 1 启用 |

表上有条索引值得注意：`idx_app_topic_enabled_sort(app_topic_id, enabled, sort)`。问答选知识主题时就是按这个顺序取，索引和查询路径对上了。

顺带看两个容易被略过的字段：`weight_factor`（权重系数）和 `permission_factor`（权限系数）。这是两个方向的扩展位——权重管"多个知识主题谁更权威"，召回后按系数调整排序；权限管"不同用户群看到的知识面"，配合租户和行权限做过滤。V1 里这两个字段先留在表里，但"加一个检索维度不用改表结构"这件事，已经提前安排好了。检索参数外置的价值不止是改数不改代码，更是给未来的排序和权限维度留了座位。

## 页面操作

![知识主题列表]