Agent Memory

FIRST INTERACTION (call or SMS)
├── Contact: "Hi, I'm Sarah, calling about order 4521"
├── Agent handles the conversation
└── After interaction ends:
    ├── AI generates summary
    ├── Extracts key topics
    ├── Identifies preferences
    └── Stores in memory database

NEXT INTERACTION (same contact - call or SMS)
├── Agent recognizes contact's phone number
├── Loads their memory:
│   ├── "Sarah, 2 previous interactions"
│   ├── "Topics: order 4521, delivery issues"
│   └── "Prefers email follow-ups"
├── Injects context into system prompt
└── Agent provides personalized service

"Sarah is a regular customer who has placed 3 orders. She had a
delivery issue with order #4521 that was resolved. Prefers to be
contacted by email. Generally satisfied with service."

{
  "contact_method": "email",
  "best_time": "afternoons",
  "language": "Spanish preferred",
  "accessibility": "speak slowly"
}

## CALLER MEMORY
You have spoken with this caller (Sarah Johnson) 3 time(s) before.

Summary of relationship: Regular customer, had delivery issues with
order #4521 that were resolved. Prefers email follow-ups.

Key topics discussed: orders, delivery, refunds

Caller preferences: {"contact_method": "email", "best_time": "afternoons"}

Use this context to provide personalized service. Reference past
conversations naturally when relevant, but don't be creepy about it.

You are a customer service agent for ACME Corp.

WHEN SPEAKING WITH RETURNING CALLERS:
- Reference past conversations naturally ("I see you called about...")
- Don't repeat information they already know
- Acknowledge their history as a customer
- If they had issues before, proactively check if resolved

IMPORTANT:
- Don't be creepy about knowing things - only reference what
  came up in actual conversations
- If memory seems wrong, trust the caller ("Let me update that")

If the caller says your memory is incorrect, apologize and
update your understanding. Say: "Let me correct that in my notes."

# Get memories for an agent
GET /conversation-contexts?agent_id={agent_id}

# Get specific memory
GET /conversation-contexts/{id}

# Update memory
PATCH /conversation-contexts/{id}

# Delete memory
DELETE /conversation-contexts/{id}