创建 Session

最近更新时间:2025-09-17 11:13:52

我的收藏

接口介绍

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

Method 与 URL

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

使用示例

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-e3f7****",
"actor_id": "user-test-001",
"name": "Travel_Consultation"
}'

请求参数

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

响应消息

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