对话创建
更新时间：2026-04-14
POST
https://qianfan.baidubce.com/v2/agent/{agent_code}/create
本接口用于创建一个新的 Agent 对话，调用成功后将返回一个conversation_id。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
agent_code
string
支持以下Agent：
- code_interpreter：代码解释器
- browser_use：浏览器使用
- deepresearch：深度研究
- ai_assistant：AI助手
由特定agent_code生成时，仅限在该智能体（Agent）内部使用，禁止跨智能体调用。
必选
Body 参数
agent_id
string
当 agent_code 参数为 deepresearch 时为必传，其他场景不传。
请到千帆控制台Agent开发-官方Agent-深度研究Agent中，创建Agent并完成配置及发布后，回到我的Agent页面，即可复制ID
可选
end_user_id
string
终端用户 ID，用于隔离不同用户的对话上下文和历史记录。
用户自定义上传，长度限制为 6 ～ 63 字符。
若未传入或传空时，系统将根据 API Key 对应的账号 ID 自动生成一个默认的终端用户 ID。
可选
请求结构
POST /v2/agent/{agent_code}/create HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <Access_Token>
Content-Type: application/json示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/agent/deepresearch/create" \
-H "Authorization: Bearer <API Key>" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "ae295e8b-d700-467d-b5c7-964b9fc8b099",
"end_user_id": "zhangsan"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
request_id
string
请求的唯一标识 ID
必选
result
object {1}
返回结果对象
必选
显示子属性
隐藏子属性
conversation_id
string
对话ID，新创建的对话唯一标识。
必选
响应示例
{
"request_id": "e84f1058-0b15-4983-ba18-ed140bd480aa",
"result": {
"conversation_id": "de65bd4c-f44f-4081-8435-9f99e671d18b"
}
}评价此篇文章