核心用法
Qianfan Knowledgebase Search 是一个面向百度千帆大模型平台的私有知识库检索技能，通过调用官方 API 实现多策略文档召回。用户需配置 BAIDU_API_KEY 环境变量授权访问，支持通过环境变量或请求参数指定目标知识库 ID。
该技能提供四层检索能力：
- 召回策略：支持全文检索（fulltext）、语义向量检索（semantic）、混合检索（hybrid），混合模式下可调整向量权重（vec_weight）
- 重排序优化：基于千帆内置模型对召回结果智能重排，可配置 top_n 返回数量
- 阈值过滤：通过 score_threshold 过滤低相关性结果
- 扩展功能：可选开启知识图谱（enable_graph）和上下文扩展（enable_expansion）
参数支持扁平化命名（如 recall_type 自动映射为 recall.type），降低调用复杂度。
显著优点
1. 企业级检索能力：背靠百度千帆平台，支持大规模私有知识库管理
2. 多模态内容支持：返回结果包含文本、图表、表格、知识图谱等多种 chunk 类型
3. 灵活的策略组合：召回与重排序分离设计，便于根据业务场景调优
4. 完善元信息：每个 chunk 附带 token 数、字数、文档来源等详细元数据
潜在局限
1. 平台绑定：仅支持百度千帆生态，无法对接其他向量数据库或知识库平台
2. 配置门槛：需提前在千帆平台完成知识库创建、文档上传、向量化等准备工作
3. 成本不透明：调用费用取决于千帆平台计费策略，未在技能层面暴露用量统计
4. 调试困难：API 错误需通过返回码自行排查，缺乏本地模拟/沙箱模式
适合人群
- 已部署百度千帆大模型平台的企业用户
- 需要为 Agent/应用对接私有文档检索能力的开发者
- 对中文文档语义检索有较高要求的知识库场景
常规风险
- 密钥泄露风险：
BAIDU_API_KEY为敏感凭证，需通过安全的环境变量或密钥管理服务注入 - 数据出境合规：知识库内容上传至百度云服务，需评估数据安全合规要求
- 服务可用性依赖：检索质量与稳定性受千帆平台 SLA 约束