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

# AI Prompt Editor

> Edit and improve your assistant's prompts using AI-powered suggestions through a chat interface

The AI Prompt Editor is an intelligent tool that allows you to edit and enhance your AI assistant’s prompts in natural language. Instead of manually editing text, you can chat with an AI assistant that understands your requests and proposes smart modifications.

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0 }}>
  <iframe style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} src="https://www.tella.tv/video/system-prompt-erstellen-prompt-editor-8nav/embed?b=0&title=0&a=1&loop=0&t=0&muted=0&wt=0&o=1" allowFullScreen allowTransparency />
</div>

## Overview

The AI Prompt Editor offers:

* **Conversational editing** – Describe changes in simple language
* **Intelligent suggestions** – The AI understands context and applies relevant modifications
* **Review before applying** – Accept or reject each change individually
* **Variable management** – Easily manage pre-call and post-call data
* **Template library** – Get started with proven prompt templates

<Frame>
  <img src="https://mintcdn.com/famulor/DPfB6YtQbYXZiaGO/images/ai-prompt-editor-overview.png?fit=max&auto=format&n=DPfB6YtQbYXZiaGO&q=85&s=9476417ea8437025c9a4cb180883b48d" alt="AI Prompt Editor overview: chat assistant and system prompt editor" width="1418" height="897" data-path="images/ai-prompt-editor-overview.png" />
</Frame>

## Getting Started

<Steps>
  <Step title="Open the assistant">
    Navigate to **Assistants** in the side menu and click on the assistant you want to edit.
  </Step>

  <Step title="Find the AI Prompt Editor">
    Scroll down in the edit form to the **System Prompt** section and locate the **AI Prompt Editor** tab.
  </Step>

  <Step title="Launch the editor">
    Click the **Start AI Prompt Editor** button. A modal window with the editor interface will open.
  </Step>
</Steps>

<Note>
  You must save your assistant at least once before you can use the AI Prompt Editor.
</Note>

## Interface Overview

The AI Prompt Editor consists of three main areas:

### Chat Panel (Left Side)

This is where you interact with the AI:

* Enter your requests in the input box at the bottom
* View the conversation history above
* Use quick-action chips for common tasks:
  * **Make more concise** – Shorten the prompt
  * **Add more details** – Expand with specifications
  * **Improve clarity** – Make instructions easier to understand
  * **Add instructions** – Include new behavioral guidelines

### Editor Panel (Right Side)

Displays your current prompt with two tabs:

* **System Prompt** – The main instructions for your assistant
* **First Message** – The greeting at the beginning of the call

Switch between **edit mode** (text field) and **preview mode** (formatted view with diff highlights).

### Side Tabs

* **Variables** – Manage variables for pre-call data
* **Post-Call** – Define data to be collected after the call

## Using the Chat

### Making requests

Simply describe what you want to change:

<AccordionGroup>
  <Accordion title="Example: Make tone friendlier" icon="face-smile">
    **You:** “Make the tone friendlier and more relaxed.”

    **AI:** The AI will suggest changes to make greetings warmer, use more conversational language, and soften formal phrases.
  </Accordion>

  <Accordion title="Example: Add information" icon="plus">
    **You:** “Add information about our return policy – 30 days no questions asked.”

    **AI:** The AI will find the appropriate place in your prompt and add details about the return policy.
  </Accordion>

  <Accordion title="Example: Handle scenario" icon="shield-halved">
    **You:** “Add instructions for dealing with angry customers.”

    **AI:** The AI will add behavioral guidelines for de-escalation and specify when to escalate to a human agent.
  </Accordion>
</AccordionGroup>

### Tips for better results

* **Be specific** – “Mention a 10% discount” works better than “Add discount info.”
* **Provide context** – “If asked about pricing, mention…” helps the AI understand better.
* **One change at a time** – Break complex changes into multiple requests.

## Reviewing changes

When the AI suggests changes, they appear in the diff view:

* **Green highlight** – New text to be added
* **Red highlight** – Text to be removed
* **Blue highlight** – Text that has been modified

### Accepting or rejecting changes

Each change has two buttons:

* **✓ Accept** – Apply this specific change
* **✗ Reject** – Discard this change

Batch actions are also available:

* **Accept all** – Apply all pending changes
* **Reject all** – Discard all pending changes

