---
title: "User Memory — AVCodex Docs"
description: "User Memory — AVCodex documentation for AV integrators, programmers, and ops teams."
lang: en
json-ld:
---

[](/)

Solutions

[Pricing](/pricing)[The Signal](/blog)[Resources](/resources)

Learn

[Free AI Assessment](/scorecard)[Get Started →](/pricing)

[Documentation Home](/docs)

Guides 

Getting Started

-   [The Alchemist Copilot](/docs/guides/the-alchemist-copilot)
-   [Choosing a Model](/docs/guides/choosing-a-model)
-   [Skills & Templates](/docs/guides/skills-and-templates)
-   [Pricing & Usage](/docs/guides/pricing-and-usage)
-   [Understanding Tokens](/docs/guides/understanding-tokens)
-   [Maximize AVCodex Capabilities](/docs/guides/maximize-avcodex-capabilities)

Knowledge & Memory

-   [How Knowledge Sources Work](/docs/guides/how-knowledge-sources-work)
-   [Knowledge Retrieval Settings](/docs/guides/knowledge-retrieval-settings)
-   [User Memory](/docs/guides/user-memory)
-   [Consumer Brain](/docs/guides/consumer-brain)

Agent Capabilities

-   [Image Recognition](/docs/guides/image-recognition)
-   [Image Generation](/docs/guides/image-generation)
-   [Video Generation](/docs/guides/video-generation)
-   [Deep Research and Deep Thinking](/docs/guides/deep-research-and-deep-thinking)
-   [Heartbeat (Proactive AI Outreach)](/docs/guides/heartbeat-proactive-ai-outreach)
-   [Database Connections](/docs/guides/database-connections)
-   [Agent-to-Agent Links](/docs/guides/agent-to-agent-links)
-   [Message Tagging](/docs/guides/message-tagging)
-   [Lead Generation Forms](/docs/guides/lead-generation-forms)
-   [Multilingual Apps](/docs/guides/multilingual-apps)
-   [Understanding Evaluations](/docs/guides/understanding-evaluations)

Design & Experience

-   [Style Studio](/docs/guides/style-studio)
-   [Component Studio](/docs/guides/component-studio)
-   [HQ Profile](/docs/guides/hq-profile)
-   [Multiplayer Chat](/docs/guides/multiplayer-chat)
-   [Circles](/docs/guides/circles)
-   [Desktop Agent](/docs/guides/desktop-agent)

Voice & Phone

-   [Phone Numbers](/docs/guides/phone-numbers)
-   [Outbound Calling](/docs/guides/outbound-calling)
-   [Voice Cloning](/docs/guides/voice-cloning)

Publish & Share

-   [Embed Chat Widget](/docs/guides/embed-chat-widget)
-   [Custom Domains](/docs/guides/custom-domains)
-   [PWA Installation](/docs/guides/pwa-installation)
-   [AVCodex Sites](/docs/guides/avcodex-sites)
-   [Embed on Kajabi](/docs/guides/embed-on-kajabi)
-   [How to Use AVCodex with Claude Code](/docs/guides/how-to-use-avcodex-with-claude-code)

Monetization & Access

-   [Selling Access](/docs/guides/selling-access)
-   [Consumer Monetization](/docs/guides/consumer-monetization)
-   [Access Control](/docs/guides/access-control)
-   [Bring Your Own Auth](/docs/guides/bring-your-own-auth)
-   [Clever SSO for Schools](/docs/guides/clever-sso-for-schools)

Analytics & Operations

-   [Analytics & Chat History](/docs/guides/analytics-and-chat-history)
-   [Performance Dashboard](/docs/guides/performance-dashboard)
-   [Programmatic Usage Stats](/docs/guides/programmatic-usage-stats)
-   [Session Lifecycle Webhooks](/docs/guides/session-lifecycle-webhooks)
-   [Audit Logs](/docs/guides/audit-logs)

Teams & White-Label

-   [Team Management](/docs/guides/team-management)
-   [Enterprise Whitelabel](/docs/guides/enterprise-whitelabel)

Alchemist Platform

-   [Alchemist Tickets](/docs/guides/alchemist-tickets)
-   [Alchemist Getting Started](/docs/guides/alchemist-getting-started)
-   [Alchemist Working with Tickets](/docs/guides/alchemist-working-with-tickets)
-   [Alchemist Local Development](/docs/guides/alchemist-local-development)

