> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/for-users/agents/powerpoint-agent.md).

# PowerPoint Agent

{% hint style="warning" %}
**Beta feature**

The PowerPoint Agent is currently in beta. It's fully usable, but behavior, options, and output may change as we refine it. Always review generated decks, especially figures and citations, before external use. Your feedback shapes what ships next.
{% endhint %}

### What it is

The agent takes a written brief and a set of source documents and gives you back a complete deck, built on your company template.

You describe the audience, purpose, and key messages and point it at your sources; it structures the deck, builds each slide, and grounds the content in those sources.

### How it works

The following list details the ideal ingredients to achieve the best results in terms of quality and accuracy:

* **Template:** your branded deck. The agent works inside it, so output quality is bounded by template quality.
* **Brief:** the audience, purpose, and key messages. Your brief sets the deck's structure and emphasis; a thin brief gives you a generic deck.
* **Sources:** the documents it draws facts from and cites. Content is grounded in these rather than produced from the model's own knowledge.
* **Plan:** before generating slides, the agent lays out the deck's structure in a single pass.
* **Slides:** built from the plan and mapped to your template's layouts.

You can also start with a simple straight forward prompt and select from the available default templates and iterate accordingly.<br>

{% embed url="<https://app.usebubbles.com/5HKW5qmYhbrvK6GJu4njP5>" %}

#### Two ways to build: Mirror vs Fidelity

When generating a deck you can leverage two very distinct modes with two different degrees of freedom for the agent:

**Mirror: Deterministic.**

Preserves the template slide by slide, section by section, component by component, replacing only the text with the output of your chat and agentic search. It changes the content, not the design.

* Keeps output on-brand: the template is preserved; only text is swapped.
* Produces standardised, repeatable decks: the same structure on every run.
* Most useful for reoccurring use cases from material you already have:
  * quarterly reviews, status updates, proposals, account summaries.

*Mirror is only as strong as the template beneath it: a weak template produces weak slides.*

**Fidelity: Generative.**

Builds slides within your template's layouts, including slide types the template doesn't already contain.

* Handles new or unplanned topics the template was never built for.
* Produces slides beyond the template's fixed set, still on its layouts.
* Adapts the layout to the material instead of forcing it into a placeholder.
* Best useful for discovery, new topics, ideation and producing new element that are not available in your template.

*Because Fidelity composes, brand-critical elements can vary between runs: always double-check them.*

The quick distinction: **Mirror is faithful to the template. Fidelity is faithful to the layout.**

<figure><img src="/files/YsBLb65XZAaGg7rQq7XY" alt=""><figcaption></figcaption></figure>

**Your part in this:** give it a clear brief and good sources, then review the finished deck, figures and brand-critical slides especially before it goes out.

### Before you start

A couple of things to have ready:

* **Access** to the PowerPoint Agent.
* **A template:** either admin-provided or one you upload.
* **Your source materials:** uploaded, or already in your knowledge base.
* **Permissions** to run the agent and reach those sources.

### Quickstart

The short version: from nothing to a finished deck:

1. Select the PowerPoint Agent.
2. Select your template.
3. Enter your brief: audience, purpose, key messages and point it at your sources.
4. Choose a mode: **Mirror** to replicate the template exactly, **Fidelity** to generate slides beyond it.
5. Generate.
6. Review: figures against your sources, plus the cover, closing, footer, and numbering.
7. Export the deck.

### How-to guides

Jump to whatever matches what you're doing.

**Generate a recurring deck (like a QBR):** Give it the audience and period, list your fixed sections, and attach the sources that hold the figures. Brief the content, not the design: the template and mode take care of layout.

**Ground the deck in specific documents:** Point it at the exact sources rather than leaving it to search. Narrower scope means more faithful content and makes every claim easy to trace.

**Use Mirror for cover, closing, and agenda slides:** These need to reproduce the brand exactly, and Mirror populates the template without changing it.

**Use Fidelity for topics your template doesn't cover:** For slide types outside your template's fixed set, Fidelity builds them on your template's layouts.

**Verify figures before you share:** Treat every figure as unconfirmed until you've checked it against the source, including that each citation points where it claims to.

**Regenerate rather than repair:** If a run misses, refine the brief and run it again. Because output varies between runs, you'll get a genuinely different result, not the same one back.

**Update the template, not the deck:** The template carries all the branding, so changing it changes every deck that follows. If output is consistently off, the fix is usually in the template rather than the brief.

### Good to know (limits & what to verify)

**Before anything goes to an external audience,** confirm the figures are right and that each citation resolves correctly. The agent grounds content in your sources, but the final check is yours.

* **It's non-deterministic:** the same brief can produce different decks, so give the run you keep a quick review before you rely on it.
* **Fidelity can vary brand-critical elements:** closing slides, footers, numbering, and fonts may be inconsistent between runs. Put those slides in Mirror, or check them.
* **Output is bounded by the template:** sparse or loosely built templates give weaker results. If something looks off, look at the template first.
* **Check complex objects:** make sure tables and charts actually rendered, rather than showing up as empty placeholders.
* **Generation is all-or-nothing per run:** if part of the deck can't be produced, you may need to retry the run.


---

# 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.blockbrain.ai/for-users/agents/powerpoint-agent.md?ask=<question>&goal=<endgoal>
```

`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.