# Product Demo The **Product Demo agent** delivers live, interactive product demos over voice. It narrates your product's key features, shows matching screenshots on screen, answers questions naturally, and books a follow-up meeting at the end, all without a rep on the call. Product Demo agents let every interested visitor get a fast, personalized walkthrough the moment they want one, instead of waiting for a human demo slot. {% hint style="info" %} The Spara team handles the initial setup for your Product Demo agent. Your starting prompt, topics, screenshots, and opening slide are built for you before handoff. Once you're live, you control the sections described below. {% endhint %} ## Editing the AI Instructions The AI Instructions are the natural-language prompt that drives your Product Demo agent's behavior: how it introduces itself, which topics it covers, how it handles pricing questions, and how it wraps up the call. To edit them, open [**Product Demo**](https://app.spara.co/settings/product-demo), click into your agent, and go to the **Instructions** tab. The prompt is broken into sections with clear headers. You can edit any of the sections listed under *Sections you can edit* below. Please leave the sections under *Sections currently managed by Spara* alone. Those depend on tools and pacing logic that Spara tunes centrally, and changes there can break calendar booking, call termination, or the agent's ability to show visuals. ### Sections you can edit * **IDENTITY AND PRIMARY OBJECTIVE**: who the agent is and what it's trying to accomplish on the call * **PRONUNCIATION**: how to pronounce brand names, acronyms, and any tricky terms * **DEMO FLOW**: the order and pacing of the demo * **PRICING**: how the agent talks about pricing when a prospect asks * **BOOKING AND WRAP-UP**: how the agent ends the call and books a follow-up meeting * **COMPETITOR EMPLOYEE RULE**: how the agent handles someone from a competitor * **VOICE RULES**: delivery style, sentence length, pauses, no markdown, etc. * **SELLING PRINCIPLES**: your high-level philosophy on how the agent should sell * **DEMONSTRATION STYLE**: tone and interaction style during the walkthrough ### Sections currently managed by Spara * `show_calendar_widget` * `end_call` * **OFF-TOPIC** * **TOOL USAGE FOR DEMONSTRATIONS** * **PROGRESSIVE DISCLOSURE AND PACING** If you need changes to any of these sections, reach out to the Spara team. ### Saving and publishing Save changes to the prompt by clicking **Save draft**. Drafts are safe to iterate on. They don't affect prospects until you publish them, and you can test a draft using the demo link described in [#testing-your-agent](#testing-your-agent "mention"). Click **Publish** when you're happy with the results. The published version is the one your prospects interact with. For more on the draft/publish flow, see [https://github.com/spara-ai/spara-app/blob/gitbook/gitbook/documentation/agents/agent-overview/agent-editor.md](https://github.com/spara-ai/spara-app/blob/gitbook/gitbook/documentation/agents/agent-overview/agent-editor.md "mention"). ## Topics A **topic** is a single unit of your demo: one feature, value prop, or story, along with the screenshots the agent shows while narrating it. Your agent chooses which topics to cover and in what order based on what the prospect is interested in, so good topic content is what makes the difference between a generic pitch and a tailored walkthrough. Topics are shared across all Product Demo agents in your account. ### Creating and deleting topics Open [**Product Demo**](https://app.spara.co/settings/product-demo), click the **Topics** tab, and click **Create new** to add a topic. Click an existing topic to edit it, or use the delete action to remove one you no longer need. ### Editing a topic Each topic has a **Description** (markdown content the agent reads) and one or more **Visuals** (screenshots or images it can show on screen during the demo). **Description.** The description is what the language model reads when deciding how to narrate this topic. Keep it dense and concrete. Think "notes for a rep", not marketing copy. Spell out the exact proof points, objection-handling lines, and examples you want the agent to draw from. The base prompt is tuned to look for a specific markdown structure in every topic, so sticking with these headers gives the best results: ```markdown ## Hook ## Key Points ## Proof ## Key Q&A ``` Add as much guidance under each header as you need. The more specific, the better the narration will be. **Visuals.** Every topic should have **at least one visual**. Visuals are the screenshots the agent displays while narrating this topic. Add more than one if you want the agent to walk through multiple screens for the same topic; leave it at one if the topic is mostly conceptual. Use the visual selector on the topic page to attach assets. {% hint style="info" %} A topic without a visual will still work, but the agent won't have anything to show on screen while it's talking. Prospects get a much better experience when every topic has at least one image tied to it. {% endhint %} ## Documents The **Documents** tab in Product Demo settings lets you upload source documents — PDF, DOCX, or Markdown files — that the demo's ingestion pipeline uses to build knowledge for your agent. Use this for demo-specific reference material (white papers, battlecards, detailed feature specs) that you don't want appearing in the main Knowledge Base. Documents uploaded here are excluded from the Knowledge > Documents tab. To upload a document, open [**Product Demo**](https://app.spara.co/settings/product-demo), click your agent, and go to the **Documents** tab. Click **Upload** and select a PDF, DOCX, or Markdown file. The document is processed in the background once uploaded. To edit or remove a document, click it in the list to open the edit drawer. ## Opening slide The Spara team currently controls the opening slide for your Product Demo agent. This is the first screen a prospect sees when the demo loads. If you want to change what's shown there, reach out to us and we'll update it for you. ## Testing your agent To test a Product Demo agent end-to-end, open the agent from the **Agents** tab and click **Open demo**. This launches the demo in a new tab in test mode, running exactly as a prospect would experience it: voice, visuals, calendar booking, and all. Use it to review your changes before publishing, and share the link with teammates on your Spara account for feedback. The workflow is: click **Save draft**, open the demo, talk through your changes, and then click **Publish** once you're happy with how the agent sounds. ## FAQ ### Who controls what? The Spara team handles initial onboarding: your starting prompt, the first set of topics, the screenshots tied to each topic, and the opening slide. After handoff, you control the editable sections of the AI Instructions, the topic descriptions and visuals, the documents, and when to publish changes. For anything else (opening slide, tool sections of the prompt, or structural changes), reach out to Spara. ### How do I know if a topic is working? Open the demo with **Open demo** and ask the agent directly about that topic. Listen for whether it mentions the hook, covers the key points you listed, and uses the right proof. If it's skipping things, tighten up the description and try again. ### Can I test a draft before publishing? Yes. Click **Save draft**, then click **Open demo** from the agent page. The demo runs in test mode against your latest saved state, so you can iterate on the prompt and topics before clicking **Publish**. ### Can I link directly to the Product Demo from an email or CTA? Yes. You can trigger a Product Demo session by calling `SparaActions.openProductDemo()` on your website. For email campaigns, add a query parameter to your landing page URL (e.g., `?demo`) and include JavaScript on your site that checks for the parameter and opens the demo automatically. See [Opening Spara using Javascript](https://github.com/spara-ai/spara-app/blob/gitbook/gitbook/developers/spara-api/javascript-api.md#opening-spara-using-javascript) for setup instructions and code examples. --- # Agent Instructions: 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: ``` GET https://docs.spara.com/agents/product-demo.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.