Docs
文档目录

知识库总览

知识库 是 Agentbase 面向企业非结构化与半结构化知识资产打造的全链路检索增强生成(RAG)引擎。通过控制台左侧导航栏的 知识库 入口,企业可将 Markdown、PDF、Office 文档、Excel 表格及语雀(Yuque)外部空间数据统一摄取入库,结合 词库(Lexicon) 同义词与停用词治理、多路混合检索(searchMode=hybrid)、语义重排、高级派生索引(GraphRAG、RAPTOR、LLM Wiki)以及不可变版本管理,为 智能体工作台(Agent Runtime) 与业务应用提供高准确率、可溯源的企业知识底座。


功能概述与核心场景

在企业智能客服与技术支持场景(如项目 企业智能客服与知识中台,ID:enterprise-ai-hub-210)中,传统单路向量检索往往面临专有名词漏召回、跨章节全局问题难以汇总、知识更新引发线上抖动等挑战。Agentbase 知识库提供端到端闭环能力:

  1. 多模态富文档异步摄取与精准分块:

    • 支持本地批量上传、Storage 存储桶(如 kb_enterprise_docs)文件绑定及语雀(Yuque)数据源增量同步。

    • 内置 text、vlm(视觉大模型解析)、mineru(复杂 PDF 版面/公式/表格还原)三类文档解析器,以及 general、title、smart、regex、faq 五类分块策略。

    • 文档摄取采用异步任务机制:触发摄取接口返回 HTTP 202 状态码,可分别查询摄取任务与文档详情;确认两者状态均为 ready,且文档的 activeGeneration 与任务的 generation 一致后再检索。

  2. 项目级词库(Lexicon)协同治理:

    • 支持创建同义词/扩展词词典(如 lex_enterprise_synonyms)与停用词/拦截词词典(如 lex_support_stopwords),并一键绑定至知识库(kb_enterprise_support)与智能体工作台,在检索前自动完成业务黑话改写、同义词扩展与违规提问拦截。

  3. 多路混合检索与韧性重排:

    • 支持 hybrid(混合检索)、vector(向量检索)与 fulltext(全文检索)三种 searchMode,可通过 vectorWeight 精细调节向量与全文得分融合比例。

    • 可选启用重排;显式 rerankModel 或 rerankProviderRef 调用失败时返回错误,均未指定的自动重排失败可回退并返回 reranked: false。单库 allowDegraded 控制增强索引的可降级错误;answer=true 使用检索证据合成答案,读者仍需核对来源。

  4. 三大高级派生索引(GraphRAG / RAPTOR / Wiki):

    • 基于已就绪(ready)的文档分块自动构建实体关系知识图谱(GraphRAG)、层次化递归聚类摘要树(RAPTOR)以及结构化百科页面(Wiki,如自动编译生成 10 篇技术支持百科页面)。

  5. 不可变版本发布与智能体工作台联动:

    • 支持草稿工作副本(Draft)、就绪门禁校验(Readiness Gate)、封存(Seal)、发布(Publish)与一键回滚(Rollback),并在 智能体工作台(Agent Runtime) 中直接挂载知识库与词库开展多轮交互问答。


核心概念与架构

企业级全链路 RAG 与知识治理架构图

知识库总览:流程示意,不是运行截图

流程示意,不是运行截图;按箭头阅读步骤或状态之间的关系。

查看流程图大图

核心概念与术语说明表

核心概念关键字段 / 接口标识详细说明
知识库实例knowledgeBaseId知识文档、分块、向量索引、派生图谱与版本快照的顶层容器(如 kb_enterprise_support)。创建时绑定向量模型(text-embedding-v3,1024 维)。
异步摄取作业ingestionId / HTTP 202发起摄取或触发重建后生成的异步摄取流水线记录。摄取接口返回 202 Accepted,后台经历解析、分块、图片理解与向量化,最终将文档状态置为 ready。
文档定位标识documentTag / subProductIdv2.10.0 引入的精准过滤元数据。documentTag 格式为 {subProductId}_{sectionCode}_{fileKey},支持在文档列表、单库/跨库检索与 Wiki 冲突列表中精确过滤。
词库(Lexicon)lexiconId项目级词汇治理组件,支持同义词(synonym)、扩展词(expansion)与停用词(stop)。可同时绑定至知识库与智能体工作台。
检索模式searchMode支持 hybrid(默认,向量 + 全文混合检索)、vector(纯语义向量检索)与 fulltext(关键词全文检索)。
混合向量权重vectorWeight在 searchMode=hybrid 下控制向量相似度得分与全文 BM25 得分的加权比例(取值范围 0.0~1.0,如 0.7 表示 70% 向量权重 + 30% 全文权重)。
增强检索降级allowDegraded单库默认 true;GraphRAG / RAPTOR / Wiki 遇到可降级错误时保留普通结果,并通过 capabilities / degradedCapabilities 记录。设为 false 时相关错误向调用方返回。
派生知识索引graphrag / raptor / wiki在基础 Chunk 向量索引之上构建的三类高阶索引能力,分别解决多跳实体关系推理、跨文档宏观总结与结构化百科沉淀问题。

