Skip to main content
The User Profile Store captures structured fields about users: name, preferred name, and custom fields you define.

Basic Usage

Always Mode

Extraction happens automatically after each response. No tools are visible to the agent.
The tradeoff is an extra LLM call per interaction.

Agentic Mode

The agent receives an update_profile tool and decides when to update.
The tradeoff is that the agent may miss implicit profile info.

Default Fields

Custom Schemas

Extend the base schema for your domain:
The metadata["description"] tells the LLM what each field captures.

Accessing Profile Data

Context Injection

Profiles are automatically injected into the system prompt:
No manual context building is needed.

User Profile vs User Memory

Use User Profile for: name, company, role, preferences with defined values. Use User Memory for: observations like “prefers detailed explanations” or “works on ML projects.”