<Warning>
  Always review changes before accepting them. The AI makes smart suggestions, but you know your business best.
</Warning>

<Frame>
  <img src="https://mintcdn.com/famulor/DPfB6YtQbYXZiaGO/images/ai-prompt-editor-accept-deny.png?fit=max&auto=format&n=DPfB6YtQbYXZiaGO&q=85&s=78588ff7362f7eece485377e190de5c4" alt="Accepting or rejecting changes in the AI Prompt Editor" width="1428" height="904" data-path="images/ai-prompt-editor-accept-deny.png" />
</Frame>

## Variables

Variables allow you to personalize calls with dynamic data.

### Adding variables

1. Click the **Variables** tab
2. Click **Add variable**
3. Enter a name (e.g., `customer_name`, `appointment_time`)
4. Set a default value

### Using variables in prompts

Include variables directly in your prompt using curly braces: `{variable_name}`

**Example prompt:**

```
Hello {customer_name}, I'm calling from Famulor regarding your appointment on {appointment_date}.
```

## Post-Call Schema

Define structured data you want to collect during or after the call.

### Adding post-call fields

1. Click the **Post-Call** tab
2. Click **Add field**
3. Configure:
   * **Name** – Field identifier (e.g., `meeting_scheduled`)
   * **Type** – `string`, `number`, or `boolean`
   * **Description** – What this field captures

### Example fields

| Name                | Type    | Description                                  |
| ------------------- | ------- | -------------------------------------------- |
| `meeting_scheduled` | boolean | Whether an appointment was booked            |
| `interest_level`    | string  | Customer interest: hot, warm, cold           |
| `callback_time`     | string  | Preferred date/time for callback             |
| `objection_reason`  | string  | Main reason for rejection if interest is low |

<Tip>
  The AI can suggest post-call fields based on your prompt. Just ask: “What data should I capture from these calls?”
</Tip>

<Frame>
  <img src="https://mintcdn.com/famulor/dFnpnKboAf40OJ5r/images/ai-prompt-editor-post-call.png?fit=max&auto=format&n=dFnpnKboAf40OJ5r&q=85&s=747a1e0e09f9675f897ae35dc5da5739" alt="Post-Call Schema: fields and types in the AI Prompt Editor" width="1022" height="322" data-path="images/ai-prompt-editor-post-call.png" />
</Frame>

## Templates

When you open the AI Prompt Editor for the first time, you can start with a template:

* **Continue with existing** – Keep your current prompt
* **Start from scratch** – Begin with an empty prompt
* **Start with a template** – Choose from prebuilt prompt templates

Templates are organized by use case:

* Sales calls
* Customer support
* Appointment scheduling
* Surveys and feedback
* Lead qualification

<Frame>
  <img src="https://mintcdn.com/famulor/dFnpnKboAf40OJ5r/images/ai-prompt-editor-template.png?fit=max&auto=format&n=dFnpnKboAf40OJ5r&q=85&s=168c4665a3df3fed2d314ea4ac30338c" alt="Choose a template: prompt template library in the AI Prompt Editor" width="1410" height="905" data-path="images/ai-prompt-editor-template.png" />
</Frame>

## Saving your work

Click the **Save** button in the top right to save all changes to your assistant.

<Note>
  The editor automatically detects unsaved changes. If you try to close without saving, you’ll be prompted to save or discard.
</Note>

## Best Practices

<CardGroup cols={2}>
  <Card title="Start with templates" icon="layer-group">
    Templates provide proven starting points. Customize them instead of starting from scratch.
  </Card>

  <Card title="Iterate gradually" icon="repeat">
    Make small changes, test them, and refine. Avoid overhauling everything at once.
  </Card>

  <Card title="Review every change" icon="magnifying-glass">
    The AI is helpful but not perfect. Always check suggestions before accepting.
  </Card>

  <Card title="Test after editing" icon="phone">
    Conduct test calls after changes to ensure the assistant behaves as expected.
  </Card>
</CardGroup>

## Related resources

* [System Prompt Guide](/en/ai-assistants/system-prompt) – Deep dive into writing prompts
* [Flow Builder](/en/ai-assistants/flow-builder) – Visual alternative for conversation design
* [Testing Assistants](/en/ai-assistants/testing) – How to test your changes