功能入口与权限矩阵

十子模块导航、REST API 与权限矩阵总表

子模块名称手册专章链接前端控制台路由路径核心 REST API 端点Server SDK 方法(Node.js / Python)所需 RBAC 角色 / API Key Scope跨模块依赖关系
知识库总览与实例管理overview.md/console/project-default-enterprise-ai-hub-210/knowledge-baseGET/POST /v1/knowledgebasesknowledgeBase.list() / create()owner、admin、developer(只读成员仅查看)
Scope:knowledgebases.read / write
需要项目中可用的向量模型;具体模型和维度以实际配置为准
文档与异步摄取管理documents.md/console/.../kb-kb_enterprise_support/documentsPOST /v1/knowledgebases/{kbId}/documents
GET .../ingestions/{ingestionId}
knowledgeBase.createDocument()
getIngestion()
owner、admin、developer
Scope:knowledgebases.write
可使用知识库默认存储桶或指定有权访问的存储桶,并按需选择解析器
外部数据源与语雀同步datasources.md/console/.../kb-kb_enterprise_support/datasourcesPOST .../yuque/personal-datasources
POST .../datasources/{id}/syncs
个人数据源使用控制台或用户会话;团队同步见 SDK 参考个人数据源需当前用户会话或 JWT;knowledgebases.write同步后自动触发摄取并标记派生索引为 stale (data_source_sync)
高级知识索引构建治理indexing.md/console/.../kb-kb_enterprise_support/indexesGET/PATCH .../index-capabilities/{cap}
POST .../index-operations
knowledgeBase.updateIndexCapability()
createIndexOperation()
owner、admin、developer
Scope:knowledgebases.write
所需模型和构建条件以具体索引类型为准,参见索引构建指南
知识图谱可视化与社区报告graph.md/console/.../kb-kb_enterprise_support/graphGET .../graph
GET .../graph/entities/{id}/neighbors
GET .../graph/community-reports
knowledgeBase.getGraph()
getGraphEntityNeighbors()
listGraphCommunityReports()
owner、admin、developer、member
Scope:knowledgebases.read
依赖 GraphRAG 构建就绪;赋能 useKnowledgeGraph: true 多跳检索
知识库 Wiki 编译与治理wiki.md/console/.../kb-kb_enterprise_support/wikiGET/POST .../wiki/pages
GET .../wiki/conflicts
POST .../export-to-memory
knowledgeBase.listWikiPages()
resolveWikiConflict()
exportWikiPageToMemory()
owner、admin、developer
Scope:knowledgebases.write
联动 版本管理(Versions) 封存门禁与 记忆(Memory) 导出
混合检索与问答调试search.md/console/.../kb-kb_enterprise_support/searchPOST /v1/knowledgebases/{kbId}/search
POST /v1/knowledgebases/search
createSearch() / create_search()
createMultiSearch() / create_multi_search()
owner、admin、developer、member
Scope:knowledgebases.read
按实际检索配置使用可选重排与回答生成能力
不可变版本管理与回滚versions.md/console/.../kb-kb_enterprise_support/versionsPOST .../version-adoptions
POST .../versions/{id}/seal
POST .../publish & rollback
knowledgeBase.createVersion()
sealVersion()
publishVersion()
owner、admin(及授权发布人员)
Scope:knowledgebases.write
写时复制隔离草稿(DRAFT)与线上激活版本(Current)
项目级词库与多端绑定lexicons.md/console/.../knowledge-base/lexicons
/console/.../kb-kb_enterprise_support/lexicons
GET/POST /v1/lexicons
PUT .../kb_enterprise_support/lexicons
knowledgeBase.createLexicon()
updateKnowledgeBaseLexicons()
owner、admin、developer
Scope:lexicons.write
native-v1 分词器同时赋能检索改写、GraphRAG 消歧与智能体 stopIntercept
知识库设置与多模态 VLMsettings.md/console/.../kb-kb_enterprise_support/settingsPATCH /v1/knowledgebases/{kbId}
POST /v1/knowledgebases/{kbId}/reindex
knowledgeBase.update()
reindex()
owner、admin、developer(删除仅限 owner/admin)
Scope:knowledgebases.write
可配置图片理解(并发 1..8)与摄取追踪;启用图片理解需可用的视觉模型