Alchemist Operations

-   [Alchemist Environment Variables](/docs/guides/alchemist-environment-variables)
-   [Alchemist Deploys and Domains](/docs/guides/alchemist-deploys-and-domains)
-   [Alchemist Self-Healing](/docs/guides/alchemist-self-healing)

Alchemist API & Automation

-   [Alchemist API Keys](/docs/guides/alchemist-api-keys)
-   [Alchemist MCP Server](/docs/guides/alchemist-mcp-server)
-   [Alchemist Pipeline Configuration](/docs/guides/alchemist-pipeline-configuration)
-   [Alchemist Pipeline Permutations](/docs/guides/alchemist-pipeline-permutations)

Developer Platform

-   [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers)
-   [Consumer OAuth for Custom MCP Servers](/docs/guides/consumer-oauth-for-custom-mcp-servers)

AVCodex MCP Server

-   [Overview](/docs/guides/overview)
-   [MCP Reference](/docs/guides/mcp-reference)
-   [Setup & Installation](/docs/guides/setup-and-installation)
-   [Authentication](/docs/guides/authentication)
-   [Tools Reference](/docs/guides/tools-reference)
-   [Common Workflows](/docs/guides/common-workflows)
-   [Rate Limits](/docs/guides/rate-limits)

Custom Actions 

Pro Actions 

API 

Builder API 

Agentic Commerce (ACP) 

Integrations 

[Docs](/docs)/ Guides / Knowledge & Memory 

# User Memory

Last updated · MAR 2026 · [Read as Markdown](/docs/guides/user-memory.md)

User Memory enables your agent to remember important facts about users across conversations. Instead of starting fresh every time, your agent can recall preferences, past tickets, and relevant context.

## [What is User Memory# ](#what-is-user-memory)

User Memory automatically extracts and stores durable facts from conversations:

Memory type

Examples

**Saved Facts**

"User's company is Acme Integration", "Prefers email over phone for non-urgent dispatches."

**Preferences**

"Likes concise answers", "Uses metric for cable runs."

**User Insights**

"Senior commissioning engineer", "Owns the Acme HQ relationship."

**Topic Highlights**

"Asked about a 40-room corporate refresh RFP", "Interested in DM-NVX licensing."

## [How it works# ](#how-it-works)

code 

```
User: "I'm the lead programmer at Acme Integration and we just took over service
       for the Foley Building."
           |
           v
    [Conversation ends]
           |
           v
    [Memory extraction runs]
           |
           v
    Memories stored:
    - Role: Lead programmer
    - Company: Acme Integration
    - Account: Foley Building service contract
           |
           v
    [Next conversation]
           |
           v
AI: "Welcome back. Last time we worked on the Foley Building handoff. What can
     I help with today?"
```

## [Enabling User Memory# ](#enabling-user-memory)

**1\. Open Memory Settings.**

Go to your agent's **Build** page and find **Memory Settings** in the sidebar.

**2\. Enable Memory Extraction.**

Toggle **Enable User Memory** on. This activates automatic memory extraction from conversations.

**3\. Configure categories (optional).**

Choose which types of information to remember:

-   **Saved Facts**: concrete information (names, companies, roles).
-   **Preferences**: how users like to interact.
-   **Topic Highlights**: key discussion topics.
-   **User Insights**: inferred characteristics.
-   **Recent Queries**: common questions asked.

**4\. Set custom instructions (optional).**

Add specific extraction guidance:

code 

```
Focus on:
- Integrator firm name and the user's role
- Active projects and accounts the user is responsible for
- Manufacturer mix the user works in (Crestron, Q-SYS, Extron, Biamp, Shure)
- Open service tickets and dispatch context

Do NOT remember:
- Personal contact information
- Specific contract dollar values
- Confidential client business details
```

## [Memory categories# ](#memory-categories)

### [Saved Facts# ](#saved-facts)

Concrete, verifiable information:

-   Names and roles.
-   Company / integrator firm information.
-   Manufacturer mix and standards.
-   Account and site details.

### [Preferences# ](#preferences)

How users like to interact:

-   Communication style (formal vs casual).
-   Response length preference.
-   Preferred formats (bullets vs paragraphs).
-   Language preferences.

### [Topic Highlights# ](#topic-highlights)

Key subjects from conversations:

-   Features or systems they are interested in.
-   Problems they are trying to solve.
-   Questions they have asked.
-   Projects or rooms they have discussed.

