腾讯云数据库 AI 服务设置 State

接口介绍
本接口（/memory/v1/state/set）用于设置当前会话中的状态数据。
Method 与 URL
POST https://{服务访问地址}/memory/v1/state/set
使用示例
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/state/set \\
  -d '{
    "memory_id": "tdai-mem-8i8t****",
    "actor_id": "user-test-001",
    "session_id": "session-PTVM****",
    "state": {
      "环境偏好": "安静、人少",
      "天气查询": "查询完成",
      "notification_enabled": true,
      "user_language": "zh-CN"
    }
}'
请求参数
参数
是否必选
参数含义
配置方法及要求
memory_id
是
指定需设置当前会话状态的 Memory ID。
登录 Memory 智能体控制台 可复制 Memory ID。具体信息，参见 查看 Memory 详情。
actor_id
是
指定需设置当前会话状态的用户 ID。
数据类型：String
长度限制：[1,20]
字符规则：任意字符
session_id
是
指定需设置当前会话状态的会话 ID。
获取 Session ID，请参见 查询 Session。
state
是
指定需设置的状态数据，对于已存在的更新，不存在的新增。
允许包含一个或多个任意类型的键值对，如字符串、数字、布尔值、数组、对象等。示例如下所示。
{
  "user_preference_theme": "light",          // 字符串值
  "shopping_cart_items": ["laptop", "headphones"], // 数组/列表值
  "user_language": "zh-CN",                  // 字符串值
  "notification_enabled": true               // 布尔值
}
响应消息
执行成功，输出如下信息。
{
    "code":0,
    "message": "State set successfully",
    "data": {
        "affected_count": 4
    }
}
参数名（一级）
参数名（二级）
参数含义
data
affected_count
设置成功的状态数量。

参数名（一级）	参数名（二级）	参数含义
data	affected_count	设置成功的状态数量。

参数	是否必选	参数含义	配置方法及要求
memory_id	是	指定需设置当前会话状态的 Memory ID。	登录 Memory 智能体控制台可复制 Memory ID。具体信息，参见查看 Memory 详情。
actor_id	是	指定需设置当前会话状态的用户 ID。	数据类型：String 长度限制：[1,20] 字符规则：任意字符
session_id	是	指定需设置当前会话状态的会话 ID。	获取 Session ID，请参见查询 Session。
state	是	指定需设置的状态数据，对于已存在的更新，不存在的新增。	允许包含一个或多个任意类型的键值对，如字符串、数字、布尔值、数组、对象等。示例如下所示。 { "user_preference_theme": "light", // 字符串值 "shopping_cart_items": ["laptop", "headphones"], // 数组/列表值 "user_language": "zh-CN", // 字符串值 "notification_enabled": true // 布尔值 }

设置 State

本页目录：

接口介绍

Method 与 URL

使用示例

请求参数

响应消息