创建AI助手对话任务
更新时间:2025-12-26
POST
https://qianfan.baidubce.com/v2/agent/ai_assistant/run
创建AI助手对话任务,返回对话ID用于后续多轮对话
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
Body 参数
query
string
输入的对话信息
必选
conversation_id
string
对话ID。首轮对话:可不填,由服务端自动生成并在响应中返回。多轮对话:必须填写,以保持上下文连续性,可在响应结果中获取conversation_id
可选
end_user_id
string
终端用户ID,长度为6-64字符。若需完整启用记忆功能,end_user_id为必填项
可选
stream
boolean
是否开启流式输出。true: 开启流式输出false: 关闭流式输出
可选
请求结构
POST /v2/agent/ai_assistant/run HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"query": "你好,请详细介绍一下圣诞节的习俗",
"conversation_id": "1f3b84c5-****-****-b9a9-2bd507457c28",
"end_user_id": "user_123456",
"stream": false
}
示例代码
基础调用
curl -X POST 'https://qianfan.baidubce.com/v2/agent/ai_assistant/run' \
-H 'Authorization: Bearer <API Key>' \
-H 'Content-Type: application/json' \
-d '{
"query": "你好,请详细介绍一下圣诞节的习俗",
"conversation_id": "1f3b84c5-****-****-b9a9-2bd507457c28",
"stream": false
}'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
response
oneOf {2}
多选一且必需“只能”符合其中一个
可选
显示子属性
隐藏子属性
response
object {6}
成功响应格式
显示子属性
隐藏子属性
trace_id
string
正确响应的唯一标识ID
可选
conversation_id
string
对话ID,有效期7天,可用于后续对话的入参
可选
status
string
当前对话状态。preparing: 准备中running: 运行中done: 完成error: 出现错误
可选
role
string
消息角色。tool: 工具assistant: 助手
可选
content
array
输出内容
可选
显示子属性
隐藏子属性
items
object {4}
显示子属性
隐藏子属性
name
string
消息业务模块标识。reasoning: 思考内容summary: 正文内容
可选
metrics
object
指标数据对象
可选
显示子属性
隐藏子属性
type
string
消息内容类型。目前仅支持固定值:text
可选
text
object {1}
可选
显示子属性
隐藏子属性
info
string
响应文本内容
可选
message_id
string
消息ID
可选
response
object {3}
错误响应格式
显示子属性
隐藏子属性
code
string
错误码标识
可选
message
string
具体的错误描述信息
可选
request_id
string
请求ID,用于错误追踪
可选
json
{
"trace_id": "7085b0a3-0d9e-4a80-a7c7-6d6018507cfb",
"role": "assistant",
"conversation_id": "1f3b84c5-959f-45bd-b9a9-2bd507457c28",
"status": "done",
"content": [
{
"name": "summary",
"type": "text",
"text": {
"info": "**核心结论** \n圣诞节是纪念耶稣诞生的宗教节日,全球常见习俗包括**装饰圣诞树**、**互赠礼物**、**家庭聚餐**,部分地区有**平安夜吃苹果**或**唱颂歌**等本土化传统。\n\n**详细解析** \n### 全球普遍习俗 \n圣诞节的核心传统源于基督教文化,并在现代演变为跨文化的节日活动,其共同点体现为象征希望、团聚与馈赠。 \n- **圣诞树装饰**:使用常青树(如松树、冷杉)悬挂彩灯、彩球和星饰,象征生命与光明。 \n- **礼物交换**:源于圣尼古拉斯传说,现代演变为家人朋友间互赠礼物,常将礼物置于圣诞树下或袜中。 \n- **家庭聚餐**:西方国家以烤火鸡、火腿为主菜,搭配圣诞布丁,强调家人团聚,类似春节年夜饭。 \n- **宗教仪式**:平安夜参加教堂弥撒或颂歌活动,是许多基督徒的重要传统。 \n\n \n\n### 地域特色习俗 \n不同地区融合本土文化,形成独特庆祝方式,体现节日的多样性与适应性。 \n- **中国**:流行\"平安夜送苹果\",取\"苹\"与\"平\"谐音,祈求平安;城市中商业化氛围浓厚,侧重购物与聚会。 \n- **意大利**:平安夜遵循\"Di Magro\"传统,食用海鲜而非红肉,搭配特伦托起泡酒。 \n- **瑞典**:从12月初开始点\"降临节蜡烛\",饮用热红酒(Glögg),食用藏红花面包(lussekatter)。 \n- **墨西哥**:举行\"Las Posadas\"九日游行,重现圣母寻宿故事,最后以砸皮纳塔(彩罐)分糖果收尾。 \n- **巴西**:因属夏季,圣诞老人穿短袖,庆祝常延伸至海滩烧烤,主菜为火鸡配热带水果。 \n- **德国**:12月6日庆祝\"圣尼古拉斯节\",孩子清晨在鞋中发现坚果、橘子或巧克力。 \n\n![圣诞老人在巴西]() \n\n**总结** \n圣诞节的习俗融合了**宗教传统**、**地域文化**与**现代消费**,无论在西方还是亚洲,其核心始终围绕**团聚、馈赠与希望**展开。"
}
}
],
"message_id": "4a71cb83-7024-4edd-a8a8-68bb6ef1280f"
}
json
{
"code": "InvalidParameter",
"message": "请求参数错误",
"request_id": "req-1234567890"
}
