创建 Session

最近更新时间:2026-01-15 10:48:51

我的收藏

接口介绍

本接口(/memory/v1/session/create)用于创建一个新会话,并将其关联到指定的记忆库。

Method 与 URL

POST https://{服务访问地址}/memory/v1/session/create

使用示例

说明:
为确保请求安全与有效,请在请求头中提供以下两项参数以完成鉴权与目标标识。获取方式,请参见 查看 Memory 详情
-H 'Authorization: Bearer <Access_Token>' \\ :需填入为有效的访问密钥,用于验证请求的合法身份。
-H "x-tdai-service-id: <Service_ID>" \\ :需填入 Memory 服务的唯一标识 ID。
curl -i -k -X POST \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer ******************************' \\
-H "x-tdai-service-id: tdai-mem-8i8t****" \\
https://memory.tdai.tencentyun.com/memory/v1/session/create \\
-d '{
"memory_id": "tdai-mem-8i8t****",
"actor_id": "user-service-test",
"name": "Travel_Consultation"
}'

请求参数

参数
是否必选
参数含义
配置方法及要求
memory_id
指定 Session 需关联的记忆库 ID。
登录 Memory 智能体控制台 可复制 Memory ID。具体信息,参见 查看 Memory 详情
actor_id
可根据需要指定 Session 的用户 ID。
数据类型:String。
长度限制:[1,128]。
字符规则:任意字符。
name
指定 Session 名称。
数据类型:String。
长度限制:[1,128]。
字符规则:任意字符。
默认:以 Unkown 命名。

响应示例

执行成功,输出如下信息。
{
"code":0,
"message":"success",
"data": {
"session_id": "session-7fd3b2dd********"
}
}
参数名(一级)
参数名(二级)
参数含义
data
session_id
为所创建的 Session 自动分配的具有唯一标识的 ID。