检索与溯源
单库 / 跨库检索与溯源读原文的各语言调用示例;概念、参数与边界口径见知识库。
各语言调用示例
检索(单库 / 跨库)
createSearch 单库,createMultiSearch 跨 1–10 库(跨库先 RRF 合并再对合并池做一次 rerank);结果 chunk 带 content / source / locator。Web 面无检索能力。
- Node.js(Server)
- Java
- Python
- Go
- REST(curl)
const found = await kb.createSearch({
knowledgeBaseId: base.$id,
query: '退款政策是什么?',
searchMode: 'hybrid', // 参数名是 searchMode;vector / fulltext / hybrid
limit: 10,
rerank: true // 先扩大召回再经 Gateway 重排;自动选择失败降级并返回 reranked: false
});
// 跨库:kb.createMultiSearch({ knowledgeBaseIds: [...], query, limit })(1–10 库,全局 TopK)var found = kb.createSearch(base.getId(), "退款政策是什么?",
10L, // limit(注意:位于 searchMode 之前)
io.agentbase.enums.SearchMode.HYBRID, // vector / fulltext / hybrid
true, // rerank:先扩大召回再经 Gateway 重排;自动选择失败降级并返回 reranked: false
null, null, null, null, null); // recallLimit / rerankModel / rerankProviderRef / similarityThreshold / vectorWeight
// 跨库:kb.createMultiSearch(...)(1–10 库,全局 TopK)found = kb.create_search(
knowledge_base_id=base['$id'],
query='退款政策是什么?',
search_mode='hybrid', # 参数名是 search_mode;vector / fulltext / hybrid
limit=10,
rerank=True) # 先扩大召回再经 Gateway 重排;自动选择失败降级并返回 reranked: false
# 跨库:kb.create_multi_search(knowledge_base_ids=[...], query=..., limit=...)(1–10 库,全局 TopK)found, err := kb.CreateSearch(base.Id, "退款政策是什么?",
kb.WithCreateSearchSearchMode("hybrid"), // vector / fulltext / hybrid
kb.WithCreateSearchLimit(10),
kb.WithCreateSearchRerank(true)) // 自动选择失败降级并返回 reranked: false
// 跨库:kb.CreateMultiSearch(...)(1–10 库,全局 TopK)curl -sS -X POST "$APPBASE_ENDPOINT/knowledgebases/kb_product_docs/search" \
-H 'Content-Type: application/json' \
-H "X-Appwrite-Project: $APPBASE_PROJECT_ID" -H "X-Appwrite-Key: $APPBASE_API_KEY" \
-d '{"query":"早餐机首次使用要注意什么","limit":5,"searchMode":"hybrid","similarityThreshold":0.5,"vectorWeight":0.7}'
# 跨库:POST /knowledgebases/search,body 加 "knowledgeBaseIds":["kb_a","kb_b"](1–10 库且不重复)溯源与读原文
命中 chunk 自带 content、source(受保护原文 URI)与 locator(章节 / 文本偏移);getDocumentSource 读回原始文件(二进制流,支持 Range 分段返回 206),只需 knowledgebases.read、不另需 files.read。Web 面无此能力。
- Node.js(Server)
- Java
- Python
- Go
- REST(curl)
// 命中 chunk 的 sourceId 即原文档 ID;读回原文做人工核对或归档
const raw = await kb.getDocumentSource({ knowledgeBaseId: base.$id, documentId: '<documentId>' });byte[] raw = kb.getDocumentSource(base.getId(), "<documentId>"); // 二进制流,不要按 JSON 解析;只需 knowledgebases.readraw: bytes = kb.get_document_source(knowledge_base_id=base['$id'], document_id='<documentId>')
# 二进制流,不要按 JSON 解析;只需 knowledgebases.readraw, err := kb.GetDocumentSource(base.Id, "<documentId>") // *[]byte:原始文件二进制,不要按 JSON 解析curl -sS "$APPBASE_ENDPOINT/knowledgebases/kb_product_docs/documents/<documentId>/source" \
-H "X-Appwrite-Project: $APPBASE_PROJECT_ID" -H "X-Appwrite-Key: $APPBASE_API_KEY" \
-o source.bin # 二进制流,不要按 JSON 解析;带 Range 头时分段返回 206