跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
AI 与知识库

neo4j-agent-memory-skill

Authoritative reference for the neo4j-agent-memory Python package — a graph-native memory system for AI agents built on Neo4j — and for the hosted service (NAMS) at memory.neo4jlabs.com. Use this skill whenever the user mentions neo4j-agent-memory, agent memory with Neo4j, context graphs, the POLE+O model, MemoryClient/MemorySettings, the memory MCP server, or any of the framework integrations (LangChain, PydanticAI, CrewAI, AWS Strands, Google ADK, Microsoft Agent Framework, OpenAI Agents, LlamaIndex). Also use when the user mentions the hosted service at memory.neo4jlabs.com, NAMS, the Neo4j Agent Memory Service, the `nams_` API key prefix, or the hosted MCP endpoint. Also use when writing documentation, blog posts, tutorials, PRDs, or code samples for the project, when comparing agent memory approaches, or when positioning graph-native memory against vector-only approaches — even if the user doesn't explicitly name the package.

neo4j-contrib · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add neo4j-contrib/neo4j-skills --skill neo4j-agent-memory-skill

技能说明


name: neo4j-agent-memory-skill description: Authoritative reference for the neo4j-agent-memory Python package — a graph-native memory system for AI agents built on Neo4j — and for the hosted service (NAMS) at memory.neo4jlabs.com. Use this skill whenever the user mentions neo4j-agent-memory, agent memory with Neo4j, context graphs, the POLE+O model, MemoryClient/MemorySettings, the memory MCP server, or any of the framework integrations (LangChain, PydanticAI, CrewAI, AWS Strands, Google ADK, Microsoft Agent Framework, OpenAI Agents, LlamaIndex). Also use when the user mentions the hosted service at memory.neo4jlabs.com, NAMS, the Neo4j Agent Memory Service, the nams_ API key prefix, or the hosted MCP endpoint. Also use when writing documentation, blog posts, tutorials, PRDs, or code samples for the project, when comparing agent memory approaches, or when positioning graph-native memory against vector-only approaches — even if the user doesn't explicitly name the package. version: 1.0.8

neo4j-agent-memory

Authoritative reference for the neo4j-agent-memory Python package — a Neo4j Labs project that gives AI agents three distinct memory layers (short-term, long-term, reasoning) in a single knowledge graph.

⚠️ Verify authoritative state before writing. Version numbers, extras, tool counts, and API surface change between releases. The values in this skill reflect a specific point in time. Before publishing anything version-sensitive, confirm against PyPI (https://pypi.org/project/neo4j-agent-memory/) and the GitHub README (https://github.com/neo4j-labs/agent-memory). PyPI is the authoritative source for version numbers — never infer.

When to Use

  • Building AI agents that need persistent memory (short-term, long-term, reasoning traces) backed by Neo4j
  • Using the neo4j-agent-memory Python package or the hosted NAMS service at memory.neo4jlabs.com
  • Integrating agent memory with LangChain, PydanticAI, CrewAI, AWS Strands, Google ADK, OpenAI Agents, LlamaIndex, or Microsoft Agent Framework
  • Writing documentation, tutorials, or positioning content about graph-native agent memory
  • Comparing graph-native memory against vector-only approaches

When NOT to Use

  • Plain Neo4j driver connections (no memory layer needed) → use neo4j-driver-python-skill
  • Writing or optimizing Cypher queries → use neo4j-cypher-skill
  • GraphRAG retrieval pipelines → use neo4j-graphrag-skill

Project at a Glance

FieldValue
Packageneo4j-agent-memory
PyPIhttps://pypi.org/project/neo4j-agent-memory/
GitHubhttps://github.com/neo4j-labs/agent-memory
Canonical docshttps://neo4j.com/labs/agent-memory/
Hosted servicehttps://memory.neo4jlabs.com (NAMS — early-access, not yet documented on official project pages)
Hosted MCP endpointhttps://memory.neo4jlabs.com/mcp (Streamable HTTP, bearer auth)
LicenseApache-2.0
Python3.10+
Neo4j5.20+ (required for vector indexes)
StatusExperimental (Neo4j Labs, community-supported)
Current version (at time of writing)0.7.0 (2026-10-07) — always verify PyPI before citing

What It Is (One Sentence)

A graph-native memory system for AI agents that stores conversations, builds knowledge graphs, and records agent reasoning — all as connected nodes in a single Neo4j database.

Consumption Models

neo4j-agent-memory ships in two consumption models. They are the same underlying project — the differences are how you run it, how you authenticate, and what's managed for you.

OptionWhat It IsWhen to Choose
Self-hosted librarypip install neo4j-agent-memory + your own Neo4j (local / Docker / Aura). Full Python API, local MCP server, and framework integrations run in your process.Dev, on-prem data, custom extraction pipelines, full control, bringing your own embeddings / LLMs.
Hosted (NAMS)Managed service at https://memory.neo4jlabs.com. Per-workspace isolated Neo4j Aura database, REST API, remote MCP endpoint, web console.Zero-infra trials, sharing memory across agents / machines, demos, teams that don't want to run Neo4j.

⚠️ NAMS is reachable but not yet referenced in the GitHub README or neo4j.com/labs/agent-memory/. Treat it as early-access / soft-launched. Do not assert SLAs, pricing, or GA status in published content. See the Hosted Service (NAMS) section below for details.

The Three Memory Types

The defining architectural feature. Every piece of content describing the project should lead with this trinity.

Memory TypeStoresColor Convention
Short-TermConversation messages, session history, sequential message chains, metadata-filtered search, LLM-powered summariesGreen (#B2F2BB / #2F9E44)
Long-TermEntities (people, places, orgs), preferences, facts, and the relationships between them — built automatically from conversations via the POLE+O modelOrange/Yellow (#FFEC99 / #F08C00)
ReasoningDecision traces, tool call provenance, thought-action-outcome chains — so the agent can learn from its own past reasoning patternsPurple (#D0BFFF / #9C36B5)

Reasoning memory is the primary competitive differentiator. Most competing systems cover short-term and long-term but treat reasoning as an afterthought or omit it entirely. Lead with this when positioning.

The POLE+O Model

Long-term memory uses the POLE+O entity framework — the canonical entity classification for this project:

  • Person
  • Organization
  • Location
  • Event
  • +O Object (anything that doesn't fit the core four — products, concepts, projects, etc.)

When diagramming the data model, use ellipses for entity nodes and labeled arrows (UPPER_SNAKE_CASE) for relationships, consistent with Neo4j Browser conventions.

Installation

Core i

阅读完整来源 ↗