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

# dc Copilot

> AI assistant for website visitors with a custom persona, predefined questions, file upload, and rate limits.

The content type **dc Copilot** embeds an AI assistant directly on your page. You define the name, greeting, and behavioral instructions and control via rate limits how many requests are allowed per period. Optionally, you can offer predefined questions and file upload.

## Selecting the content type

In the editor of a page, shopping world, or building block, click **+ New**, then in the **Content** tab click **dc Copilot**. The dialog **"Create new chatbot"** opens.

## Fields

### General

| Field                  | Meaning                                                                                |
| ---------------------- | -------------------------------------------------------------------------------------- |
| **Description**        | Internal name of the chatbot (max. 255 characters)                                     |
| **Prompt placeholder** | Placeholder text in the input field (e.g., "How can I help you…")                      |
| **Agent Name**         | Display name of the chatbot in the chat window                                         |
| **Agent Welcome Text** | Greeting message when the chat is opened. Variables such as `%agentname%` are replaced |
| **Instructions**       | Behavioral instructions for the chatbot (persona, tasks, tone, allowed topics)         |

### Settings

| Field                     | Meaning                                              |
| ------------------------- | ---------------------------------------------------- |
| **Agent ID**              | Unique identifier of the agent                       |
| **Enable file upload**    | Allows users to attach files to the chat             |
| **In lightbox**           | Chat opens in an overlaid lightbox instead of inline |
| **Show in all languages** | Makes the chatbot available across all languages     |

### Rate limits

Limits per user to prevent abuse and excessive costs.

| Field                               | Meaning                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------- |
| **Number of requests per interval** | Maximum requests within the selected time interval                                     |
| **Time interval**                   | Reference period: `Minute`, `Hour`, `Day`, `Week`, or `Month` (Default: Please select) |
| **IP whitelist**                    | IP addresses for which the rate limits do not apply (e.g., internal testers)           |
| **Max. number of requests**         | Absolute upper limit independent of the interval                                       |

### Publishing

| Field           | Meaning                                                              |
| --------------- | -------------------------------------------------------------------- |
| **Layout area** | Area of the page layout in which the chat appears (Default: Content) |
| **Active**      | Makes the chatbot visible                                            |

## Managing predefined questions

Predefined questions become accessible only after the first **Save**. Afterwards, open the chatbot via **Edit**. The **Predefined questions** section appears with the following toolbar:

| Action                      | Effect                            |
| --------------------------- | --------------------------------- |
| **+ New**                   | Add a new predefined question     |
| **Edit**                    | Adjust an existing question       |
| **Delete**                  | Remove a question                 |
| **Move up** / **Move down** | Change the order of the questions |

### Fields of a question

Clicking **+ New** opens the dialog **"New question"**:

| Field        | Meaning                                             |
| ------------ | --------------------------------------------------- |
| **Question** | Question text offered to users as a quick selection |

## Tips

<Tip>
  Write **Instructions** in the first person with clear guidelines: persona, tasks, topic boundaries, and desired tone. The more precise, the better the answers.
</Tip>

<Tip>
  **Predefined questions** help users who don't know what to ask. Well suited for standard concerns (e.g., "Where can I find my order?").
</Tip>

<Tip>
  Always set **rate limits** to control costs and abuse. A small number per minute plus a daily upper limit is usually sensible.
</Tip>

## Related topics

<CardGroup cols={2}>
  <Card title="Contact forms" icon="envelope" href="/docs/en/dynamic-content/user-guide/inhaltsarten/kontaktformulare">
    Classic forms as an alternative to the chatbot.
  </Card>

  <Card title="Page content" icon="pen-to-square" href="/docs/en/dynamic-content/user-guide/seiteninhalte">
    How page content works in general.
  </Card>

  <Card title="Content types" icon="shapes" href="/docs/en/dynamic-content/user-guide/inhaltsarten">
    All available content types.
  </Card>
</CardGroup>