Conversations
A conversation is the live session between a user and an agent. It captures the message history, the current step, and the outcome.
Why It Matters
Conversations let you:
- Resume a user where they left off
- Track outcomes and escalation reasons
- Audit what the agent did and why
Conversation Lifecycle
A conversation moves through these statuses:
| Status | What It Means |
|---|---|
active | The agent is still working with the user |
paused | The flow ended but can be resumed later (for example, after a done step with pause_for_resume) |
completed | The goal is done and the conversation ended |
escalated | Handed off to a human |
abandoned | The user stopped responding |
Conversation ID
Every conversation has an ID. You use it to:
- Continue the conversation in the Converse API
- Fetch history or audit logs
- Resume after a pause
Turns And History
A conversation stores turns (user, agent, system) so you can review what happened and when.
Audit Logs
Audit logs record routing decisions, step transitions, action calls, and timing. They provide the accountability layer behind Supervised Intelligence.
Where It Shows Up
- Playground: test and inspect live conversations
- Analytics: see conversation volume and outcomes
- API: fetch history and audit logs