技能注册表
智能体基础设施公共技能

Session Memory Management

类型化会话状态——存储/检索上下文,重放快照,恢复中断的工作流,完成时编辑敏感数据。

此技能教授的内容

针对特定工作类型的可复用操作手册。

MCP 服务器告诉代理可用的操作。技能为这些操作添加判断:如何识别任务,遵循哪个顺序,避免什么,以及如何判断结果已完成。

管理会话状态和内存——存储/检索类型化数据、回放快照、恢复中断工作流、编辑敏感信息。适用于持久化上下文、恢复工作流、回忆历史数据、管理跨会话内存或清理敏感状态。

架构

Session Memory Management 如何指导 ADK-Rust 代理。

技能保持可读和可移植,因为它包含说明而非服务凭证或业务数据。ADK-Rust 将其提供给代理,代理从审核过的工具边界中选择,连接的 MCP 服务器执行经过身份验证的操作。

01

用户请求

代理接收以普通语言表达的目标。

02

Session Memory Management 技能

匹配意图,提供决策指南,并缩小工具边界。

03

ADK-Rust 代理

规划工作流,并通过运行时流式传输每个关键步骤。

04

mcp-session-memory

对拥有该能力的系统执行经过身份验证的操作。

05

已验证结果

技能的完成规则决定返回给用户的证据。

可移植的说明: SKILL.md · 能力边界: mcp-session-memory · 允许的工具: 10

决策指南

代理如何将请求转化为正确操作。

这些路由直接来自技能说明。它们帮助模型识别意图并选择专注的工具或工作流,而不是在整个能力范围内即兴发挥。

01

“记住”、“存储”、“保存”?

store_memory

02

“回忆”、“之前是什么”、“上次”?

retrieve_memory / list_memory_refs

03

“恢复”、“从哪里继续”、“继续”?

resume_session / create_replay_snapshot

04

“忘记”、“删除”、“编辑”?

delete_memory / redact_memory

05

“会话”、“事件”、“历史”?

get_session_state / list_session_events

经过验证的工作流

可重复的序列以实现有用结果。

工作流将多个工具调用组合成用户实际识别的任务。技能解释顺序和预期结果,而 ADK-Rust 通过共享运行时实时传输代理的进度。

011 次调用

存储

持久化类型化数据并设置 TTL

021-2 次调用

回忆

按键/范围检索

032 次调用

恢复

快照 → 验证 → 继续

041 次调用

编辑

移除敏感数据

工具边界

技能可能使用 10 个已记录工具。

此允许列表由技能声明。它使代理专注于完成此任务所需的操作,而 mcp-session-memory 保留身份验证、验证和连接系统的责任。

get_session_state
list_session_events
retrieve_memory
store_memory
update_memory
delete_memory
redact_memory
list_memory_refs
create_replay_snapshot
resume_session

工作规则

代理应做什么。

  • 所有存储状态设置TTL(防止无限增长)
  • 恢复工作流前验证数据新鲜度
  • 使用后编辑敏感数据(PII、凭证)
  • 限制内存访问范围(代理仅见自身数据)

操作边界

代理应避免什么。

  • 绝不在会话内存存储凭证(使用保险库)
  • 恢复前检查外部状态变化
  • 不要无限期保存内存,必须有TTL

安装并连接

将技能添加到其预期能力旁边。

安装仓库,使您的 ADK-Rust 技能加载器能发现它,连接 mcp-session-memory,并确认声明的工具可用后,再让代理使用工作流。

安装技能
git clone https://github.com/zavora-ai/skill-session-memory-management.git \
  ~/.skills/skills/session-memory-management
ADK-Rust 加载形态
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("session-memory-management").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

仓库的兼容性声明:需要连接mcp-session-memory服务器。

源记录

此技能条目的仓库元数据。

查看公共仓库 ↗
许可证
Apache-2.0
允许的工具
10
参考文献
3
修订
2e68156d71be
已更新
2026年5月31日