助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
工作流
应用
资源
发布
模型
多人协作
开发工具
Coze CLI
SDK 参考
音视频
推广与变现

通过对话接口获取智能体回复

更新于: 2026-06-25 19:29:14

获取智能体回复

调用对话接口后,服务端会处理请求并生成智能体回复。你可以通过以下方式获取智能体的回复详情。

获取方式

说明

通过流式响应实时显示智能体回复

如果客户端中需要打字机效果实时增量显示智能体回复,可以在调用发起对话接口时,设置流式响应(stream=true),并在客户端对话框中实时打印接口响应中的模型回复部分。
该场景下,客户端需要自行拼接响应内容。

仅解析流式响应的智能体回复部分

如果不需要增量流式显示智能体回复,只需要快速获取最终结果,可以在调用发起对话接口时,设置流式响应(stream=true),并在 Response 中,在事件 event:conversation.message.completed中,取 type=answer 的事件,例如以下事件中,content 部分为智能体回复。

event:conversation.message.completed
data:{"id":"738215949412347****","conversation_id":"738147352534297****","bot_id":"737946218936519****","role":"assistant","type":"answer","content":"2024 年 10 月 1 日是星期三。","content_type":"text","chat_id":"738215948713169****"}

对话结束后,事件 event:conversation.message.completed 中可能有多种消息类型,你可以按需解析。常见的消息类型可参考消息示例

通过非流式响应主动查询智能体回复

你也可以参考以下流程主动查询智能体回复。

  1. 调用发起会话接口,并设置 stream = false,auto_save_history=true,表示使用非流式响应,并记录历史消息。
    你需要记录会话的 Conversation ID 和 Chat ID,用于后续查看详细信息。
  2. 定期轮询查看对话详情接口,建议每次间隔 1 秒以上,直到会话状态流转为终态,即 status 为 completed 或 required_action。
  3. 调用查看对话消息详情接口,查询模型生成的最终结果。

Image

消息示例

  • 文本格式智能体回复
    data 字段中,type=answer,且 content_type=text 的消息为文本格式的智能体回复。示例如下:

    event:conversation.message.completed
    data:{"id":"739002977785765****","conversation_id":"739002976985482****","bot_id":"732868101392695****","role":"assistant","type":"answer","content":"xxxx","content_type":"text","chat_id":"7390029769854844****"}
    
  • 卡片消息
    data 字段中,type=answer,且 content_type=card 的消息为卡片格式的智能体回复。示例如下:

    event:conversation.message.completed
    data:{"id":"73900297849082****","conversation_id":"7390029769854828****","bot_id":"732868101392695****","role":"assistant","type":"answer","content":"{\"card_type\":3,\"template_url\":\"xxx ....\"response_type\":\"card\"}","content_type":"card","chat_id":"739002976985484****"}
    
  • 知识库召回
    data 字段中,type=verbose,且 content.msg_type = knowledge_recall 的消息为知识库召回的消息。示例如下:

    event:conversation.message.completed
    data:{"id":"739002976985487****","conversation_id":"7390029769854828582","bot_id":"732868101392695****","role":"assistant","type":"verbose","content":"{\"msg_type\":\"knowledge_recall\",\"data\":\"xxxx\"}","content_type":"text","chat_id":"739002976985484****"}
    
  • 函数调用(Function call)
    data 字段中,type=function_call 的消息为函数调用的结果。示例如下:

    event:conversation.message.completed
    data:{"id":"739002977785767****","conversation_id":"739002976985482****","bot_id":"732868101392695****","role":"assistant","type":"function_call","content":"{\"name\":\"toutiaosousuo-search\",\"arguments\":{\"input_query\":\"B 站的热搜\"},\"plugin_id\":72811926238875****3,\"plugin_name\":\"toutiaosousuo\",\"api_id\":7288907006982012986,\"api_name\":\"search\",\"plugin_type\":1,\"thought\":\"需求为搜索 B 站的热搜并搜索这些热搜最新的动态新闻。第一步需要调用toutiaosousuo-search工具搜索 B 站的热搜\"}","content_type":"text","chat_id":"73900297698548****"}
    
  • 工具调用(tool_response)
    data 字段中,type=tool_response 的消息为工具调用的结果。示例如下:

    event:conversation.message.completed
    data:{"id":"739002978490818****","conversation_id":"739002976985482****","bot_id":"732868101392695****","role":"assistant","type":"tool_response","content":"xxx","content_type":"card","chat_id":"739002976985484****"}
    
  • 结束生成标识
    data 字段中,type=verbose,且 content.msg_type = generate_answer_finish 的消息为模型生成结束的标识。示例如下:

    event:conversation.message.completed
    data:{"id":"739002981382787****","conversation_id":"739002976985482****","bot_id":"732868101392695****","role":"assistant","type":"verbose","content":"{\"msg_type\":\"generate_answer_finish\",\"data\":\"{\\\"finish_reason\\\":0}\",\"from_module\":null,\"from_unit\":null}","content_type":"text","chat_id":"739002976985484****"}
    
  • 推荐
    data 字段中,type=follow_up 的消息为智能体的用户问题建议。示例如下:

    event:conversation.message.completed
    data:{"id":"739002981382791****","conversation_id":"739002976985482****","bot_id":"732868101392695****","role":"assistant","type":"follow_up","content":"总结一下B站崩了的具体情况","content_type":"text","chat_id":"739002976985484****"}