Skip to main content
A conversation keeps rolling context across turns so follow-ups like “how does that compare to Q3?” resolve correctly.

Start a session

The returned session_id is opaque — store it in your app state.

Continue a session

Under the hood this calls query() with maintainContext: true and the sessionId attached. You can do that yourself — continueConversation is just a named shortcut.

Stream a session turn

Use queryStream with the session ID:

List + inspect conversations

Delete

Deletes the session record and its rolling history. Source documents and facts are unaffected.

Scope a session to specific uploads

Useful for per-conversation knowledge isolation (e.g. customer-specific bots):
The retrieval restricts itself to those uploads for this session.