通义深度搜索-对接自有知识库

相关产品：

面向深度的查询问答和调研分析需求场景,多步骤推理规划研究路径,生成有洞察、可溯源、图文并茂的长文报告-大模型服务平台百炼(Model Studio)-阿里云帮助中心

---

通义深度搜索应用支持百炼知识库和用户自有知识库接入，本文档主要用于自有知识库接入规范的约束，用户可以参考如下接口规范进行知识库对接。

请求说明

接口

协议：HTTP+POST

接口：自定义

功能说明：该API允许通义深度搜索应用对您提供的接口执行复杂的文本查询、排序和分页操作。

请求头

参数名	类型	说明	是否必须
Authorization	string	鉴权信息	是
Content-Type	string	静态值:application/json	是

请求体

参数名	类型	说明	是否必须
rid	string	请求 ID	是
query	string	查询文本	是
num	int	召回数量，取值区间 1~100	是
page	int	页码，取值区间 1~100	否
debug	bool	调试模式，默认值 false	否

请求示例

curl --location 'https://xxx' \
--header 'Authorization: Bearer lm-***' \
--header 'Content-Type: application/json' \
--data '{
    "rid": "10c96b02-4207-4991-820c-f8a855d1dc42",
    "query": "阿里云百炼",
    "num": 10,
    "debug": false
}'

响应说明

响应参数

参数名	类型	说明	是否必须
rid	string	请求 ID	是
status	int	状态码（0：成功）	是
message	string	状态消息	是
data	object	返回数据	是
data.total	int	召回总数	否
data.docs	array	召回数据列表（字段可扩展）	是
data.docs.[].id	string	页面ID	是
data.docs.[].title	string	标题	是
data.docs.[].url	string	网页链接	是
data.docs.[].snippet	string	摘要	是
data.docs.[].content	string	网页原文	否
data.docs.[].timestamp_format	string	网页发布时间	否
data.docs.[].timestamp	long	网页发布时间戳	否
data.docs.[].hostname	string	网站名	否
data.docs.[].hostlogo	string	网站logo	否
debug	object	调试数据	否

响应示例

{
    "rid": "10c96b02-4207-4991-820c-f8a855d1dc42",
    "status": 0,
    "message": "success",
    "data": {
        "total": 10,
        "docs": [
            {
                "id": "cid-98cc77b09",
                "snippet": "阿里云百炼平台是阿里云推出的服务平台。开发者可通过“拖拉拽”5分钟开发一款大模型应用，***",
                "title": "阿里云百炼平台-百度百科",
                "url": "https://baike.baidu.com/item/***",
                "timestamp_format": "2025-09-02 00:00:00",
                "timestamp": 1756742400
                "hostname": "百度百科",
                "hostlogo": "https://cdn.sm.cn/temp/***",
            },
            {...}
        ]
    },
    "debug": {...}
}

注意事项

最大容忍超时：timeout=3000ms

服务可用判定条件：HTTP状态码"200",且返回数据status为"0"

您的自建数据会按照账号加应用维度隔离，仅会被模型规划生成使用，并不会进行存储。

---

点击：更多讨论交流