联网问答Agent
联网问答Agent
文档指南
请输入
- 文档首页
联网问答AgentAPI参考智能体会话API
复制全文
下载 pdf智能体会话API
文档反馈
问问助手本文档介绍智能体会话API接口的输入输出参数。调用该接口可获取智能体的大模型回复、参考资料、富媒体卡片数据，实现追问、引用角标、图文混排、百科划线词等高级产品功能。
接口限流：火山账号维度，默认300 RPM。
认证方式
接口详情
智能体会话
URL
请求体ChatCompletionRequest
Message
LocationInfo
NavigationInfo
ExtensionOptions
响应体ChatCompletionResponse
Choice
Reference
FollowUp
TokenUsage
Card
通过请求体card_position参数可控制出卡位置，流式默认只在首帧出
ValueAddSignal
请求示例
{
"bot_id": "7429717161499017747",
"stream": false,
"messages": [
{
"role": "system",
"content": "你是智能语音助手,你的名字是韩梅梅，请用普通话回复用户。" //Systemprompt
},
{
"Role": "user",
"content": "周杰伦有什么歌" //上下文
},
{
"Role": "assistant",
"content": "周杰伦唱过《稻香》《叶惠美》《东风破》《菊花台》"
},
{
"Role": "user",
"content": "荣耀手机的最新动态" //当前问题
}
],
"user_id": "hq53qh6683",
"knowledge":"当前正在驾驶问界M8增程MAX版，车内正在播放音乐《天黑黑》",
"location_info":{
"province": "陕西省",
"city": "西安市",
"district": "未央区",
"town": "玄武路",
"longitude": 108.962354,
"latitude": 34.303007
},
"navigation_info": {
"destination": {
"province": "",
"city": "北京市",
"district": "丰台区",
"town": "",
"longitude": 116.378517,
"latitude": 39.865246
},
"via": [
{
"province": "",
"city": "北京市",
"district": "海淀区",
"town": "",
"longitude": 116.313226,
"latitude": 39.970598
},
{
"province": "",
"city": "北京市",
"district": "海淀区",
"town": "",
"longitude": 116.337742,
"latitude": 39.992894
}
]
}
}
响应示例
非流式响应
{
"id": "2025090814282017E9375ADE2F13A69656",
"object": "chat.completion",
"choices": [
{
"delta": null,
"message": {
"role": "assistant",
"content": "### 荣耀手机最新动态汇总 \n\n#### **一、即将发布的重磅新品** \n- **荣耀Magic8系列**： \n 预计**9月底发布，10月开售**，包含标准版、Pro版、Mini版及Ultra版。 \n - **核心配置**：标准版与Pro版搭载**骁龙8至尊版第二代**芯片，Mini版或采用天玑9500芯片；全系配备潜望长焦镜头（Pro版或为2亿像素）、3D人脸识别+超声波指纹，以及近7000mAh超大电池，支持100W有线+80W无线快充。 \n - **创新亮点**：*******仅做格式示例，后续篇幅省略*******",
"tool_calls": null
},
"finish_reason": "stop",
"index": 0
}
],
"created": 1757312920,
"references": [
{
"id": "3d6c1693e1a00187-69168884de3550bd",
"source_type": "search_engine",
"site_name": "搜索引擎",
"title": "荣耀Magic7系列",
"publish_time": 1757007498,
"url": "******",
"cover_image": null,
"logo_url": ""
},
{
"id": "********",
"source_type": "douyin_video",
"site_name": "抖音视频",
"title": "#荣耀Magic8 配置参数曝光，预计9月底发布，10月开售，这次发布会能不能喝上新任CEO#荣耀李健 的瑞幸就看大家了。\n标准版和pro版都是用的骁龙8至尊版第二代，顶满了！剩下大家悄眯眯去我视频里截图。#荣耀magic8pro #荣耀新品发布会 #荣耀Magic",
"publish_time": 1756959049,
"url": "******",
"cover_image": {
"url": "******",
"width": 540,
"height": 960
},
"logo_url": ""
}
],
"follow_ups": [
{
"item": "荣耀Magic8系列发布时间"
},
{
"item": "MagicOS10.0 Beta推送机型"
},
{
"item": "荣耀Magic V Flip2价格配置"
}
],
"usage": {
"prompt_tokens": 6673,
"completion_tokens": 854,
"total_tokens": 7527
},
"cards": [
{
"card_type": "video",
"video_card": {
"id": "******",
"source_type": "douyin_video",
"site_name": "抖音视频",
"title": "#荣耀Magic8 配置参数曝光，预计9月底发布，10月开售，这次发布会能不能喝上新任CEO#荣耀李健 的瑞幸就看大家了。\n标准版和pro版都是用的骁龙8至尊版第二代，顶满了！剩下大家悄眯眯去我视频里截图。#荣耀magic8pro #荣耀新品发布会 #荣耀Magic",
"cover_image": {
"url": "******",
"width": 540,
"height": 960
},
"url": "******",
"width": 0,
"height": 0,
"duration": 27981,
"author_name": "荣耀-阿黄（肖战版）"
}
}
]
}
流式响应
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"###","tool_calls":null},"message":null,"finish_reason":"","index":0}],"created":1757303697,"references":[{"id":"68af2f737024280b-08c63c890a7eb2a0","source_type":"search_engine","site_name":"搜索引擎","title":"一张照片，一种对话。与HONOR Magic Moments荣耀手机影像计划全球评委 探寻心中的火花","publish_time":1656259200,"url":"******","cover_image":null,"logo_url":""},{"id":"******","source_type":"douyin_video","site_name":"抖音视频","title":"#荣耀Magic8 配置参数曝光，预计9月底发布，10月开售，这次发布会能不能喝上新任CEO#荣耀李健 的瑞幸就看大家了。\n标准版和pro版都是用的骁龙8至尊版第二代，顶满了！剩下大家悄眯眯去我视频里截图。#荣耀magic8pro #荣耀新品发布会 #荣耀Magic","publish_time":1756959049,"url":"******","cover_image":{"url":"******","width":540,"height":960},"logo_url":""}],"cards":[{"card_type":"video","video_card":{"id":"******","source_type":"douyin_video","site_name":"抖音视频","title":"#荣耀Magic8 配置参数曝光，预计9月底发布，10月开售，这次发布会能不能喝上新任CEO#荣耀李健 的瑞幸就看大家了。\n标准版和pro版都是用的骁龙8至尊版第二代，顶满了！剩下大家悄眯眯去我视频里截图。#荣耀magic8pro #荣耀新品发布会 #荣耀Magic","cover_image":{"url":"xxxxxx","width":540,"height":960},"url":"******","width":0,"height":0,"duration":27981,"author_name":"荣耀-阿黄（肖战版）"}}]}
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":" ","tool_calls":null},"message":null,"finish_reason":"","index":0}],"created":1757303697,"references":null}
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"荣耀","tool_calls":null},"message":null,"finish_reason":"","index":0}],"created":1757303697,"references":null}
...
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"评测","tool_calls":null},"message":null,"finish_reason":"","index":0}],"created":1757303711,"references":null}
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"。","tool_calls":null},"message":null,"finish_reason":"","index":0}],"created":1757303711,"references":null}
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"","tool_calls":null},"message":null,"finish_reason":"stop","index":0}],"created":1757303711,"references":null}
data:{"id":"202509081154548C7A7C13029EFAA557D1","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant","content":"","tool_calls":null},"message":null,"finish_reason":"","index":0}],"created":1757303711,"references":null,"follow_ups":[{"item":"荣耀Magic8系列发布时间"},{"item":"MagicOS 10.0 Beta推送机型"},{"item":"荣耀IPO进程最新进展"}],"usage":{"prompt_tokens":6211,"completion_tokens":708,"total_tokens":6919}}
data:[DONE]
流式响应帧类型说明
高级功能
引用角标
说明：在总结输出中插入引用标记，指示文本来源于哪个参考资料
格式：[ref_x]，其中 x 为参考资料的编号
生效场景：流式输出、非流式输出
开启方法：控制台开启开关
注意事项：
- 客户端可根据需要自定义处理引用角标的展示效果
图文/视频混排
说明：在输出内容中穿插图片，以Markdown格式呈现
生效场景：仅支持流式输出
开启方法：控制台开启开关
输出格式：
- 文本内容以常规方式输出
- 图片以Markdown语法输出：
- 图片/视频信息会作为独立帧返回
- 混排帧会包含图片的元数据在 delta.image_info 中，字段如下：
- 如果需要渲染多图的客户，全量图片信息的元数据在delta.image_infos 中，字段类型为image_info的数组，详情见下方数据参考
- 视频元数据在delta.video_infos中，字段类型为video_info的数组，详情见下方参考
- video_info字段
注意事项：
- 支持Markdown渲染的客户端无需特殊处理
返回数据参考：
// 普通文本帧
{
"id": "202503121053195DDBF4E949D2ECF224C4",
"object": "chat.completion.chunk",
"choices": [
{
"delta": {
"role": "assistant",
"content": "餐厅",
"tool_calls": null
},
"message": null,
"finish_reason": "",
"index": 0
}
],
"created": 1741748005,
"references": null
}
// 图片插入帧
{
"id": "202503121053195DDBF4E949D2ECF224C4",
"object": "chat.completion.chunk",
"choices": [
{
"delta": {
"role": "assistant",
"content": "\n\n",
"tool_calls": null,
"image_info": {
"width": 400,
"height": 300,
"image_url": "https://p3-search.byteimg.com/obj/tos-cn-i-qvj2lq49k0/1d9ee205d9554cc9bd4a473d2a33eeea",
"source_url": "https://m.toutiao.com/11111111",
},
"image_infos": [
{
"width": 493,
"height": 446,
"image_url": "https://p26-volcsearch-sign.byteimg.com/tos-cn-i-xstd03g9pf/5ff9df98cb194889a96fa1df460318fc~tplv-obj.jpeg?lk3s=1515c32d&scene=volc_search&x-expires=1770641380&x-signature=VKK3bPyePnzOwfmSwIMk8%2Fpbdds%3D",
"source_url": "https://m.toutiao.com/11111111"
},
{
"width": 1280,
"height": 960,
"image_url": "https://p3-volcsearch-sign.byteimg.com/tos-cn-i-xv4ileqgde/e7070219833247138eea9ba12dd985e1~tplv-obj.jpeg?lk3s=1515c32d&scene=volc_search&x-expires=1770641366&x-signature=hVin4I75O0uHhe6sj15CTVE7SlQ%3D",
"source_url": "https://m.toutiao.com/11111111"
},
{
"width": 1280,
"height": 960,
"image_url": "https://p3-volcsearch-sign.byteimg.com/tos-cn-i-xv4ileqgde/e7070219833247138eea9ba12dd985e1~tplv-obj.jpeg?lk3s=1515c32d&scene=volc_search&x-expires=1770641369&x-signature=wvc4a0dsKIT%2F6tnjxBkM687Ps84%3D",
"source_url": "https://m.toutiao.com/11111111"
}
]
},
"message": null,
"finish_reason": "",
"index": 0
}
],
"created": 1741748006,
"references": null
}
百科划线词
说明：在输出内容中，将自动识别百科词条并以下划线超链接形式在总结中呈现
生效场景：仅支持联网问答pro文搜/图搜流式输出
开启方法：控制台开启开关
输出格式：
- 下划线词条以Markdown语法输出： [百科词条名](百科url)
注意事项：
- 支持Markdown渲染的客户端无需特殊处理
返回数据参考：
// 普通文本帧
{
"id": "202503121053195DDBF4E949D2ECF224C4",
"object": "chat.completion.chunk",
"choices": [
{
"delta": {
"role": "assistant",
"content": "餐厅",
"tool_calls": null
},
"message": null,
"finish_reason": "",
"index": 0
}
],
"created": 1741748005,
"references": null
}
// 百科划线词帧
{
"id": "202503121053195DDBF4E949D2ECF224C4",
"object": "chat.completion.chunk",
"choices": [
{
"delta": {
"role": "assistant",
"content": "[黑海](https://open.toutiao.com/article/url/?param=2v5e9zftZJNoZpWrngDvc2q5DSn3MhQSpNNyscfvpTU5JvxB3z74LP27mDnuEibEB1GbxWhav3dBqff8Uw57LXayNoAFWDaazMZJYYYnQR7rGQeo8BUjP96FwxGPhUhVgrqBrY1GB6K7XbzRK8TACMaUBybrBexh1ZzHcvZD3hteAx7n9x8PyBDhYdi2pTAdkhtVXBjbvN2hToDp331HDLfKp6QxCJEb2QgvkxgiT99VGusAiT&partner=agent_bot_7545058342901745178_default_content&version=3)",
"tool_calls": null
},
"message": null,
"finish_reason": "",
"index": 0
}
],
"created": 1741748006,
"references": null
}
输出关键执行过程
说明：执行过程中输出关键执行过程，提升端上交互效果
开启方法：详情见请求体ChatCompletionRequest-ExtensionOptions-enable_processing_state
过程范围和帧类型：
返回数据参考：
{
"id": "202503271640468507AA4C950F0039CEA0",
"object": "chat.completion.chunk",
"choices": [
{
"delta": {
"role": "assistant",
"content": "",
"tool_calls": null, "processing_state": { "action": "planning", "description": "正在理解问题" }
},
"message": null,
"finish_reason": "",
"index": 0
}
],
"created": 1743064848,
"references": null
}
错误处理
错误码
网关错误：
此接口基于火山引擎TOP网关发布，如果遇到网关层报错（例如验签错误），我们将返回火山引擎TOP网关错误，响应格式如下：
{
"ResponseMetadata": {
"RequestId": "202210271151020102121450321B8D2A21",
"Action": "ScanSyncArticles",
"Version": "2023-01-01",
"Service": "volc_torchlight_api",
"Region": "cn-north-1",
"Error": {
"CodeN": 100010,
"Code": "SignatureDoesNotMatch",
"Message": "The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details."
}
}
}
业务错误：
{
"error": {
"log_id": "错误logid",
"message": "错误的详细描述信息",
"type": "错误类型",
"code": "具体错误代码",
"param": "可选，导致错误的参数名称"
}
}
当流式输出过程中出现错误时，错误信息将在以 data: 开头的数据块中返回。字段解释如下：
错误响应
// 认证错误
{
"error": {
"log_id": "错误logid",
"code": "invalid_api_key",
"message": "invalid api key",
"type": "authentication_error",
"param": null
}
}
// 请求参数错误
{
"error": {
"log_id": "错误logid",
"code": "invalid_parameter",
"message": "stream requires bool type",
"type": "validation_error",
"param": "stream"
}
}
使用说明
图片格式说明
支持的图片格式如下表。
图片格式 | 文件扩展名 | 内容格式（Content Type） |
JPEG | .jpg, .jpeg | image/jpeg |
PNG | .png | image/png |
GIF | .gif | image/gif |
WEBP | .webp | image/webp |
BMP | .bmp | image/bmp |
TIFF | .tiff, .tif | image/tiff |
HEIC | .heic | image/heic |
HEIF | .heif | image/heif |
调用示例
Python调用示例
前提条件
调用之前，您需要获取以下信息：
- bot_id: 控制台上创建的bot id，可参考联网问答Agent操作指南
- 鉴权信息（任选一种即可，获取方式请参考本文档认证方式章节）：
- AccessKey、SecretKey
- APIKey
Python环境
- Python：3.9版本及以上。
- Pip：25.1.1版本及以上。
下载代码示例
安装依赖
解压代码包，进入代码包根目录后安装依赖。
cd askecho_demo
pip3 install -r requirements.txt
运行代码
APIKey接入
bot_id替换为您的bot_id，api_key替换为您的APIKey
python3 chat_completion_apikey.py --bot_id <bot_id> --api_key <api_key>
火山引擎TOP网关接入
bot_id替换为您的bot_id，access_key、secret_key替换为您的AccessKey和SecretKey
python3 chat_completion_aksk.py --bot_id <bot_id> --access_key <access_key> --secret_key <secret_key>
Java调用示例
前提条件
调用之前，您需要获取以下信息：
- bot_id: 控制台上创建的bot id，可参考联网问答Agent操作指南
- 鉴权信息（任选一种即可，获取方式请参考本文档认证方式章节）：
- AccessKey、SecretKey
- APIKey
Java环境
- Java：21版本及以上。
- Maven：3.9.10版本及以上。
下载代码示例
解压代码
解压代码包，进入代码包根目录。
cd AskechoDemo
运行代码
APIKey接入
botId替换为您的botId，apiKey替换为您的APIKey
mvn compile exec:java -Dexec.mainClass=com.askecho.ChatCompletionApiKey -DbotId=<botId> -DapiKey=<apiKey>
火山引擎TOP网关接入
botId替换为您的botId，accessKey、secretKey替换为您的AccessKey和SecretKey
mvn compile exec:java -Dexec.mainClass=com.askecho.ChatCompletionAKSK -DbotId=<botId> -DaccessKey=<accessKey> -DsecretKey=<secretKey>
Postman调用示例
使用APIKey直接通过Postman进行接口调用，实际参数替换为您的APIKey与botId。
curl --location 'https://open.feedcoopapi.com/agent_api/agent/chat/completion' \
--header 'Authorization: Bearer APIkey' \
--header 'Content-Type: application/json' \
--header 'ServiceName: ask_echo' \
--data '{
"bot_id": "botId",
"messages": [
{
"role": "user",
"content": "推荐一些好看的电影"
}
],
"stream": true
}'
最近更新时间：2026.09.22 16:19:43
这个页面对您有帮助吗？
有用
有用
无用
无用