# 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 [agent-editor](https://docs.spara.com/agents/agent-overview/agent-editor "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    <!-- optional -->
## 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 %}

## 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, 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**.
