获取 State

最近更新时间:2025-09-12 21:41:52

我的收藏

接口定义

本接口get_states()用于获取当前会话中所有状态数据。
def get_states(
session_id: str,
keys: List[str] | None,
memory_id: str | None = None,
actor_id: str | None = None
) -> Dict[str, Any]


使用示例

import json
from tdaimemory import MemoryClient

state = client.get_states(
session_id="session-Y5oi****",
keys=["notification_enabled", "user_language"],
)
print(json.dumps(state, ensure_ascii=False))

求参数

参数
是否必选
参数含义
配置方法及要求
memory_id
指定需获取当前会话状态的 Memory ID。
登录 Memory 智能体控制台,可在 Memory 服务概览页面复制 Memory ID。具体可以参见 查看 Memory
actor_id
指定需获取当前会话状态的用户 ID。
数据类型:String
长度限制:[1,20]
字符规则:任意字符
session_id
指定需获取当前会话状态的会话 ID。
获取会话 ID,请参见 查询 Session
keys
指定需获取当前会话的状态键列表。
数据类型:String 数组
示例:["user_preference_theme", "shopping_cart_items"]

响应消息

执行成功,输出如下信息。
>>> print(json.dumps(state, ensure_ascii=False))
{"state": {"notification_enabled": true, "user_language": "en-US"}}
参数名
参数含义
state
返回状态数据 Key 对应的 Value。