Session Management
A session is one user's chat with an agent. Strongly tracks every session so you can see who's chatting right now, end a session that's gone wrong, and enforce limits like max concurrent sessions per user.
The Sessions tab on each agent's page shows them live — the table updates as state changes, no refresh needed.
Session states
| State | Meaning |
|---|---|
| Live | Active conversation. |
| Idle | No activity recently — the agent is still available; the user just hasn't said anything. |
| Paused | You explicitly paused the session. Resume it any time. |
| Ended | Closed. Either the user / admin ended it, or it hit idle / max-duration limits. Terminal. |
Sessions move from live to idle to ended automatically based on your session policy.
Session policy
Set on the Session Policy tab when building an agent and editable later in Agent Settings → Session Policy. Five settings:
| Setting | What it does | Default |
|---|---|---|
| Idle timeout | After this much inactivity a live session goes idle, then ends. | 30 minutes |
| Max duration | Hard cap on total session length. | 4 hours |
| Max concurrent per user | How many active sessions one user can have with this agent. Blank means unlimited. | Unlimited |
| Auto-archive after | Days an ended session stays before it's removed from the list. | 30 |
| Allow per-session model override | When on, admins can pick a different model for one specific session. | Off |
Actions on a session
From the Sessions tab, for each non-ended row:
- End — close the session. The chat history stays on the thread; only the session lifecycle row closes.
- Pause / Resume — temporarily put a session on hold.
- Transfer — hand a session to another agent. The source session ends; the target agent picks up on the user's next turn.
When to end a session manually
- Compliance — pull a misbehaving user's active session.
- Cost — long-running summary chains pile up; ending and starting a new session gives the agent a fresh start.
- User confusion — sometimes the cleanest path is a clean slate.
End is idempotent. Ending an already-ended session is a no-op.
Permissions
- The user owning the session can end / pause / resume / transfer their own session.
- The agent owner sees and controls every user's session.
- Admins see and control every session.
See also
- Agent Builder wizard
- Agent Settings → Session Policy tab