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

# AI Builder

> Tell AI Builder what you need, and it will create a clinical AI agent for you.

On the create assistant page, **Build with AI** opens a side chat. You describe the letter you want. The assistant thinks, replies, and fills the writing fields. You still choose **Clinic**, then save.

Nothing in the chat is saved until you press **Save as Draft** or **Save & Activate**.

<Steps>
  <Step title="Open the create assistant page">
    Open the create assistant page. Next to the page title you will see **Build with AI**.

    <Frame caption="Create assistant page with the **Build with AI** button next to the title.">
      <img src="https://mintcdn.com/medwriteai/_al075lHfve34oUu/images/image-3.png?fit=max&auto=format&n=_al075lHfve34oUu&q=85&s=86ce99beaf7d7e72e5932ae5695f95b5" alt="Image 3" style={{ borderRadius:"0.5rem" }} title="Image 3" width="2549" height="958" data-path="images/image-3.png" />
    </Frame>
  </Step>

  <Step title="Describe the assistant">
    Select **Build with AI**. A chat panel slides in from the right, and the form stays visible beside it.

    <Frame caption="Side chat opened from **Build with AI**.">
      <img src="https://mintcdn.com/medwriteai/BzS_Tksx7GfS2Dso/images/Screenshot_23-9-2026_11915_dev.medwrite.ai.jpeg?fit=max&auto=format&n=BzS_Tksx7GfS2Dso&q=85&s=3c88522c53dc6fe91b20ce80911883ac" alt="Screenshot 23 9 2026 11915 Dev Medwrite Ai" style={{ borderRadius:"0.5rem" }} title="Screenshot 23 9 2026 11915 Dev Medwrite Ai" width="1910" height="1400" data-path="images/Screenshot_23-9-2026_11915_dev.medwrite.ai.jpeg" />
    </Frame>

    Type what the assistant should write, then send. **Enter** sends the message. **Shift+Enter** adds a new line. A message can be up to **2000 characters**.

    For example:

    > An ED discharge summary in UK English with sections for presenting complaint, assessment, treatment, plan and safety-net advice.

    The chat shows **Thinking… this can take up to 30 seconds**, then posts a reply.

    <Frame caption="Prompt sent in the side chat.">
      <img src="https://mintcdn.com/medwriteai/BzS_Tksx7GfS2Dso/images/Screenshot_23-9-2026_111021_dev.medwrite.ai.jpeg?fit=max&auto=format&n=BzS_Tksx7GfS2Dso&q=85&s=4707452a0834d9a7ab44bcf33a4d2fe8" alt="Screenshot 23 9 2026 111021 Dev Medwrite Ai" style={{ borderRadius:"0.5rem", maxWidth:"560px" }} title="Screenshot 23 9 2026 111021 Dev Medwrite Ai" width="1961" height="1403" data-path="images/Screenshot_23-9-2026_111021_dev.medwrite.ai.jpeg" />
    </Frame>
  </Step>

  <Step title="Review the fields the chat filled">
    The reply writes into the Assistant Form. A green note under the message lists what changed, for example **Updated: Assistant Name, Speciality, Assistant Instructions, Templates, Examples, Dictionary**.

    Those fields are filled for you:

    * **Assistant Name**
    * **Speciality**
    * **Assistant Instructions**
    * **Templates**
    * **Examples**
    * **Dictionary**

    The matching tab (Templates, Examples, or Dictionary) is brought forward when that text changes. You can edit any filled field by hand.

    Send another message to change the draft. The chat updates the same fields from your latest request. **New conversation** clears the chat so you can start again. Values already written on the form stay until a new reply replaces them.

    <Frame caption="The chat reply and the form fields it updated.">
      <img src="https://mintcdn.com/medwriteai/BzS_Tksx7GfS2Dso/images/Screenshot_23-9-2026_111142_dev.medwrite.ai-2.jpeg?fit=max&auto=format&n=BzS_Tksx7GfS2Dso&q=85&s=dbe6f8c1125fe1f3d084c227803ff5ea" alt="Screenshot 23 9 2026 111142 Dev Medwrite Ai 2" style={{ borderRadius:"0.5rem" }} title="Screenshot 23 9 2026 111142 Dev Medwrite Ai 2" width="2541" height="831" data-path="images/Screenshot_23-9-2026_111142_dev.medwrite.ai-2.jpeg" />
    </Frame>
  </Step>

  <Step title="Save the assistant">
    When the draft looks right, the chat can show **Ready to create**. Saving is still a separate action on the form:

    * **Save as Draft** – Store the assistant without making it available for letters.
    * **Save & Activate** – Save it as active and create the workflow for the clinic you selected.

    **Cancel** leaves the page without saving.
  </Step>
</Steps>

<Tip>
  Describe one letter type in one message, including the language and the section headings. Use a follow-up message to adjust tone or sections. Choose **Clinic** yourself before you save.
</Tip>

## Next steps

<Columns cols={2}>
  <Card title="Assistant Library" icon="books" href="/essentials/assistant-library">
    Return to your assistants after you save.
  </Card>

  <Card title="Create Record" icon="file-plus" href="/essentials/create-record">
    Use an active assistant when you create a record and generate a letter.
  </Card>
</Columns>


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