Skip to main content
Version: 2.0

Sessions

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

Session workflow example​

Here's how to create a session and start chatting with an agent:

CREATE SESSION AND CHAT
1
tip

Sessions persist conversation history, so subsequent messages in the same session will have context of previous interactions. This enables natural, multi-turn conversations with the agent.