The scenario
A rep leaves. Their accounts go to someone else, along with a CRM full of activity records and none of the understanding — who actually decides, what they objected to last time, what was promised on a call in March. The next conversation starts from zero, and the customer notices.Step 1 — Scope every note to the account
user_id is the account the note is about, agent_id
is who wrote it. The account is what survives the handover.
Step 2 — Brief the new owner in one call
Step 3 — Ask the questions a handover should answer
Step 4 — See what the previous rep was working on
Evals
- Write fifteen notes on one account across three months from two different reps.
- Run the handover question. Check it surfaces commitments from both reps.
- Ask about an account with no notes — it should say so rather than generalise from similar accounts.
- Have the receiving rep read the briefing before their first call and tell you what was missing. That gap list is your note-taking convention.
Guardrails
- A commitment recorded is not a commitment tracked. Memory will tell you what was said; it does not chase it. Keep the obligation in the system that has dates and owners.
user_idis your identifier for the account. Keep it stable — renaming it orphans every memory written under the old one.- Don’t mirror the CRM. Record the understanding, not the activity log; the CRM is already better at the latter and the noise degrades retrieval.
Built from
Both are complete, runnable scripts:support_bot_scoping.py,
user_profiles.py.