Summation’s AI data analyst — ask questions, build artifacts, and work with your data in plain English.
Addison is the AI analyst behind everything Summation does with your data. Ask a question in plain English and Addison writes the SQL, reads the results, and answers with tables, charts, and explanations — or builds a report, deck, or dashboard when the answer deserves one. Every chat is scoped to a project, so Addison works from that project’s data, files, and knowledge.
Open Addison with the sparkle button at the top of the left sidebar, or type straight into the composer on Home. Pick the project the chat should use — that choice sets what Addison can see, and it’s fixed once the conversation starts. Without a pick, the chat uses your default project.
Toggle the Addison pane
Pick the project a chat uses
POST /v1/projects/{projectId}/conversations
Start a conversation with Addison and stream the response.
Ask in plain English — “What drove the revenue change in Q3?” beats a keyword search. The controls around the input add context and change how Addison works:
Control
What it does
+
Upload files, add files from the project, or reach a connected app
Addison already reads the project’s data and knowledge. Add more for a specific question:
Upload Files — attach a file from your computer to this conversation.
Add files from project — pull in something already in the project.
App connectors — let Addison work with a connected app such as Shopify or PostHog. Connecting an app isn’t enough on its own: the submenu (gated by the ui_mcp_connectors flag) lists only active connectors, and each carries a per-chat toggle you must switch on before Addison can use it in this chat. If none are connected, Add new connector takes you to Connectors.
@ mentions — the fastest path: type @ and pick a file or folder, each shown with its path.
Attach files or reach an app
Mention a file with @
POST /v1/projects/{projectId}/files/uploads
Upload a file into the project a conversation reads from.
Type / for skills — named workflows that put Addison straight into a specific job instead of describing it. /report writes a report, /verify-and-correct fact-checks work against its sources, and /remember teaches the project something durable.You rarely need them — asking in plain English gets you to the same place — but they’re the shortest path when you know exactly what you want.
The Default model suits most work. When your workspace allows per-request model selection, the selector lists the models you can pick (grouped by provider, which may include Anthropic, OpenAI, DeepSeek, xAI, Z.ai, and Kimi) and sets Effort, which trades speed for depth of reasoning (this control is labelled Mode for models that expose mode options). Raise it for a gnarly analysis; leave it alone for a quick lookup. When per-request selection is off, only the default model is returned and there’s no provider list to open.
Addison narrates as it works — each step it takes (checking a skill, finding tables, running queries) appears as a collapsed line you can expand to see exactly what it did. That trail is the point: you can audit how an answer was reached, not just read the conclusion.Answers come back as prose, tables, charts, or single metrics, depending on the question. When Addison produces an artifact, it lands as a card at the end of the response with an Open button — and it’s a real file in the project from that moment on. Copy the response, retry it, or rate it with the controls beneath.
A finished response, with the artifact it produced
GET /v1/projects/{projectId}/conversations/{chatId}
Every conversation is its own thread, kept under Recent chats in the left sidebar. Threads hold context, so follow-ups work — “now break that down by region” needs no repetition of the original question.The pane itself adapts: switch between Sidebar (alongside your work), Floating, and Full screen from the panel icon in the pane header. Sidebar is the default and keeps Addison next to the artifact you’re editing.
Recent chats
Sidebar, floating, or full screen
GET /v1/projects/{projectId}/conversations
List conversations.
POST /v1/projects/{projectId}/conversations/{chatId}/messages
Send a follow-up message in an existing conversation and stream the reply.
GET /v1/projects/{projectId}/conversations/{chatId}/messages/{messageId}/events
Re-stream a message’s events to resume watching a reply after a dropped connection.
POST /v1/projects/{projectId}/conversations/{chatId}/messages/{messageId}/feedback
Rate an assistant message — the API behind the thumbs-up / thumbs-down controls.