Skip to main content

​
User Preferences & Personalization

Every user can customize their AgentFlow experience — from which LLM model the agent uses, to the tone and style of responses, to which capabilities are enabled.

​
Settings API

​
Get current settings

GET /settings
Returns the merged settings (user overrides + platform defaults).

​
Update settings

PATCH /settings
{
  "personalization": {
    "baseStyleTone": "concise and professional",
    "customInstructions": "Always include action items at the end",
    "aboutUser": "I'm a VP of Customer Success managing a team of 12 CSMs"
  },
  "model": {
    "selectedModel": "anthropic/claude-sonnet-4"
  }
}

​
Reset to defaults

POST /settings/reset

​
Get platform defaults

GET /settings/defaults

​
Settings categories

​
Personalization

SettingTypeDescription
baseStyleTonestringResponse style (e.g., “concise”, “detailed”, “casual”)
customInstructionsstringPersistent instructions applied to every conversation
aboutUserstringContext about the user (role, team, preferences)
Personalization is injected into the agent’s context only when it’s relevant — the agent sees the user’s profile but is instructed to use it naturally, not robotically.

​
Model selection

SettingTypeDescription
selectedModelstringDefault model for all agent interactions
pinnedDefaultModelstringFallback model when no preference set
backgroundModelstringModel for background operations (title generation, memory)

​
Capabilities

SettingTypeDescription
enableRetrievalbooleanRAG from attached knowledge bases
enablePlanningbooleanMulti-step task decomposition
enableReflectionbooleanSelf-evaluation of responses

​
Generation parameters

SettingTypeDescription
reasoningEffortstringDefault reasoning depth (low, medium, high)
reasoningSummarystringReasoning output mode: "auto", "concise", "detailed"

​
Behavior

SettingTypeDescription
streamingbooleanEnable response streaming (default: true)
followUpEnabledbooleanSuggest follow-up questions
autocomplete.enabledbooleanEnable input autocomplete suggestions

​
Adaptive memory

Beyond explicit settings, AgentFlow automatically learns user preferences through background preference learning. After conversation activity settles, a background process analyzes recent interactions and distills durable facts and preferences into a persistent memory block — no user action required. This means the agent gradually learns things like:
  • “This user prefers bullet-point summaries”
  • “This user manages the Acme and Globex accounts”
  • “This user always wants meeting prep to include recent email context”
The memory is stored per-user and injected as context for future conversations — no manual configuration required.

​
Memory API

# Memory is managed automatically, but can be read/updated via:
GET /memory
PATCH /memory
DELETE /memory