通义深度搜索API全面指南：核心功能与调用示例

通义深度搜索的能力现已通过API接口开放调用。该套接口覆盖从对话生成到知识库集成的完整技术链路，全部基于DashScope HTTP协议对外提供服务。开发者能够像拼装模块一样，将这些功能无缝嵌入自有应用。

接口鉴权配置

调用任一接口前，必须先获取API Key。需特别注意：在邀测阶段，仅百炼默认业务空间下的API Key具备调用权限。开发前务必核实这一权限设置。

接口清单与场景

当前共开放四个接口，对应不同业务场景。首先介绍核心的生成对话接口——它利用智能体应用管理返回的agent_id与agent_version，实现场景化对话、深度研究以及内容写作。简言之，若需让模型针对特定主题执行调研分析，或生成结构化的长文报告，直接调用此接口即可。

其次是上传文件接口。该接口专为“动态文档解析”场景设计：上传文件后即可获得处理完成的结构化信息；在智能体应用的API调用中，通过parameters.agent_options.sessions_files参数将文件数据注入。模型据此能够基于文档内容执行深度问答。

当对话或研究完成后需要保存结果？使用生成报告导出接口即可。它支持将深度搜索应用生成的报告直接导出为md、html、pdf格式，适用于存档或二次加工。

最后是对接自有知识库接口。若企业或团队拥有专属知识库，希望模型基于库内数据进行回答，可参考该接口规范完成对接。这是实现私有化部署与定制化服务的核心通道。