百宝箱开放平台 ✖️ 创建会话

创建会话

在开放平台， 会话是指用户与智能体的对话过程，可以包含多个轮次的问答。通过调用本接口，开发者可以创建一个新的会话。

前提条件

• 在调用本接口前，请先完成应用的发布。

请求地址

POST``https://api.tbox.cn/api/conversation/create

请求头

参数名	是否必填	类型	说明	示例
Authorization	是	String	用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。	pat_2j4e******THUIVRH1

请求参数

参数名	是否必填	类型	说明	示例
appId	是	String	应用 ID，需要通过 API 进行集成的应用 ID。	202506e******00450562

请求示例

curl --location 'https://api.tbox.cn/api/conversation/create' \
--header 'Authorization: {your_token}' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
    "appId":{your_appId}
}'

返回参数

参数名	类型	说明	示例
errorCode	String	错误码，为 0 表示成功。	0
errorMsg	String	错误信息。	success
data	String	会话 ID。	-
traceId	String	traceId，用于排查问题	0a42******9265

返回示例

成功返回

{
    "data": "2025******3533",
    "errorCode": "0",
    "errorMsg": "success",
    "traceId": "0a42******9265"
}

失败返回

{
    "errorCode": "P_1_02_084",
    "errorMsg": "app不存在",
    "solution": "请确认参数:appId是否有效"
}