### [User Insights# ](#user-insights)

Inferred characteristics:

-   Technical expertise level (junior programmer vs senior commissioning engineer).
-   Decision-making authority.
-   Industry segment (corporate AV, higher-ed, broadcast, hospitality).
-   Use case patterns.

## [Viewing stored memories# ](#viewing-stored-memories)

Go to **Chats** > select a user > **Memories** to see:

-   All memories for that user.
-   When each memory was created.
-   Which conversation it came from.
-   Confidence score.

## [Managing memories# ](#managing-memories)

### [Editing memories# ](#editing-memories)

Click any memory to edit or correct it:

1.  Update the content.
2.  Change the category.
3.  Adjust the confidence score.

### [Deleting memories# ](#deleting-memories)

Remove memories that are:

-   Incorrect.
-   Outdated (the user changed firms, the project closed out).
-   No longer relevant.

Go to **Memories** > click the memory > **Delete**.

### [Bulk management# ](#bulk-management)

For compliance or cleanup:

-   **Delete all memories for a user**: User profile > Clear Memory.
-   **Export memories**: download as CSV for review.

## [Best practices# ](#best-practices)

### [What to remember# ](#what-to-remember)

**Do remember:**

-   Professional context (firm, role, manufacturer mix).
-   Stated preferences.
-   Key topics discussed.
-   Problems they are solving.

**Do not remember:**

-   Sensitive personal information.
-   Temporary states ("having a rough day on a closeout").
-   Information they asked you to forget.
-   Confidential client business data without consent.

### [Privacy considerations# ](#privacy-considerations)

> **Warning:** Always tell users your agent has memory capabilities. Consider adding to your system prompt: "I can remember relevant details from our conversations to provide better assistance. Let me know if you'd prefer I not remember something."

### [Memory in your system prompt# ](#memory-in-your-system-prompt)

Help your agent use memories well:

code 

```
You have access to memories about this user from past conversations.
Use these to:
- Personalize greetings and responses
- Avoid asking questions they've already answered
- Reference their specific context (firm, projects, manufacturer mix)

Don't:
- Mention that you "remember" things in a creepy way
- Assume memories are 100% accurate
- Reference memories if they seem outdated
```

## [How memory extraction works# ](#how-memory-extraction-works)

Memory extraction runs automatically after conversations:

1.  **Conversation ends**: user leaves or 10 minutes of inactivity.
2.  **Queued for processing**: the conversation enters the memory queue.
3.  **AI analysis**: GPT-4 analyzes the conversation for memorable facts.
4.  **Structured extraction**: facts get categorized and scored for confidence.
5.  **Storage**: memories are encrypted and stored with the user profile.

### [Extraction timing# ](#extraction-timing)

Trigger

When it happens

Inactivity

10 minutes without messages.

User leaves

Explicit session end.

Batch processing

Every 10 minutes for queued sessions.

### [Confidence scores# ](#confidence-scores)

Each memory has a confidence score (0 to 1):

-   **0.9 to 1.0**: explicitly stated by the user.
-   **0.7 to 0.9**: strongly implied.
-   **0.5 to 0.7**: reasonable inference.
-   **Below 0.5**: uncertain, may need verification.

## [Use cases# ](#use-cases)

### [Field service desk# ](#field-service-desk)

Remember:

-   Sites and rooms the tech works on.
-   Past tickets the tech has reported.
-   Preferred contact method.
-   Technical expertise level.

### [Pre-sales / RFP assistant# ](#pre-sales-rfp-assistant)

Remember:

-   Firm size and segment.
-   Active opportunities and project context.
-   Decision timeline.
-   Manufacturer preferences.

### [Internal AV operations agent# ](#internal-av-operations-agent)

Remember:

-   The user's role on the team (PM, programmer, lead engineer).
-   Active project assignments.
-   Communication preferences.
-   Recurring tasks (weekly reports, gear pulls).

### [Programmer onboarding agent# ](#programmer-onboarding-agent)

Remember:

-   Learning progress on Crestron SIMPL or Q-SYS Lua.
-   Topics mastered.
-   Areas needing work.
-   Preferred learning style.

## [Troubleshooting# ](#troubleshooting)

### [Memories not being extracted# ](#memories-not-being-extracted)

