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

# Assistant layout

> A full-page, ChatGPT-style chat with your agent: centered conversation, starter prompts and past chats.

The assistant layout shows your agent as a full-page chat, like ChatGPT.
The conversation sits in a centered column, the agent's answers have no bubbles, visitors see starter prompts before they type, and they can open their past chats.

It is the same agent as your web widget.
Tools, the knowledge base, forms, buttons, human handoff, file uploads and voice all work the same way.

## Turn it on

Open your agent, go to **Settings → User Interface → Widget layout**, pick **Assistant (ChatGPT style)** and save.
This switches every place the agent is installed, including popups.

You can also keep your widget as it is and use the assistant only on one page (see [Embed it on your site](#embed-it-on-your-site)).

## Options

| Option | What it does |
| - | - |
| Heading | The big line on the empty screen. Default: "How can I help you today?" |
| Line under the heading | Empty shows the agent's first message. |
| Message box placeholder | Default: "Ask anything". |
| Starter prompts | Up to 6, one per line. They show as buttons before the visitor's first message, and a click sends that message. |
| Hide past chats | Removes the past chats panel. |

## Share the hosted page

Every agent has a full-page link:

```text theme={null}
https://your-domain/{region}/prototype/{agentId}/assistant
```

The dashboard shows it under **Widget layout**, and in the **Assistant** tab of the widget script.
The link works even when the agent's own layout is the classic widget.

## Embed it on your site

Give the container the size you want and set `widgetType: 'assistant'`.
This overrides the agent's layout for that page only.

```html theme={null}
<div style="width: 100%; height: 100vh;" id="VG_OVERLAY_CONTAINER"></div>
<script defer>
  (function () {
    window.VG_CONFIG = {
      ID: "YOUR_AGENT_ID",
      region: "eu",
      render: "full-width",
      widgetType: "assistant",
      stylesheets: ["https://YOUR_CDN/vg_live_build/styles.css"],
    };
    var VG_SCRIPT = document.createElement("script");
    VG_SCRIPT.src = "https://YOUR_CDN/vg_live_build/vg_bundle.js";
    VG_SCRIPT.defer = true;
    document.body.appendChild(VG_SCRIPT);
  })();
</script>
```

Copy the exact snippet for your agent from the **Assistant** tab of the widget script in the dashboard.

## Past chats

Past chats are the earlier conversations of the same visitor on the same device.
They open read-only; **New chat** starts a fresh conversation.


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