数据智能体 DataAgent（私有化）
数据智能体 DataAgent（私有化）
- 文档首页
数据智能体 DataAgent（私有化）开放与集成智能营销AgentOpenAPI企业知识引擎文档管理文档召回
复制全文
下载 pdf
文档反馈
问问助手调用本接口基于 question 对指定知识库（或 doc_ids）中的文档做语义召回，使用文档元信息（overview / guide）作为向量来源，支持多路 channel 并发召回与融合、相似度阈值过滤、top_n 截断，返回 doc_id 列表及分数。
- 接口名称：retrieval_document_retrieval_post
- 接口地址：/document/retrieval
- 请求方式：POST
参数名 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
kb_ids | Array | 是 | 知识库ID列表 |
doc_ids | Array | 否 | 可选：限定召回的文档ID列表；不传则召回 kb_id 下所有文档 |
question | String | 是 | 召回 query |
similarity_threshold | Number | 否 | 相似度阈值，低于此值的文档被丢弃 |
top_n | Number | 否 | 返回的最多文档数 |
vector_weight | Number | 否 | 每路向量权重，透传给 DocMetaSophonService.recall |
enable_overview | Boolean | 否 | 是否召回 overview 字段，默认开 |
enable_guide | Boolean | 否 | 是否召回 guide 字段，默认开 |
channel_fusion | String | 否 | 多路 channel 融合方式：mean（算术平均，默认）/ max |
参数名 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
code | Number | 是 | 响应码：0=成功，非0=失败 |
msg | String | 否 | Code非0时，返回错误信息 |
message | String | 否 | 错误信息 |
data | Object | 是 | 数据，详情请参见下文 data 表 |
data
参数名 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
total | Number | 是 | 命中文档数 |
docs | Array | 否 | 命中的文档列表，按 score 降序，详情请参见下文 docs 表 |
docs
参数名 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
doc_id | Number | 是 | 文档ID |
file_name | String | 否 | 文件名 |
overview | String | 否 | 文档概览 |
guide | String | 否 | 文档导读 |
keywords | String | 否 | 文档关键词 |
score | Number | 否 | 最终得分（多路 channel 融合后） |
per_channel | Object | 否 | 每路 channel 的原始得分，key 为 channel 名（overview/guide/...） |