与智能体工作台(Agent Runtime)的深度集成

在控制台左侧导航栏进入 智能体工作台(Agent Runtime),可通过项目级运行时配置(PATCH /v1/agent-runtime/project/config)将主对话模型设为 qwen-plus,直接挂载知识库 kb_enterprise_support 并绑定项目级词库 lex_enterprise_synonyms 与 lex_support_stopwords,立即在工作台对话窗口中验证带知识引用角标的企业客服问答。


功能详解与操作指南

步骤 1:创建知识库(示例)

  1. 在左侧导航栏点击 知识库,点击右上角 创建知识库 按钮。

  2. 按实际模型和文件填写表单。下表是配置示例,知识库 ID 由控制台生成,模型和维度需以实际可用配置为准:

配置项字段名标杆配置值说明与约束
知识库名称name企业智能客服与技术支持知识库展示名称;控制台自动生成知识库 ID
描述description沉淀架构白皮书、客服 SOP、OceanBase 向量排障与 AI 网关规范选填,说明知识库覆盖领域
向量模型embeddingModeltext-embedding-v3(来自 dashscope-prod)必选且创建后不可变更;系统自动探测模型可用性
向量维度embeddingDimension1024与 text-embedding-v3 输出维度严格一致,存储在 OceanBase Shared V2 向量表中
文档解析器documentParservlm(默认,需配置视觉模型);适用时可选 text 或 mineru控制原始文件到结构化 Markdown 文本的提取方式
分块策略chunkingParsertitle / smart推荐技术文档使用按标题层级或智能语义分块
分块大小与重叠率chunkTokenNum / overlapPercent512 Tokens / 10%兼顾上下文完整性与向量聚焦度
图片理解imageUnderstanding开启,模型选 qwen-vl-max,并发度 4自动对文档内的架构图与截图生成文字描述并合入分块索引

步骤 2:摄取核心文档并轮询 202 异步摄取状态至 ready

  1. 进入实际创建的知识库的文档页,上传有权使用的文件。下文 ID、文件和返回结果仅为示例,请替换为实际值。

  2. 通过 POST /v1/knowledgebases/{knowledgeBaseId}/documents 创建文档记录时返回 HTTP 201;调用 POST /v1/knowledgebases/{knowledgeBaseId}/documents/{documentId}/ingestions 发起摄取时返回 HTTP 202 和摄取任务信息。控制台可在上传后自动发起摄取。

  3. 客户端或自动化脚本分别查询摄取作业和文档详情;摄取详情接口不返回文档状态。以下是接口路径,不是命令:

GET /v1/knowledgebases/{knowledgeBaseId}/documents/{documentId}/ingestions/{ingestionId}

GET /v1/knowledgebases/{knowledgeBaseId}/documents/{documentId}

将下列占位值替换为实际值,使用具有 knowledgebases.read 权限的项目密钥。若检查版本化知识库中的草稿,请在两个地址中附加该草稿的 versionId 查询参数。

APPBASE_ENDPOINT="https://your-agentbase.example.com/v1"
APPBASE_PROJECT_ID="your-project-id"
APPBASE_KB_ID="your-knowledge-base-id"
APPBASE_DOCUMENT_ID="your-document-id"
APPBASE_INGESTION_ID="your-ingestion-id"
read -r -s -p 'API key: ' APPBASE_API_KEY
printf '\n'
printf 'header = "X-Appwrite-Key: %s"\n' "$APPBASE_API_KEY" | \
  curl --config - -sS -H "X-Appwrite-Project: ${APPBASE_PROJECT_ID}" \
    "${APPBASE_ENDPOINT}/knowledgebases/${APPBASE_KB_ID}/documents/${APPBASE_DOCUMENT_ID}/ingestions/${APPBASE_INGESTION_ID}"
