> For the complete documentation index, see [llms.txt](https://docs.spara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spara.com/platform/ask-spara.md). # Ask Spara **Ask Spara** is the AI assistant built into the Spara platform. It's one chat that follows you across every page: ask it how something works, have it build or change an agent for you, edit the data you track, or get an answer straight from your analytics — without leaving the page you're on. Instead of a separate helper on each page, Ask Spara is a single assistant that carries context from one task to the next. You can describe what you want in plain language, and it does the work or walks you through it.

Ask Spara open in the side rail, ready to answer a question or take on a task.

## Where to find it Ask Spara is available from anywhere in the platform in two forms: * **Side rail** — a compact panel that slides in alongside whatever page you're on, so you can ask a question without losing your place. * **Fullscreen** — expand the rail to a full [**Ask Spara**](https://app.spara.co/ask-spara-ai) page when you want more room, a wider view of a change, or to review past conversations in the sidebar. The suggestions in the composer are aware of the page you're on — open it from Analytics and it suggests analytics questions; open it from Workflows and it suggests workflow tasks.

The fullscreen view, with past conversations listed in the left sidebar.

## What you can do ### Answer product and how-to questions Ask Spara answers questions about how to use the platform, grounded in Spara's documentation, right inside the chat. It's the fastest way to learn how a feature works or find the right setting without leaving what you're doing. ### Build a new agent Describe the agent you want and Ask Spara builds it with you. It creates a new channel from the conversation, takes you to its configuration, and keeps refining as you give feedback. Ask Spara can build across every channel — [Chat](/build/channels/chat.md), [Email](/build/channels/email.md), [SMS](/build/channels/sms.md), [Phone](/build/channels/phone.md), and [Product Demo](/build/channels/product-demo.md) — as well as [Workflows](/build/workflows.md). For a step-by-step walkthrough of the whole agent, see [Agents](/build/agents.md). {% hint style="info" %} Building agents requires the **Agent edit** permission. Admins have this by default; other roles can be granted it by an admin under [User Management](/platform/settings/user-management.md). {% endhint %} ### Change an existing agent Ask Spara edits agents you've already built. Tell it what to change on a channel's prompt or configuration, and it proposes the edit as an **edit card** — a diff-style preview of exactly what will change, with a conflict check against your current setup. Click **Apply** to accept it. Changes save to your draft; nothing goes live until you publish. This works across Chat, Email, SMS, Phone, and Product Demo channels, as well as Workflows. {% hint style="info" %} Ask Spara is also embedded directly in the channel editor as a right-hand panel. See [Configuring Channels](/build/channels/configuring.md) for how it works while you're editing a single channel. {% endhint %} ### Edit your data model Ask Spara can add, rename, or adjust the [Data Model](/build/data-model.md) Spara tracks, straight from the chat. This changes what data Spara collects — not just the agents that use it — so you can evolve your data model without opening the editor yourself. ### Answer analytics questions Ask questions about your performance and Ask Spara answers them from your [Analytics](/pipeline/analytics.md). Because these answers map to the same metrics shown on the Analytics page, what Ask Spara tells you always matches what you see there. Each account only ever sees its own data. ### Navigate the platform Ask Spara points you to the right page and can take you there directly, so you spend less time hunting through the platform for the setting or view you need. ## How it works A few things make Ask Spara feel like one continuous assistant rather than a series of one-off prompts: * **Context awareness** — it knows what page you're on and what you've built, and carries that context across tasks within the same conversation. * **Conversation history** — your chats are saved, so you can leave and pick a conversation back up later from the sidebar. * **Upload a file** — attach a document or image to build or edit from it. Supported formats include PDF, Word (.docx), images (PNG, JPG, etc.), and most other file types up to 5 MB. For example, paste in a sales playbook to turn it into an agent. * **In-chat controls** — Ask Spara uses inline controls like single- and multi-select questions, quick replies, and instruction-edit cards, so you can steer it with a click instead of typing everything out. * **Live progress** — while it works, Ask Spara shows what it's doing and condenses the intermediate steps, so you can follow along. * **Feedback** — give a thumbs up or down to help improve answers over time. * **Share a conversation** — click the link icon in the side rail to copy a share link. Anyone in your organization who opens it lands on the same conversation, read-only, with the thread open. ## FAQ ### Does Ask Spara change anything without my approval? No. When Ask Spara proposes a change to an agent, it shows an edit card you have to **Apply**, and applied changes save to your draft. Nothing affects live behavior until you publish the channel or workflow yourself. ### Can other accounts see my data through Ask Spara? No. Ask Spara only ever works with your own account's data. Analytics answers are scoped to your account and match what appears on your Analytics page. ### Is Ask Spara the same as the assistant in the channel editor? They're the same assistant in different places. The in-editor panel is focused on the single channel you're editing; the platform-wide Ask Spara carries context across pages and can build and change agents, edit your data model, and answer analytics questions. See [Configuring Channels](/build/channels/configuring.md). ### Are my Ask Spara conversations saved? Yes. Conversations in the rail and fullscreen views are saved to your history, so you can resume them later. You can also start a new chat at any time with **New chat**. ### Can I share an Ask Spara conversation with a teammate? Yes. Click the link icon in the side rail to copy a share link. Teammates in your organization who open it can read the conversation thread. Share links are read-only — the recipient cannot continue the conversation or make changes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.spara.com/platform/ask-spara.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.