AI助手对话
更新时间:2026-01-06
GET
https://qianfan.baidubce.com/v2/agent/ai_assistant/run
与AI助手进行对话交互
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
Body 参数
query
string
输入的对话信息。
用于向AI助手提出问题或发起对话的文本内容。
必选
end_user_id
string
终端用户ID,长度为6 - 64字符。
若需完整启用记忆功能,end_user_id 为必填项。用于标识终端用户,实现对话上下文记忆和个性化功能。
可选
conversation_id
string
对话ID。
用于标识和延续特定的对话会话,传入已有对话ID可继续历史对话。
可选
stream
boolean
是否开启流式输出,默认开启。true:开启流式输出,实时返回生成内容false:关闭流式输出,等待完整响应后一次性返回
可选
请求结构
GET /v2/agent/ai_assistant/run HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"query": "圣诞节有什么习俗?",
"end_user_id": "",
"conversation_id": "",
"stream": false
}
示例代码
与AI助手进行非流式对话交互的基础示例
curl -X GET "https://qianfan.baidubce.com/v2/agent/ai_assistant/run" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"query": "圣诞节有什么习俗?",
"stream": false
}'
{
"query": "圣诞节有什么习俗?",
"stream": false
}
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
trace_id
string
请求追踪ID。
用于标识和追踪本次API调用请求的唯一标识符。
可选
conversation_id
string
对话ID。
标识当前对话会话的唯一标识符,可用于后续继续该对话。
可选
status
string
对话状态。
表示AI助手对话处理的当前状态。done:对话处理完成
可选
role
string
角色类型。
表示响应内容的角色身份。assistant:AI助手
可选
content
array
内容数组。
包含AI助手返回的各类内容块,如摘要、文本等多种形式的响应内容。
可选
显示子属性
隐藏子属性
items
object {4}
显示子属性
隐藏子属性
name
string
内容块名称。
标识内容块的类型,如 summary 表示摘要内容。
可选
type
string
内容类型。
标识内容的格式类型。text:文本类型
可选
text
object {1}
文本内容对象。
包含AI助手生成的具体文本信息。
可选
显示子属性
隐藏子属性
info
string
文本信息。
包含AI助手生成的完整回复内容,支持Markdown格式。
可选
metrics
object
指标信息。
包含与该内容块相关的统计或性能指标数据。
可选
显示子属性
隐藏子属性
message_id
string
消息ID。
标识本次对话消息的唯一标识符,用于消息追踪和管理。
可选
非流式对话成功返回的完整响应示例
成功响应
{
"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"
}
