CreateSession - 创建对话会话

创建一个新的对话会话（Session），用于组织一次或多次问答交互。

接口说明

Session 代表一次对话上下文。创建后返回

sessionId

sessionId

，后续的问题请求需要关联到某个 Session。

如果客户端已有可复用的

sessionId

sessionId

，可跳过本步骤直接发起问题。

使用须知

一个 Session 可以包含多个问题
Session 创建后可重复使用，无需每次提问都新建

请求方式

POST /open/session/safe_new?tenantId={tenantId}&userId={userId}&loginToken={loginToken}

💡 提示：

tenantId

tenantId

、

userId

userId

、

loginToken

loginToken

需要同时出现在 URL query 参数和 request body 中，缺少 query 参数会导致请求失败。

请求参数

参数名	位置	类型	是否必须	说明
tenantId	Query + Body	Integer	是	租户 ID
userId	Query + Body	Integer	是	用户 ID
domainId	Body	Integer	是	数据域 ID，对应一个数据集
title	Body	String	否	会话标题，用于标识该 Session
loginToken	Query + Body	String	是	通过 GenerateAuthToken 获取的认证 Token

返回参数

参数名	类型	说明
success	Boolean	请求是否成功
data	Integer	创建成功的 sessionId

请求示例

POST /open/session/safe_new Content-Type: application/json { "tenantId": 10, "userId": 1, "domainId": 106, "title": "Q1 销售分析", "loginToken": "eyJhbGciOiJIUzI1NiJ9..." }

返回示例

正常返回示例：

{ "success": true, "data": 4729 }

其中

data

data

的值

4729

即为新创建的

sessionId

sessionId

。

错误码

错误码	说明
success=false	Token 无效、参数缺失或权限不足

CreateSession - 创建对话会话

接口说明

使用须知

请求方式

请求参数

返回参数

请求示例

返回示例

错误码

相关文档