Python: samples: add Synap context provider example

[visy-ani]

Adds a sample demonstrating SynapContextProvider — a Microsoft Agent Framework ContextProvider backed by Synap, a managed memory layer for AI agents.

What's included

• python/samples/02-agents/context_providers/synap/synap_basic.py — basic usage showing context injection and turn recording
• python/samples/02-agents/context_providers/synap/README.md — setup and run instructions

How SynapContextProvider works

• before_run: fetches Synap context relevant to the user's input and appends it to the agent's instructions via context.extend_instructions(...)
• after_run: records input and response messages to Synap via sdk.conversation.record_message(...) for future retrieval

Read failures degrade gracefully (log + skip). Write failures are logged but never re-raised — the agent run always completes. This matches the contract established by Mem0ContextProvider.

Memory is scoped to user_id and customer_id, ensuring strict isolation in multi-tenant applications.

Install: pip install maximem-synap-microsoft-agent
PyPI: https://pypi.org/project/maximem-synap-microsoft-agent/
Docs: https://docs.maximem.ai/integrations/microsoft-agent
Open source: Integration package source at maximem-ai/maximem_synap_sdk — contributions welcome

[Copilot]

Pull request overview

Adds a new Python sample under the context provider samples to demonstrate integrating SynapContextProvider as a managed long-term memory source for Agent Framework agents.

Changes:

• Adds synap_basic.py to show wiring a Synap SDK instance and context provider into an agent flow.
• Adds a sample README with setup, run steps, and external Synap documentation links.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
python/samples/02-agents/context_providers/synap/synap_basic.py	New sample script intended to demonstrate Synap-backed context injection and memory recall across runs.
python/samples/02-agents/context_providers/synap/README.md	New documentation describing the sample, setup steps, execution command, and related resources.

[visy-ani]

@microsoft-github-policy-service agree [company="Maximem"]

[visy-ani]

@microsoft-github-policy-service agree company=Maximem

[visy-ani]

Hi @moonbox3 and @eavanvalkenburg — would appreciate a review when you get a chance! This adds a SynapContextProvider sample showing persistent cross-session memory with the Microsoft Agent Framework.

Copilot-flagged issues are now resolved: replaced the random uuid.uuid4() user ID (which broke cross-session persistence) with a stable "demo-user-001", and replaced the hardcoded API key placeholder with os.environ["SYNAP_API_KEY"]. Thanks!

[sphenry]

@visy-ani normally we prefer for this type of integration to live in a separate repo, and we can link from our docs

[visy-ani]

Got it, thanks @sphenry . The code already lives in our repo and is published as maximem-synap-microsoft-agent on PyPI. I'd be happy to convert this PR into a docs-only change that just links to it from your community integrations page , would that work? Just point me at the right file and I'll update the PR.