更新会话--数据智能体-火山引擎

文档中心

立即注册

数据智能体

智能问数（新版）

更新会话

请求说明

请求方式：POST
请求地址：/dataAgent/llm/openApi/v2/signed/agent/updateSession
Content-Type：application/json

请求参数

Body参数如下。

参数	类型	是否必选	示例值	描述
agentId	int	是	555327	智能体ID，智能体ID的获取方式请参见agentId。
appId	int	是	17368	DataWind项目ID，没有与DataWind联合部署使用的场景可填`0`。
sessionId	int	是	11469472	会话ID，创建会话时返回结果的sessionInfo中会返回会话ID，详情请参见创建会话 - 副本。
payload	object	否	参见下文请求示例	标识请求来源，默认是openapi
payload.name	string	否	参见下文请求示例	会话名称，只截取前128字符

请求示例

{
    "appId": 555327,
    "agentId": 17368,
    "sessionId": 11469472,
    "payload": {
        "name": "对昨天使用大模型使用情况按一级场景进行分组分析各场景UV"
    }
}

返回参数

返回结果data中主要包含创建好的会话相关参数（sessionInfo），参数详细说明如下。

参数	类型	示例值	描述
sessionInfo.createTime	string	2025-09-04 13:51:10	session创建时间，日期格式：yyyy-MM-dd HH:mm:ss
sessionInfo.emailPrefix	string	admin	session创建者的账号名称，即火山引擎账号ID。
sessionInfo.id	int	12886164	创建好的会话ID（session id），您可记录好会话ID，后续获取会话信息、获取对话结果等接口需使用会话ID。
sessionInfo.isExpired	boolean	false	会话是否过期，会话创建后超过24小时为过期。
sessionInfo.lastActiveTime	string	2025-10-24 16:03:54	session最新活跃时间，日期格式：yyyy-MM-dd HH:mm:ss
sessionInfo.name	string	新的会话	会话名称。

返回示例

{
    "JSONIFY_PRETTYPRINT_REGULAR": false,
    "code": "llm/ok",
    "data": {
        "sessionInfo": {
            "createTime": "2025-09-04 13:51:10",
            "emailPrefix": "admin",
            "id": 11469472,
            "isExpired": false,
            "lastActiveTime": "2025-09-04 13:51:10",
            "name": "对昨天使用大模型使用情况按一级场景进行分组分析各场景UV"
        }
    }
}

最近更新时间：2025.12.16 15:25:21

这个页面对您有帮助吗？

有用

无用