> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insert and Edit AI Blocks in Retrospectives

> Insert Rootly AI blocks in a retrospective, watch them generate, inspect their sources, and edit, regenerate, convert, or rate the output.

## Working With AI Blocks in a Retrospective

When a retrospective is created from a template that contains AI blocks, those sections generate automatically. You can also add AI blocks to any document yourself.

For everything else about the editor, including formatting, data blocks, Liquid, and collaboration, see [Using the Retrospective Editor](/collaborative-retrospectives/using-the-editor).

***

## Insert a Block With the Slash Menu

<Steps>
  <Step title="Place Your Cursor">
    Put the cursor where you want the section.
  </Step>

  <Step title="Open the Slash Menu">
    Type `/` to open the menu.
  </Step>

  <Step title="Pick an AI Block">
    Choose one of the presets (Summary, Impact, What Happened, Contributing Factors, Learnings, Follow-Up Actions, Root Cause, Mitigation, Resolution, Curated Timeline) or a **Custom AI block**.
  </Step>

  <Step title="Describe a Custom Block">
    For a custom block, give it a title and a short prompt describing what you want.
  </Step>
</Steps>

The block is inserted and begins generating from the incident's context.

***

## See How a Block Was Generated

AI blocks aren't a black box. Open a block's details for a short description of what the block is for, plus:

* **The sources** it drew on: incident metadata, timeline events, the incident Slack channel, and the bridge-call transcript when available.
* **The system prompt** behind the block, so you know how it was instructed to write.

***

## Work With a Generated Block

A generated block behaves like the rest of your document. From the block's toolbar you can:

* **Edit inline.** Generated content is just text.
* **Regenerate.** Ask Rootly AI to write the section again. If you've changed the block's instructions, the new draft reflects them.
* **Convert to plain text.** "Freeze" the block. Its content becomes ordinary document text and is no longer a live AI block.
* **Delete.** Remove the block entirely.
* **Comment.** Works like anywhere else in the document.

<Warning>
  If you regenerate a block you've edited by hand, Rootly AI asks you to confirm first.
</Warning>

***

## Give Feedback

Rate any block with 👍 / 👎. Feedback flows into Rootly's evaluation pipeline and does not directly fine-tune the model.

***

## Exporting

When you publish or export a retrospective, AI block content is rendered as **static content** at the time of export. See [Exporting Retrospectives](/collaborative-retrospectives/exporting-retrospectives) for export destinations and options.

***

## Permissions

AI blocks follow your retrospective permissions; see [the overview](/ai/ai-in-retrospectives/overview#how-permissions-work).

***

<a id="faq" />

<a id="faqs" />

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What do I do if an AI block is stuck generating?" icon="star">
    Refresh the document. If a block fails to generate, you can regenerate it from its toolbar. If it keeps failing, the incident may have very little context for that section; try a different block or add detail to the incident.
  </Accordion>

  <Accordion title="Can I change how a block is written for every future retro?" icon="pen">
    Yes. Set custom instructions on the block in the template. See [Building AI Templates](/ai/ai-in-retrospectives/building-ai-templates).
  </Accordion>
</AccordionGroup>

***

## Related Pages

<CardGroup cols={3}>
  <Card title="AI in Retrospectives Overview" icon="house" href="/ai/ai-in-retrospectives/overview">
    What AI blocks are and how they draft your retrospective.
  </Card>

  <Card title="Building AI Templates" icon="wand-magic-sparkles" href="/ai/ai-in-retrospectives/building-ai-templates">
    Add AI blocks to a template and preview them against a past incident before rollout.
  </Card>

  <Card title="Using the Retrospective Editor" icon="computer-mouse" href="/collaborative-retrospectives/using-the-editor">
    The editor AI blocks live in, with formatting, data blocks, Liquid, and collaboration.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.