什么是 千帆知识库搜索？

此技能使 AI Agent 能够直接与百度千帆平台对接，访问存储在私有知识库中的专有数据。通过利用 Openclaw Skills，开发者可以实现超越公共数据集的高级检索增强生成 (RAG) 工作流，从而获取安全的内部信息。

它为千帆先进的搜索引擎提供了稳健的桥梁，支持语义搜索、全文搜索和混合搜索等多种检索方式。这确保了 AI Agent 能够找到最相关的文档分块、表格甚至知识图谱连接，从而在任何开发环境中提供准确且具备上下文感知的响应。

下载入口:https://github.com/openclaw/skills/tree/main/skills/hannatao/qianfan-knowledgebase-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

千帆知识库搜索 应用场景

• 从私有企业存储库中检索特定的技术文档。
• 利用最新的内部公司知识增强 AI 聊天机器人的回答。
• 在大规模专有文本数据集上进行深度语义搜索。
• 使用 Openclaw Skills 将 RAG 功能集成到自主代理中。
• 通过知识图谱扩展发现关联的数据实体。

1. 代理通过传递搜索查询和可选配置参数（如知识库 ID）来触发该技能。
2. Python 执行脚本处理请求，并使用您提供的凭据通过百度千帆 API 进行身份验证。
3. 该技能执行多阶段搜索，包括初始召回（混合、语义或全文）和可选的重排序阶段，以确保高精度。
4. 包含文本块、元数据和相关性分数的结构化结果将返回给代理以供立即处理。

千帆知识库搜索 配置指南

要开始使用 Openclaw Skills 库中的此条目，您需要百度千帆 API 密钥和目标知识库 ID。

# 配置环境变量
export BAIDU_API_KEY="your_api_key"
export QIANFAN_KNOWLEDGEBASE_IDS="kb_id_1,kb_id_2"

确保您已安装 Python 3，然后使用 JSON 有效负载执行搜索脚本：

python3 skills/qianfan-knowledgebase-search/search.py '{"query":"your search query"}'

千帆知识库搜索 数据架构与分类体系

该技能返回结构化的 JSON 响应，以维护 Openclaw Skills 工作流中的数据完整性。该架构包括：

name: qianfan-knowledgebase-search
description: Search knowledge from Qianfan Knowledgebase. Use this when you need to retrieve information from user's private knowledge bases on Baidu Qianfan platform.
metadata: { "openclaw": { "emoji": "??",  "requires": { "bins": ["python3"], "env":["BAIDU_API_KEY", "QIANFAN_KNOWLEDGEBASE_IDS"]},"primaryEnv":"BAIDU_API_KEY" } }

Qianfan Knowledgebase Search Skill

Search and retrieve knowledge from Baidu Qianfan platform knowledge bases. Supports semantic search, fulltext search, hybrid search, and reranking.

Workflow

1. The skill executes the Python script located at search.py
2. The script makes a POST request to the Qianfan Knowledgebase Search API
3. The API returns structured search results with chunks, scores, and metadata

Environment Variables

Parameters

request body structure

Note: Use flattened parameter names in input (e.g., recall_type, recall_top_k), the script will convert to nested structure automatically.

Example Usage

# Configure knowledgebase IDs via environment variable
export BAIDU_API_KEY="your_api_key"
export QIANFAN_KNOWLEDGEBASE_IDS="kb_id_1,kb_id_2"
python3 skills/qianfan-knowledgebase-search/search.py '{"query":"请介绍下千帆大模型知识库"}'

# Or specify knowledgebase IDs in request parameters
python3 skills/qianfan-knowledgebase-search/search.py '{"query":"如何使用API","knowledgebase_ids":["kb_id_1","kb_id_2"],"top_k":10,"recall_type":"hybrid","rerank_enable":true}'

Response Structure

Response contains the following fields:

• id: Request unique identifier
• created_at: Request timestamp
• total_count: Total number of chunks returned
• chunks: Chunk list
  • chunk_id: Chunk unique identifier
  • content: Chunk content (supports text/figure/table/graph types)
  • rerank: Rerank score and position
  • recall: Recall score and position
  • meta: Metadata (chunk_type, tokens, word_count, doc_info, etc.)
  • neighbors: Related chunks

Current Status

The Qianfan Knowledgebase Search skill is fully functional and can be used to retrieve knowledge from private knowledge bases on the Baidu Qianfan platform.