Attachments

Attach files and queries in chat so Zoë can analyze external data and use structured results as context.

Attachments let you bring external files and structured queries directly into your conversation with Zoë. Use them to ground your analysis with specific data — whether that's a CSV from a colleague, a PDF report, or a query against your data model.

Attachments dropdown

Click the + icon in the chat input to open the attachments dropdown. From here, choose one of two options:

• Upload a file — Attach CSVs, images, PDFs, and other supported file types (up to 5 files per message, 25 MB each).
• Run a query — Build a query from your data model's metrics and slices, or write raw SQL, and attach the results.

The attachments dropdown in the chat input

File attachments

Upload files when you need Zoë to work with data that lives outside your warehouse — spreadsheets, exported reports, screenshots, or reference documents.

CSV example

Select a CSV from the upload dialog to attach it to your message. Zoë reads the file contents, infers the schema, and treats the data as first-class context for the rest of the conversation.

CSV attachments in chat don't persist to your data model. Files uploaded in a chat conversation are used only within that conversation (including in any Artifacts Zoë creates) — they don't create views or fields that Zoë can query later. For persistent data, upload the file through Context Manager instead; that creates a proper view that Zoë can reference from any question.

Attaching a CSV file to the conversation

Once the file is attached, ask Zoë to chart the data, compute summary statistics, or surface trends. She has full access to the file contents and can reference specific rows and columns in her responses.

Zoë analyzing an attached CSV with charts and narrative insights

Query attachments

Query attachments let you build and run structured queries against your data model without leaving the conversation. Select metrics, apply slices and filters, review the results, and then ask Zoë follow-up questions — all in one place. In Exploratory mode, you can also write or paste raw SQL instead of selecting metrics and slices.

Beyond the Explore page

If you're familiar with a traditional BI Explore page, think of query attachments as the conversational equivalent of an Explore page. Rather than context-switching to a separate query builder, you compose the same kind of query — metrics, dimensions, filters — right inside the chat input.

To start a fresh exploration, click the New Explore button in the navigational sidebar. This opens a new chat with a blank query attachment pre-loaded and selected, so you can immediately begin defining your query. From there, run the query, review the results, and continue the conversation with Zoë to refine your analysis, add visualizations, or drill into the data.

Building a query attachment

Select Run a query from the attachments dropdown, then search for metrics and slices from your workspace to assemble a query. Zoë uses the returned results as context when answering your message.

Selecting metrics and slices for a query attachment

Visualizations

After you attach a query, Zoë can generate charts and visualizations from the results. She identifies the appropriate chart type based on the data shape and highlights key takeaways automatically.

Zoë generating a visualization from attached query results

Citations

When Zoë references specific values from an attached query in her written analysis, each value includes a citation. Click any citation to trace it back to the exact row and calculation in the source data — giving you full transparency into how every number was calculated.

Inline citations linking narrative text back to query results