文档中心

E-MapReduce

EMR Agent API参考

ChatCompletions - 流式会话

EMR Agent 流式会话接口，用于发起问答、知识咨询、作业诊断、服务诊断、集群诊断等会话请求。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ChatCompletions

要执行的操作，取值：ChatCompletions。

Version string 必选示例值：2025-10-15

API的版本，取值：2025-10-15。

Content string 必选示例值：请帮我分析当前作业失败原因

用户输入的问题或指令。

ChatId string 可选示例值：session_********-****-****-****-************

会话 ID。传入已有会话 ID 时继续该会话；传入不存在的会话 ID 时使用该 ID 创建新会话；不传时自动创建新会话。已有会话 ID 可通过 CreateChat 返回或 ListChats 查询获取。

OnlineSearchEnabled boolean 可选示例值：true

是否开启联网搜索。不传时使用会话设置。

Verbose boolean 可选示例值：true

是否开启深度分析。不传时使用会话设置。

返回参数

本接口为 SSE 流式接口，响应内容不是单个 JSON 对象。服务端会通过 text/event-stream 持续返回事件，每条事件格式为 data: {JSON事件对象}\n\n。当一段时间内暂无新事件时，服务端可能返回 : keep-alive\n\n 作为心跳。

响应头：

参数	类型	描述	示例值
X-Task-Id	String	任务 ID，用于断点续传。断点续传时，将该值作为请求头 X-Resume-Task-Id 传入。	session_****

SSE 事件参数：

参数	类型	描述	示例值
type	String	事件类型。常见取值包括 RUN_STARTED、RUN_FINISHED、RUN_ERROR、STEP_STARTED、STEP_FINISHED、TEXT_MESSAGE_START、TEXT_MESSAGE_CONTENT、TEXT_MESSAGE_END、CUSTOM、ARTIFACT_START、ARTIFACT_CONTENT、ARTIFACT_END。	TEXT_MESSAGE_CONTENT
threadId	String	会话 ID。	session_****
runId	String	本次运行 ID，通常对应本轮问答的消息 ID。	message_****
timestamp	Integer	事件发生时间，Unix 毫秒时间戳。	1787227200000
stepId	String	步骤 ID。仅步骤事件、部分消息事件或产物事件返回。	step_****
messageId	String	消息 ID。仅消息事件或自定义事件返回。	message_****
name	String	事件名称。用于标识消息、自定义事件或步骤名称。	助手回答
description	String	事件描述。部分事件返回。	诊断开始
delta	String / Object	事件增量内容。文本消息事件中为文本片段；自定义事件中为自定义数据；产物事件中为文件或报告产物信息。	诊断结果片段
external	Object	扩展信息。不同事件类型返回的内容不同，例如推理标识、引用信息、报告 ID 等。
total_token	Integer	本轮对话消耗的总 Token 数。仅 RUN_FINISHED 事件返回。	6133
stepStatus	String	步骤执行状态。仅 STEP_FINISHED 事件返回，可选值包括 Processing、Success、Error。	Success
error	Integer	错误码。仅 RUN_ERROR 事件返回。	7025
message	String	错误信息。仅 RUN_ERROR 事件返回。	恢复会话过期

请求示例

POST /?Action=ChatCompletions&Version=2025-10-15 HTTP/1.1​
Host: emr.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260818T125756Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260818/cn-beijing/emr/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "Content": "请帮我分析当前作业失败原因",​
  "ChatId": "session_********-****-****-****-************"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202608182058000201851160097FF2E5",​
    "Action": "ChatCompletions",​
    "Version": "2025-10-15",​
    "Service": "emr",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	7025	恢复会话过期	恢复会话已过期。
403	4006	抱歉，您没有该账号下资源的访问权限	没有该账号下资源的访问权限。
403	9010	服务未开通	服务未开通。
500	1000	未知异常	未知异常。

最近更新时间：2026.08.20 21:03:17

这个页面对您有帮助吗？

有用

无用