文档中心

E-MapReduce

EMR Agent API参考

GetChat - 查询会话

获取指定会话详情。

请求参数

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

Action string 必选示例值：GetChat

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

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

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

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

会话 ID。用于获取指定会话详情，可通过 CreateChat 返回或 ListChats 查询获取。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

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

会话 ID。

Name string 示例值：请帮我诊断该作业

会话名称。

Verbose boolean 示例值：true

是否开启深度分析。

OnlineSearchEnabled boolean 示例值：true

是否开启联网搜索。

UserId string 示例值：2100000000

账号 ID。

SubAccountId string 示例值：2100000001

子用户 ID。

History object[] 示例值：详见以下参数示例

会话历史消息列表。

Role string 示例值：user

消息角色。

Content string 示例值：{...}

消息内容；助手消息中的复杂内容以 JSON 字符串形式返回。

MessageId string 示例值：message_********-****-****-****-************

消息 ID。

IsLike boolean 示例值：true

是否点赞；为空表示未反馈。

LastActive string 示例值：2026-08-10T12:00:00

最近活跃时间，格式为 ISO 8601 日期时间字符串。

Status string 示例值：active

会话状态，可选["active","deleted"]。

CreatedAt string 示例值：2026-08-10T12:00:00

创建时间，格式为 ISO 8601 日期时间字符串。

请求示例

POST /?Action=GetChat&Version=2025-10-15 HTTP/1.1​
Host: emr.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260818T125718Z​
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​
​
{​
  "ChatId": "session_********-****-****-****-************"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202608182057210341701012209BBCA8",​
    "Action": "GetChat",​
    "Version": "2025-10-15",​
    "Service": "emr",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "ChatId": "session_********-****-****-****-************",​
    "Name": "请帮我诊断该作业",​
    "Verbose": true,​
    "OnlineSearchEnabled": true,​
    "UserId": "2100000000",​
    "SubAccountId": "2100000001",​
    "History": [],​
    "LastActive": "2026-08-10T12:00:00",​
    "Status": "active",​
    "CreatedAt": "2026-08-10T12:00:00"​
  }​
}​

错误码

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

状态码	错误码	错误信息	说明
404	7001	会话不存在错误	会话不存在。
500	1000	未知异常	未知异常。
500	7004	获取会话错误	获取会话失败。

最近更新时间：2026.08.20 20:18:39

这个页面对您有帮助吗？

有用

无用