EMR Agent 流式会话接口，用于发起问答、知识咨询、作业诊断、服务诊断、集群诊断等会话请求。 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **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` 事件返回。 |恢复会话过期 | ## 请求示例 ```text 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_********-****-****-****-************" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "202608182058000201851160097FF2E5", "Action": "ChatCompletions", "Version": "2025-10-15", "Service": "emr", "Region": "cn-beijing" }, "Result": {} } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |7025 |恢复会话过期 |恢复会话已过期。 | |403 |4006 |抱歉，您没有该账号下资源的访问权限 |没有该账号下资源的访问权限。 | |403 |9010 |服务未开通 |服务未开通。 | |500 |1000 |未知异常 |未知异常。 |

E-MapReduce