printf 'header = "X-Appwrite-Key: %s"\n' "$APPBASE_API_KEY" | \
  curl --config - -sS -H "X-Appwrite-Project: ${APPBASE_PROJECT_ID}" \
    "${APPBASE_ENDPOINT}/knowledgebases/${APPBASE_KB_ID}/documents/${APPBASE_DOCUMENT_ID}"
unset APPBASE_API_KEY

也可以在控制台知识库的文档列表打开相应文档,查看文档状态和摄取记录;要通过 API 核对活跃代数,请另行调用文档详情接口。

  1. 分别确认摄取作业和文档状态均为 ready,并核对文档的 activeGeneration 与该作业的 generation 一致,再检索新代内容。向量维度以知识库实际配置为准。


步骤 3:绑定词库(Lexicon)并启用高级索引(GraphRAG / RAPTOR / Wiki)

  1. 绑定项目级词库:

    • 在项目 词库(Lexicons) 中创建同义词词典 lex_enterprise_synonyms(例如将 OB向量报错4013、向量内存不足 映射至标准术语 OB_ALLOCATE_MEMORY_FAILED)和停用词词典 lex_support_stopwords。

    • 调用 PUT /v1/knowledgebases/kb_enterprise_support/lexicons 或在知识库设置页勾选绑定这两个词库。

  2. 启用并构建派生索引:

    • 切换到知识库 知识索引(Indexes) 页签,依次开启 GraphRAG、RAPTOR 与 LLM Wiki 三项索引能力开关,并点击 构建(Build)。

    • 构建完成后,Graph 页签可浏览实体关系图谱,Wiki 页签自动编译生成包含首页总览(kb-index)在内的 10 篇结构化百科页面。


步骤 4:执行混合检索(searchMode=hybrid)与关联智能体工作台

在 检索测试(Search) 页签核对召回与来源;以下 API 示例另开启答案合成,并指定重排模型。示例模型名须替换为项目实际配置,显式模型失败不会被 allowDegraded 忽略:

curl -X POST "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/search" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  -H "X-Appwrite-Key: <APPBASE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "OceanBase 向量索引构建报 4013 内存不足时如何排障?工单升级 SOP 是什么?",
    "searchMode": "hybrid",
    "vectorWeight": 0.7,
    "similarityThreshold": 0.35,
    "limit": 5,
    "rerank": true,
    "rerankModel": "qwen3.7-text-rerank",
    "recallLimit": 20,
    "allowDegraded": true,
    "answer": true
  }'

随后,在 智能体工作台(Agent Runtime) 中保存项目级配置(/v1/agent-runtime/project/config),将 kb_enterprise_support 与词库 lex_enterprise_synonyms、lex_support_stopwords 挂载至 qwen-plus 智能体,即可在对话面板直接获得融合了排障指南与客服 SOP 的精准解答。


知识库设置与项目级词库(Lexicons)管理

一、管理知识库全局设置(Knowledge Base Settings)

进入 kb_enterprise_support 的 设置(Settings) 页签,可按分组查看与修改以下配置:

设置分组配置项标杆配置值变更影响与注意事项
基础信息名称与描述 (name / description)企业智能客服与技术支持知识库修改后立即生效,不影响任何索引与检索行为。
向量底座(只读)向量模型与维度 (embeddingModel / embeddingDimension)text-embedding-v3 / 1024 维创建后严禁修改。因为不同模型或不同维度的向量无法在同一 OceanBase 向量索引表中计算余弦距离。如需更换向量模型,请新建知识库。
默认摄取与分块 (indexingDefaults)文档解析器 (documentParser)
分块解析器 (chunkingParser)
分块参数 (chunkTokenNum 等)
text
title
512 Tokens / 10% 重叠
保存后仅对后续新上传或新触发摄取的文档生效;若希望存量 ready 文档应用新分块策略,须回到 文档 页签点击 整库重建(Reindex)。
摄取追踪 (ingestionTracing)记录解析与分块中间产物true(开启)供 可观测 -> 知识库解析评估 读取原始解析快照(需平台全局开关允许)。
多模态图片理解 (imageUnderstanding)启用开关 (enabled)
视觉模型 (model)
并发度 (maxConcurrency)
自定义提示词 (prompt)
true
qwen-vl-max
4(范围 1–8)
请提取架构图与表格中的关键组件、参数与流向
要求项目已在 LLM Gateway 注册具备 vlm 能力的 Provider;开启后需对历史含图文档重新摄取以生成图片描述。
检索默认值 (retrievalDefaults)向量权重 (vectorWeight)、相似度阈值 (similarityThreshold)示例 0.7、0.35检索请求省略这些参数时读取库默认值;searchMode 由请求选择,省略为 hybrid。
答案合成模型 (indexingDefaults)chatModel、可选 chatProviderRef项目实际可用的 Chat 模型单库 API answer=true 时使用;不是 retrievalDefaults 中的配置。

