A session is a single investigation conversation within a project. Each session has its own conversation log, key results, and optional disposition.
Starting a Session
From a project detail page, click New Session. You will be prompted to:
- Optionally define a disposition schema if you want the session to produce a structured determination at the end (see Dispositions).
- Optionally add dependencies on other sessions in the project (see Dependencies).
- Describe what you want to investigate (the starting request).
- Click Start Session.
The AI receives your starting request along with the project's system prompt, tool instructions, any disposition schema context, and any upstream dependency context, then begins its investigation.
The Conversation Loop
The AI works through your request by making tool calls — querying the database, looking up metadata, searching the data model — and reporting back. Each tool call appears in the conversation as a collapsible message showing what the AI did and the result. The AI continues making tool calls until it has enough information to present findings to you.
A session can involve up to 35 tool calls. If the AI approaches this limit, it is prompted to wrap up its investigation and ask the user for feedback.
Interrupting a Session
While the AI is working (making tool calls and processing results), the session owner can click the Interrupt button to stop the AI mid-investigation. The button appears next to the "Thinking..." indicator whenever a session is actively running.
When interrupted, the AI stops at its next tool call boundary, acknowledges the interruption, and asks how you would like to proceed. The session remains open — you can give the AI new instructions, redirect the investigation, or ask it to wrap up.
Only the session owner can interrupt a session.
Following Up
After the AI presents its findings, you can type follow-up questions or requests in the input area at the bottom of the workspace. The AI picks up the full conversation context and continues the investigation.
Session Management
From the project detail page, you can:
- Rename a session using the pencil icon.
- Delete a session from the edit panel. If other sessions depend on this session, the confirmation dialog will warn you.
- Edit the disposition schema for a session (see Editing a Schema After Creation).
- Edit dependencies for a session (see Adding Dependencies).