接口定义
本接口
delete_states()用于删除会话中指定的一个或多个状态键。def delete_states(session_id: str,keys: List[str] | None,memory_id: str | None = None,actor_id: str | None = None) -> Dict[str, Any]
使用示例
import jsonfrom tdaimemory import MemoryClientdel_state_result = client.delete_states(session_id="session-Y5oi****",keys=["notification_enabled"],)print(json.dumps(del_state_result, ensure_ascii=False))
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
memory_id | 否 | 指定需删除会话状态的 Memory ID。 | |
actor_id | 否 | 指定需删除会话状态的用户 ID。 | 数据类型:String 长度限制:[1,20] 字符规则:任意字符 |
session_id | 是 | 指定需删除会话状态的会话 ID。 | |
keys | 是 | 指定需删除的状态键列表。 | 数据类型:String 数组。 示例:["user_preference_theme", "shopping_cart_items"] |
响应消息
执行成功,输出如下信息。
>>> print(json.dumps(del_state_result, ensure_ascii=False)){"affected_count": 1}
参数名 | 参数含义 |
affected_count | 返回删除的状态键数量。 |