qianfan-knowledgebase-search
✓Verified·Scanned 2/18/2026
Search knowledge from Qianfan Knowledgebase. Use this when you need to retrieve information from user's private knowledge bases on Baidu Qianfan platform.
from clawhub.ai·veb36c74·6.5 KB·0 installs
Scanned from 1.0.1 at eb36c74 · Transparency log ↗
$ vett add clawhub.ai/hannatao/qianfan-knowledgebase-search
Qianfan Knowledgebase Search Skill
Search and retrieve knowledge from Baidu Qianfan platform knowledge bases. Supports semantic search, fulltext search, hybrid search, and reranking.
Workflow
- The skill executes the Python script located at
search.py - The script makes a POST request to the Qianfan Knowledgebase Search API
- The API returns structured search results with chunks, scores, and metadata
Environment Variables
| env | required | description |
|---|---|---|
| BAIDU_API_KEY | yes | Qianfan platform API Key |
| QIANFAN_KNOWLEDGEBASE_IDS | no | Knowledgebase IDs, comma-separated (used if not specified in request) |
Parameters
request body structure
| param | type | required | default | description |
|---|---|---|---|---|
| query | str | yes | Search query content | |
| knowledgebase_ids | list[str] | no | Knowledgebase ID list (uses env var if not specified) | |
| top_k | int | no | 6 | Number of chunks to return, range [1, 40] |
| score_threshold | float | no | 0.4 | Score threshold for filtering, range [0, 1] |
| enable_graph | bool | no | false | Enable knowledge graph |
| enable_expansion | bool | no | false | Return expanded chunks |
| recall | obj | no | Recall strategy configuration | |
| +recall.type | str | no | hybrid | Recall type: fulltext/semantic/hybrid |
| +recall.top_k | int | no | 100 | Recall phase top_k, range [1, 400] |
| +recall.vec_weight | float | no | 0.75 | Vector weight when type=hybrid, range [0, 1] |
| rerank | obj | no | Rerank configuration | |
| +rerank.enable | bool | no | true | Enable reranking |
| +rerank.top_n | int | no | 20 | Rerank top_n, range [1, 40] |
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.