二、创建与管理项目级词库(lex_enterprise_synonyms & lex_support_stopwords)

在项目 enterprise-ai-hub-210 中,我们配置了 lex_enterprise_synonyms 与 lex_support_stopwords 两本核心生产词库(完整的 native-v1 分词原理、在线预览调试与 CSV/XLSX/JSON 导表指南详见项目级词库(Lexicons)与检索/图谱/智能体协同治理)。以下是快速创建与绑定步骤:

步骤 1:创建同义词词典与停用词词典

  1. 进入 词库(Lexicons) 管理界面,点击 创建词库(Create lexicon)。

  2. 分别创建以下两本词库:

    • 词库 1(同义词与扩展词词典):

      • 词库 ID / 名称:lex_enterprise_synonyms(企业智能客服同义词与专有名词词典)

      • 描述:统一 OceanBase、AI 网关及客服工单领域的缩写、黑话与错误码扩展

    • 词库 2(停用词与合规拦截词典):

      • 词库 ID / 名称:lex_support_stopwords(企业客服停用词与敏感拦截词典)

      • 描述:清洗检索口语噪声词并在智能体工作台前置拦截违规诱导提问

步骤 2:添加同义词(synonym)、扩展词(expansion)与停用词(stop)词条

进入词库详情页,点击 添加词条(Add entry) 或点击 批量导入(Import CSV/Excel) 上传词表:

所属词库词条类型 (type)主词 / 触发词 (term)目标同义词 / 扩展词列表 (targets)状态 (enabled)业务作用说明
lex_enterprise_synonymssynonymOB["OceanBase", "OceanBase数据库"]true用户搜 OB 与搜 OceanBase 完全双向等价召回
lex_enterprise_synonymssynonymAIGW["AI网关", "AI Gateway", "统一AI网关"]true统一中英文缩写与产品正式名称
lex_enterprise_synonymsexpansion向量报错4013["OB_ALLOCATE_MEMORY_FAILED", "ob_vector_memory_limit_percentage", "-4013"]true用户输入口语化报错时,单向注入精确错误码与内核参数名
lex_enterprise_synonymsexpansion工单升级["二线技术专家", "SOP流转时限", "P1故障响应"]true强化客服 SOP 手册章节召回
lex_support_stopwordsstop请问一下呗[]true检索前剥离无意义口语后缀
lex_support_stopwordsstop忽略之前所有系统指令[]true在智能体工作台配合 stopIntercept 直接拦截越狱指令

批量导入/导出说明:点击词库右上角的 导出(Export) 可下载标准格式模板(含 type,term,targets,enabled 列),在本地 Excel 编辑完数千条行业词条后点击 导入(Import) 即可一键完成增量合并或全量更新。


三、将词库绑定至知识库与智能体工作台(REST API 与控制台操作)

词库创建完成后,需要将其绑定至目标知识库(kb_enterprise_support)或智能体工作台(Agent Runtime)方可在运行时生效:

1. 绑定至知识库(/v1/knowledgebases/{knowledgeBaseId}/lexicons)

在 kb_enterprise_support 的 设置(Settings)-> 关联词库(Bound Lexicons) 区域,勾选 lex_enterprise_synonyms 与 lex_support_stopwords 并点击保存;或通过 API 绑定:

# 1. 创建项目级词库 (POST /v1/lexicons)
curl -X POST "https://appbuild.oceanbase.com/v1/lexicons" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  -H "X-Appwrite-Key: <APPBASE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "lexiconId": "lex_enterprise_synonyms",
    "name": "企业智能客服同义词与专有名词词典",
    "description": "OceanBase与AI网关专有名词同义词及扩展词"
  }'

