创建会话--数据智能体 DataAgent（私有化）-火山引擎

文档中心

立即注册

数据智能体 DataAgent（私有化）

智能问数（新版）

创建会话

请求说明

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

请求参数

Body参数如下。

参数	类型	是否必选	示例值	描述
agentId	int	是	123	智能体ID，智能体ID的获取方式请参见agentId。
appId	int	是	123**4	DataWind项目ID，没有与DataWind联合部署使用的场景可填`0`。
sessionType	string	否(默认为normal)	normal	创建的会话类型，支持的枚举值： normal：智能问数 deep_research：深度分析

参数

类型

是否必选

示例值

描述

agentId

int

是

123

智能体ID，智能体ID的获取方式请参见agentId。

appId

int

是

123**4

DataWind项目ID，没有与DataWind联合部署使用的场景可填0。

sessionType

string

否(默认为normal)

normal

创建的会话类型，支持的枚举值：

normal：智能问数
deep_research：深度分析

返回参数

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

参数	类型	示例值	描述
sessionInfo.emailPrefix	string	admin	session创建者的账号名称。
sessionInfo.id	int	12886164	创建好的会话ID（session id），您可记录好会话ID，后续获取会话信息、获取对话结果等接口需使用会话ID。
sessionInfo.lastActiveTime	string	2025-10-24 16:03:54	session最新活跃时间，日期格式：yyyy-MM-dd HH:mm:ss
sessionInfo.name	string	新的会话	会话名称，首次创建默认为"新的会话"，如果您希望修改会话名称，需要调用updateSession更新。

返回示例

{
    "JSONIFY_PRETTYPRINT_REGULAR": false,
    "code": "llm/ok",
    "data": {
        "sessionInfo": {
            "createTime": "2025-10-24 16:03:54",
            "emailPrefix": "admin",
            "id": 12886164,  // 会话ID，最重要的字段，可记录下来，用于后面获取会话信息等接口使用
            "isExpired": false,
            "lastActiveTime": "2025-10-24 16:03:54",
            "name": "新的会话"
        }
    },
    "msg": {}
}

最近更新时间：2025.12.10 18:22:10

这个页面对您有帮助吗？

有用

无用