Session
A session is a contextual container for a conversation between a user (or application) and an agent. It provides continuity across multiple interactions. Key properties include:
- A session key and human-readable name (
ase_12345
). If not provided, Vectara generates one automatically based on the name. - Associated
agent_key
(agt_abcd
) - Metadata such as end_user_id, application_id, priority, or channel
- Timestamps for creation and last update
Sessions support lifecycle operations such as creation, update, retrieval, listing, and deletion.
Agent events
Each session contains one or more events, representing individual interactions and system activities within the conversation:
- Input message events: User input with text content
- Thinking events: Agent reasoning and chain-of-thought processes
- Tool input/output events: Tool execution with parameters and results
- Agent output events: Final agent responses to user input
Events support both synchronous and streaming delivery, enabling real-time conversation experiences with progressive response building.
Example session and event
SESSION AND EVENT EXAMPLE
1