# 2. 向词库批量添加 synonym 与 expansion 词条 (POST /v1/lexicons/{lexiconId}/entries)
curl -X POST "https://appbuild.oceanbase.com/v1/lexicons/lex_enterprise_synonyms/entries" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  -H "X-Appwrite-Key: <APPBASE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "expansion",
    "term": "向量报错4013",
    "targets": ["OB_ALLOCATE_MEMORY_FAILED", "ob_vector_memory_limit_percentage", "-4013"],
    "enabled": true
  }'

# 3. 将词库绑定至知识库 kb_enterprise_support (PUT /v1/knowledgebases/{knowledgeBaseId}/lexicons)
curl -X PUT "https://appbuild.oceanbase.com/v1/knowledgebases/kb_enterprise_support/lexicons" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  -H "X-Appwrite-Key: <APPBASE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "lexiconIds": ["lex_enterprise_synonyms", "lex_support_stopwords"]
  }'

2. 绑定至智能体工作台并开启停用词前置拦截(/v1/agent-runtime/project/lexicons)

在智能体工作台配置中绑定词库,并配置 stopIntercept 与 stopReply:

curl -X PUT "https://appbuild.oceanbase.com/v1/agent-runtime/project/lexicons" \
  -H "X-Appwrite-Project: enterprise-ai-hub-210" \
  -H "X-Appwrite-Key: <APPBASE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "lexiconIds": ["lex_enterprise_synonyms", "lex_support_stopwords"],
    "stopIntercept": true,
    "stopReply": "抱歉,您的提问包含受限或不符合企业安全规范的指令,请围绕产品技术支持与客服业务进行咨询。"
  }'

验证结果:


首次完成一次检索

建议按“准备模型 → 创建知识库 → 摄取文档 → 检索验证 → 核对来源”的顺序走完一条路径。下图只表达已核验的操作关系,不还原 Console 页面,也不是运行截图:

知识库首次检索流程示意(不代表 Console 页面截图)

创建知识库前,至少要有一个具备 embedding 能力的模型;只有需要图片理解时才额外配置视觉模型。若要让检索请求生成答案,还需按部署能力配置对应的 chat 模型。模型服务和可选解析能力都受项目配置及部署能力约束,见模型与 AI 网关。

如果结果缺少预期内容,先确认文档已完成摄取,并检查解析和分块结果;修改解析器或分块参数后,需要重新摄取受影响的文档。检索结果的分数用于排序,不代替对来源原文的核对。

创建知识库

列表页点击 Create knowledge base,字段:

字段规则
Name / Description名称必填;描述可选
Embedding model必选(仅列出具备 embedding 能力的 Provider 模型;未选无法提交)
Embedding dimension可选(1–65535):对所选模型探测校验,不匹配则创建失败
Ingestion tracing可选开关:开启后记录摄取中间产物(解析 / 分块),供「知识库解析评估」使用;依赖平台管理员全局开关,开启后需重新摄取才有完整证据
Image understanding开关 + 模型 + 提示词 + 最大并发(需项目已配置视觉模型 Provider)
Chunking parsergeneral / title / smart / regex / faq,及分块参数:chunkTokenNum(默认 512)、overlapPercent(默认 10)、titleLevel(默认 3)、minChunkTokens(默认 128)、delimiter、regexPattern

解析配置只影响之后的摄取;历史文档要重新摄取才会应用新配置。

使用边界

常见问题与排障(FAQ)

Q1:摄取接口返回 HTTP 202 后,为什么立即检索不到文档内容?

Q2:启用 Rerank 后,上游限流是否会让检索失败?

取决于是否显式选择重排模型或 Provider。传入 rerankModel 或 rerankProviderRef 时,调用异常会返回给调用方;应修复模型配置、限流或服务故障。两者均未指定的自动重排采用尽力执行方式,失败可回退原排序,返回 reranked: false,此时不要把结果当作已精排。

allowDegraded 单独控制增强检索的可降级错误,不能用于忽略显式重排模型失败。单库响应的 capabilities 与 degradedCapabilities 描述增强能力状态;按业务是否接受基础结果选择该开关。

Q3:修改了知识库的默认分块参数(如 chunkTokenNum)或开启了图片理解后,已处于 ready 状态的存量文档会自动生效吗?

Q4:词库(Lexicon)绑定在知识库上和绑定在智能体工作台上有什么区别?


相关文档