请求参数

请求体 (JSON)

{
  "query": "string (必填)",
  "conversation_id": "string (可选)",
}

参数说明

参数名	类型	必填	说明
query	string	是	用户查询内容，支持自然语言问题
conversation_id	string	否	对话 ID，用于上下文关联

认证方式

该接口需要 API Key 认证，请在请求头中添加 Authorization 字段：

Authorization: Bearer <your-api-key>

⚠️ 重要提示

• 请将 <your-api-key> 替换为您的实际 API 密钥
• API 密钥可以通过用户管理界面创建和管理
• 请妥善保管您的 API 密钥，不要泄露给他人

请求示例

curl -X POST "[HOST]/api/v1/agent?action=deepsearch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -d '{
    "query": "请帮我搜索最新的AI技术发展趋势",
    "conversation_id": "conv_1234567890"
  }'

响应示例

event: response.output_item.added
data: {"type":"response.output_item.added","sequence_number":1,"item":{"id":"ws_1761549872262388000","status":"in_progress","type":"web_search_call"}}

event: response.web_search_call.in_progress
data: {"type":"response.web_search_call.in_progress","sequence_number":2,"item_id":"ws_1761549872262388000"}

event: response.web_search_call.searching
data: {"type":"response.web_search_call.searching","sequence_number":3,"item_id":"ws_1761549872262388000"}

event: response.web_search_call.completed
data: {"type":"response.web_search_call.completed","sequence_number":4,"item_id":"ws_1761549872262388000"}

event: response.output_item.done
data: {"type":"response.output_item.done","sequence_number":5,"item":{"action":{"type":"search","query":"0.1和0.9哪个大","results":[{"title":"0.9无限循环和1谁大？ - 知乎","link":"https://www.zhihu.com/question/443556633","snippet":"0.9循环反直觉的原因在于，循环小数表示是否严格等于它所表示的数，没法在十进制这个体系内部得到解答，而需要借助别的数学工具，不管是 1/3 x 3，还是把 0.9循环写成级数求和，都是用别的更严 …","position":1},{"title":"1和0.9循环哪个大？ - 百度知道","link":"https://zhidao.baidu.com/question/1457989839897097900.html","snippet":"\n一样大\n第一种解法：\n因为1÷9=0.1111无限循环\n2÷9=0.2222无限循环\n3÷9=0.3333无限循环\n................................\n9÷9=0.9999无限循环=1\n所以一样大\n\n\n![](https://iknow-pic.cdn.bcebos.com/caef76094b36acafdf4ad69c6cd98d1001e99c2c?","position":2},{"title":"小学数学题：0.999无限循环和1到底哪个大？答 …","link":"https://www.sohu.com/a/736768001_120091478","snippet":"\n在日常生活中，我们常常会遇到一些看似简单却充满深意的数学问题。其中一个经典问题就是0.999无限循环和1哪个更大的问题。直观上，我们会认为0.999无限循环和1是不同的数，但在数学上，它们却是相等的。\n\n\n![](https://p4.itc.cn/images01/20231116/2f99580a9aa24fe29674f81b6a5bd7b2.","position":3},{"title":"每天一个数学小知识——0.9循环和1哪个大？_哔哩哔哩_bilibili","link":"https://www.bilibili.com/video/BV1Au411W7g5/","snippet":"2023年5月31日·，相关视频：每天一个数学小知识——证明1+1=2，每天一个数学小知识——∞和∞+1哪个大？ ，每天一个数学小知识——一元三次方程的求解思路，芙宁娜讲物理:比热容 (准初三必看，看完这个视频你会爱上数学的！","position":4},{"title":"1和0.9的循环哪个大？为什么总有人列出一些公式来证明 ...","link":"https://www.toutiao.com/answer/6767882150671810819/","snippet":"2019年12月8日·老张教育新思享回答了1和0.9的循环哪个大？为什么总有人列出一些公式来证明它们相等？,1和0.9的无限循环哪个大？简单的数学题曾引发人类数学危机！最让人纠结的等式，拥有多彩 …","position":5}]},"id":"ws_1761549872262388000","status":"completed","type":"web_search_call"}}

......

event: response.content_part.added
data: {"type":"response.content_part.added","sequence_number":121,"output_index":24,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":24,"part":{"annotations":[],"logprobs":[],"text":"","type":"output_text"},"sequence_number":121,"type":"response.content_part.added"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":122,"output_index":24,"item_id":"msg_1761549872262388000","item":{"content_index":0,"delta":"###","item_id":"msg_1761549872262388000","logprobs":[],"output_index":24,"sequence_number":122,"type":"response.output_text.delta"}}

event: response.output_text.done
data: {"type":"response.output_text.done","sequence_number":123,"output_index":24,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":24,"sequence_number":123,"type":"response.output_text.done"}}

......

event: response.content_part.added
data: {"type":"response.content_part.added","sequence_number":883,"output_index":278,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":278,"part":{"annotations":[],"logprobs":[],"text":"","type":"output_text"},"sequence_number":883,"type":"response.content_part.added"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":884,"output_index":278,"item_id":"msg_1761549872262388000","item":{"content_index":0,"delta":"1","item_id":"msg_1761549872262388000","logprobs":[],"output_index":278,"sequence_number":884,"type":"response.output_text.delta"}}

event: response.output_text.done
data: {"type":"response.output_text.done","sequence_number":885,"output_index":278,"item_id":"msg_1761549872262388000","item":{"content_index":0,"item_id":"msg_1761549872262388000","output_index":278,"sequence_number":885,"type":"response.output_text.done"}}

event: response.cost.final
data: {"type":"response.cost.final","sequence_number":886,"output_index":279,"item":{"output_index":279,"sequence_number":886,"total_cost":0.05522360760000001,"type":"response.cost.final"}} 

data: [DONE]