mcpField
A
agent-memory

agent-memory

github.com/pluginagentmarketplaceAgent 工作流166 次安装43 周前更新
代码仓库

关于 agent-memory

agent-memory 是面向 Agent 开发者的记忆设计技能,涵盖对话历史、长期记忆、个性化和上下文窗口管理。它介绍缓冲、摘要、向量及混合记忆方式,并给出多层架构建议。

主要功能

  1. 01缓冲、摘要、向量和混合记忆
  2. 02会话、用户和全局持久化选项
  3. 03多层记忆架构示例
  4. 04上下文溢出与检索问题排查

适用场景

  1. 01为 Agent 添加对话历史
  2. 02设计长期或个性化记忆
  3. 03管理有限的上下文窗口

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pluginagentmarketplace/custom-plugin-ai-agents --skill agent-memory

安装后在 Claude Code 中输入/agent-memory确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
config.yaml
schema.json
references/
GUIDE.md
PATTERNS.md
scripts/
multi_layer_memory.py
validate.py

详细介绍

Agent 记忆

让 Agent 能够在不同对话中记住信息并持续学习。

何时使用此技能

在以下情况下调用此技能:

  • 添加对话历史记录
  • 实现长期记忆
  • 构建个性化 Agent
  • 管理上下文窗口

参数架构

参数类型必填描述默认值
taskstring是记忆目标-
memory_typeenum否buffer、summary、vector、hybridhybrid
persistenceenum否session、user、globalsession

快速开始

from langchain.memory import ConversationBufferWindowMemory

# Simple buffer (last k messages)
memory = ConversationBufferWindowMemory(k=10)

# With summarization
from langchain.memory import ConversationSummaryBufferMemory
memory = ConversationSummaryBufferMemory(llm=llm, max_token_limit=2000)

# Vector store memory
from langchain.memory import VectorStoreRetrieverMemory
memory = VectorStoreRetrieverMemory(retriever=vectorstore.as_retriever())

记忆类型

类型用例优点缺点
Buffer简短对话简单不压缩
Summary长对话紧凑会丢失细节
Vector语义检索相关性高速度较慢
Hybrid生产环境综合表现最佳复杂

多层架构

class ProductionMemory:
    def __init__(self):
        self.short_term = BufferMemory(k=10)    # Recent
        self.summary = SummaryMemory()           # Compressed
        self.long_term = VectorMemory()          # Semantic

故障排查

问题解决方案
上下文溢出添加摘要
检索缓慢使用缓存、减少 k 值
检索结果不相关改进嵌入
记忆未持久化检查存储后端

最佳实践

  • 在生产环境中使用多层记忆
  • 设置 Token 限制以防止溢出
  • 添加元数据(时间戳、重要性)
  • 为旧记忆设置 TTL

相关技能

  • rag-systems - 向量检索
  • llm-integration - 上下文管理
  • ai-agent-basics - Agent 架构

参考资料

评论

支持 Markdown