Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
8c103de
Python: Adds sample documentation for two separate Neo4j context prov…
retroryan Feb 18, 2026
68afbcb
adding pypi links
retroryan Feb 26, 2026
eb96551
Merge branch 'main' into docs/neo4j-context-provider
retroryan Feb 27, 2026
e3145bd
Merge branch 'main' into docs/neo4j-context-provider
benofben Mar 26, 2026
db4053e
Merge remote-tracking branch 'upstream/main' into docs/neo4j-context-…
retroryan Mar 30, 2026
90134b8
Merge branch 'docs/neo4j-context-provider' of github.com:neo4j-partne…
retroryan Mar 30, 2026
022792b
Merge remote-tracking branch 'upstream/main' into docs/neo4j-context-…
retroryan Mar 31, 2026
aade778
adding dotnot examples
retroryan Mar 31, 2026
85873a8
adding dotnot examples
retroryan Mar 31, 2026
1ab9cc0
Merge remote-tracking branch 'upstream/main' into docs/neo4j-context-…
retroryan Apr 1, 2026
80fe2eb
Merge remote-tracking branch 'upstream/main' into docs/neo4j-context-…
retroryan Apr 1, 2026
7c38e4a
merge upstream samples
retroryan Apr 1, 2026
fb82d8d
Merge branch 'main' into docs/neo4j-context-provider
retroryan Apr 1, 2026
ebfd2ae
Merge remote-tracking branch 'upstream/main' into docs/neo4j-context-…
retroryan Apr 3, 2026
2e7b96d
fixing docs
retroryan Apr 3, 2026
3bc51a1
Merge branch 'docs/neo4j-context-provider' of github.com:neo4j-partne…
retroryan Apr 3, 2026
0332dc4
Merge remote-tracking branch 'upstream/main' into docs/neo4j-context-…
retroryan Apr 6, 2026
6f318c3
fix relative paths
retroryan Apr 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions python/samples/02-agents/context_providers/neo4j/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Neo4j Context Providers
Comment thread
retroryan marked this conversation as resolved.

Neo4j offers two context providers for the Agent Framework, each serving a different purpose:

| | [Neo4j Memory](../neo4j_memory/README.md) | [Neo4j GraphRAG](../../../05-end-to-end/neo4j_graphrag/README.md) |
|---|---|---|
| **What it does** | Read-write memory — stores conversations, builds knowledge graphs, learns from interactions | Read-only retrieval from a pre-existing knowledge base with optional graph traversal |
| **Data source** | Agent interactions (grows over time) | Pre-loaded documents and indexes |
| **Python package** | [`neo4j-agent-memory`](https://pypi.org/project/neo4j-agent-memory/) | [`agent-framework-neo4j`](https://pypi.org/project/agent-framework-neo4j/) |
| **Database setup** | Empty — creates its own schema | Requires pre-indexed documents with vector or fulltext indexes |
| **Example use case** | "Remember my preferences", "What did we discuss last time?" | "Search our documents", "What risks does Acme Corp face?" |

## Which should I use?

**Use [Neo4j Memory](../neo4j_memory/README.md)** when your agent needs to remember things across sessions — user preferences, past conversations, extracted entities, and reasoning traces. The memory provider writes to the database on every interaction, building a knowledge graph that grows over time.

**Use [Neo4j GraphRAG](../../../05-end-to-end/neo4j_graphrag/README.md)** when your agent needs to search an existing knowledge base — documents, articles, product catalogs — and optionally enrich results by traversing graph relationships. The GraphRAG provider is read-only and does not modify your data.

You can use both together: GraphRAG for domain knowledge retrieval, Memory for personalization and learning.
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Neo4j Memory Context Provider

[Neo4j Agent Memory](https://github.com/neo4j-labs/agent-memory) is a graph-native memory system for AI agents that stores conversations, builds knowledge graphs from interactions, and lets agents learn from their own reasoning — all backed by Neo4j.

For full documentation, installation instructions, code examples, and configuration details, see the [Neo4j Memory integration guide on Microsoft Learn](https://learn.microsoft.com/agent-framework/integrations/neo4j-memory).

For a runnable example, see the [retail assistant sample](https://github.com/neo4j-labs/agent-memory/tree/main/examples/microsoft_agent_retail_assistant).

For help choosing between the Memory and GraphRAG providers, see the [Neo4j Context Providers overview](../neo4j/README.md).
2 changes: 2 additions & 0 deletions python/samples/05-end-to-end/neo4j_graphrag/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ The [Neo4j GraphRAG context provider](https://github.com/neo4j-labs/neo4j-maf-pr

This sample keeps setup lightweight by using a pre-built Neo4j fulltext index plus a graph-enrichment query.

For full documentation, see the [Neo4j GraphRAG integration guide on Microsoft Learn](https://learn.microsoft.com/agent-framework/integrations/neo4j-graphrag).

## Example

| File | Description |
Expand Down
Loading