必须直接调用底层检索接口验证：确认知识库状态为“运行中”且已发布，用curl发送请求，检查响应results中content是否包含文档独有句子，以此证明全链路通畅。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要验证火山引擎私域知识库是否能正确返回你上传的文档内容，必须绕过前端界面直接调用底层检索接口，因为控制台的“测试问答”功能不暴露原始响应结构，也无法确认向量化是否成功、切片是否被索引、关键词是否命中。
确认知识库已发布且状态为“运行中”
登录火山引擎控制台 → 进入「知识库」服务 → 找到目标知识库 → 查看右上角状态标签。只有显示【运行中】才代表向量索引已完成构建并对外提供服务；若为“构建中”或“异常”，后续所有检索请求都会返回空结果或503错误。
点击知识库名称进入详情页，在「配置」→「发布管理」中确认已执行“发布”操作。未发布的知识库即使状态为运行中，其索引也不会加载到线上服务节点。
构造最小化检索请求（curl方式）
打开终端，执行以下命令（替换your-kb-id和your-api-key）：
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/knowledge_bases/your-kb-id/search" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key" \
-d '{"query":"试一下知识库有没有生效","top_k":3}'
注意：该接口路径中的your-kb-id必须与知识库详情页URL末尾的ID完全一致（如kb-abc123def456），大小写敏感；填错会直接返回404，而不是提示“知识库不存在”。
检查响应体中的关键字段
成功响应应包含非空的results数组，每个元素含content、score、source三项。
若results为空数组，但HTTP状态码是200：说明知识库服务正常，但没有匹配到任何切片——此时需检查上传文档是否被成功解析（PDF是否加密、Word是否含图片文字、TXT是否UTF-8无BOM）；
若返回401：确认ARK_API_KEY变量是否设对，或是否误用了管控面API Key；
若返回400且含"message": "invalid knowledge base id"：ID复制时多了一个空格或换行符。
真正有效的验证是看到content字段里出现你文档中独有的句子，比如你上传的《售后FAQ.docx》里有“退换货需在签收后7日内发起”，而响应中content精确返回了这整句话——这才证明切片、向量化、索引、检索全链路通畅。