1.  Verify memory is enabled in settings.
2.  Check that conversations are ending properly.
3.  Allow 10 to 15 minutes for extraction to process.
4.  Verify the user is identified (not anonymous).

### [Incorrect memories# ](#incorrect-memories)

1.  Review and edit incorrect memories.
2.  Adjust custom extraction instructions.
3.  Add negative examples to your instructions.

### [Too many memories# ](#too-many-memories)

1.  Focus extraction on specific categories.
2.  Add instructions to prioritize durable facts.
3.  Periodically clean up outdated memories.

## [Limitations# ](#limitations)

Current limitations to keep in mind:

-   **Extraction delay**: memories are not available instantly (10+ minute delay).
-   **No real-time recall**: the current implementation extracts memories but does not automatically inject them into prompts.
-   **Token limits**: very long conversations may be truncated for extraction.

> **Note:** We are actively improving the memory system. Future updates will include real-time memory recall and more sophisticated memory management.

## [Using with MCP# ](#using-with-mcp)

You can access user memories through code using the AVCodex MCP Server.

### [Available tools# ](#available-tools)

Tool

Description

`get_user_memories`

Retrieve extracted memories for an application.

### [Example prompts# ](#example-prompts)

code 

```
"Show me user memories for my service desk agent"
"What facts has my agent learned about users?"
"List memories with high confidence scores"
```

### [Workflow: reviewing user insights# ](#workflow-reviewing-user-insights)

code 

```
You: Show me the memories my pre-sales agent has extracted.

AI: [Calls get_user_memories]
Found 47 user memories:

High confidence (0.9+):
- User "john@acmeintegration.com": Lead programmer at Acme Integration, 50-person firm.
- User "sarah@bigcorp.com": Director of corporate IT, evaluating a 40-room refresh, budget approved.

Medium confidence (0.7-0.9):
- User "mike@startupav.io": Technical background, comparing Crestron and Q-SYS for a new HQ build.
...
```

> **Note:** MCP server access requires a Builder plan or higher. See the [MCP Setup Guide](/docs/guides/mcp/setup) to get started.

\*AVCodex · Your AV expertise. Amplified by AI.\*

Was this helpful? 

[Edit this page →](#)

[

Previous

Knowledge Retrieval Settings

](/docs/guides/knowledge-retrieval-settings)[

Next

Consumer Brain

](/docs/guides/consumer-brain)

On this page

-   [What is User Memory](#what-is-user-memory)
-   [How it works](#how-it-works)
-   [Enabling User Memory](#enabling-user-memory)
-   [Memory categories](#memory-categories)
-   [Saved Facts](#saved-facts)
-   [Preferences](#preferences)
-   [Topic Highlights](#topic-highlights)
-   [User Insights](#user-insights)
-   [Viewing stored memories](#viewing-stored-memories)
-   [Managing memories](#managing-memories)
-   [Editing memories](#editing-memories)
-   [Deleting memories](#deleting-memories)
-   [Bulk management](#bulk-management)
-   [Best practices](#best-practices)
-   [What to remember](#what-to-remember)
-   [Privacy considerations](#privacy-considerations)
-   [Memory in your system prompt](#memory-in-your-system-prompt)
-   [How memory extraction works](#how-memory-extraction-works)
-   [Extraction timing](#extraction-timing)
-   [Confidence scores](#confidence-scores)
-   [Use cases](#use-cases)
-   [Field service desk](#field-service-desk)
-   [Pre-sales / RFP assistant](#pre-sales-rfp-assistant)
-   [Internal AV operations agent](#internal-av-operations-agent)
-   [Programmer onboarding agent](#programmer-onboarding-agent)
-   [Troubleshooting](#troubleshooting)
-   [Memories not being extracted](#memories-not-being-extracted)
-   [Incorrect memories](#incorrect-memories)
-   [Too many memories](#too-many-memories)
-   [Limitations](#limitations)
-   [Using with MCP](#using-with-mcp)
-   [Available tools](#available-tools)
-   [Example prompts](#example-prompts)
-   [Workflow: reviewing user insights](#workflow-reviewing-user-insights)

[](/)

The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry.

### Platform

-   What You Can Build
-   Templates
-   [Pricing](/pricing)

### Services

-   [Done-For-You](/pricing)
-   [Academy](/academy)
-   [Contact](/contact)

### Company

-   About
-   [The Signal](/blog)
-   [Docs](/docs)
-   [LinkedIn](#)

© 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant