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

# Setup assistant

> The Cometly setup assistant is a chat that works through the seven Setup steps with you, does the parts it can for you and uses no AI credits.

The Cometly setup assistant is a chat that gets a space tracking with you. (A space is an individual workspace inside your Cometly account.) It reads your live setup status, does what it can itself, and hands you only the parts that need you, such as pasting the pixel (Cometly's tracking script) on your site or signing in to an ad platform.

Cometly can only show which ad produced each lead or sale once the Setup steps are in place. The assistant shortens that work: it drafts your business answers from your website, gives you the exact pixel script and checks your install, so you spend your time on the few things only you can do. Use it instead of, or alongside, the [Setup page](https://docs.cometly.com/getting-started/setup.md).

## Where to find it

Click **Setup** in the left sidebar, then **Use the AI assistant** above the step list. In a narrow window the button shows only a sparkle icon.

![Setup page with an arrow pointing at the Use the AI assistant button above the step list in the left rail](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/setup-assistant/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=055341bc6a1f4471fcd00a7d554e9223)

The assistant opens full screen, without the app sidebar:

* **Exit Setup** (top left) goes to your dashboard.
* **Switch to manual setup** (top right) goes back to the Setup page.

You have one setup conversation per space. It is private to you, it is kept between visits, and it is not listed with your Agent chats.

## The chat

The assistant speaks first. Its greeting is built from your current setup status: what is already in place, the next thing to do, and buttons such as **Start setup for me**, the name of the next open step and **Something else**. Click a button or type in **Reply or ask anything...**. You can attach an image (JPEG, PNG or WebP, up to 5 MB), for example a screenshot of where you pasted the pixel.

![Full-screen setup assistant with its greeting and reply buttons, the header showing No AI credits used, Autopilot and New chat, and the progress panel on the right at 6 of 7 complete](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/setup-assistant/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=694994670731f6d535a4fb3e4382e3fb)

The header of the chat has:

* **No AI credits used**: see [No AI credits](#no-ai-credits).
* **Autopilot** or **Interactive**: the working mode. Click it to switch.
* **New chat**: opens **Start a new setup chat?**. **Start new chat** clears the current conversation. Your setup progress, domains, accounts and events are not affected.
* **Progress** (small screens only): opens the progress panel.

## Autopilot and Interactive

The mode sets the assistant's pace. Your choice is remembered in your browser, and the assistant starts in **Autopilot**.

| Mode | How the assistant works |
| - | - |
| **Autopilot** | Acts first. It reads your site, fetches your pixel snippet and checks your install without asking, and saves your business answers as soon as you confirm or correct its draft. It stops only for what you must decide or do. |
| **Interactive** | Asks first. Before it saves or creates anything, it says what it is about to change and waits for your go-ahead. It finishes one step with you before proposing the next. |

In both modes, the assistant adds a domain only after you say yes to that exact domain.

## What it can do for you

* Read your website and draft the [About your business](https://docs.cometly.com/getting-started/about-your-business.md) answers, then save them once you confirm.
* Add a domain to the space's domains, and turn on automatic cross-domain tracking when you say the domain is where your app or login lives. If that changes your pixel script, it gives you the updated script.
* Give you the exact pixel script for the space, with install steps for your website platform.
* Check a page on one of your domains: whether the Cometly pixel is on it, whether it belongs to this space, whether events arrived in the last 24 hours and whether the domain is verified.
* Create a draft conversion event and link you to the page where you finish configuring it.
* Create a scheduled [data export](https://docs.cometly.com/data-warehouse/overview.md) to an export destination you have already added.
* Give you the link to connect each ad platform, and the steps to connect your AI assistant or coding agent over [MCP](https://docs.cometly.com/mcp/overview.md).
* Look up what exists in the space (connected ad accounts, integrations, events, tracking health) and search the Cometly docs.

Changes follow your role in the space. Saving the business answers, creating an event and creating an export need the account Owner or the space Administrator role. Adding a domain also works for an Advertiser. If your role does not allow a change, the assistant tells you which permission is missing. See [Space roles](https://docs.cometly.com/guides/account/space-roles.md).

## What it cannot do

* Paste the pixel on your site, or verify a domain. You click **Verify** in [step 2](https://docs.cometly.com/getting-started/install-pixel.md).
* Sign in to an ad platform. It gives you the link and you approve the access. See [Connect ad platforms](https://docs.cometly.com/getting-started/connect-ad-platforms.md).
* Add URL parameters to your ads. It explains the fix for the platforms you run and links to step 4. See [URL parameters](https://docs.cometly.com/getting-started/url-parameters.md).
* Turn on the Conversion API. It explains why it matters and links to step 6.
* Add an export destination. Credentials and access tokens are entered on their own pages, not in the chat.
* Mark a step complete. Steps are checked against your live data.
* Build reports or analyze performance. For that, use the [Agent](https://docs.cometly.com/guides/agent/overview.md).

## Progress panel

The panel on the right shows **Setup**, how many of the seven steps are complete and, once step 1 is answered, your business type. Each step shows its current status. Click a step to expand it and see the details behind that status, plus two buttons:

* **Help me with this** (or **Update with the assistant** on a completed step) sends that request to the chat.
* **Open step** opens the step on the Setup page.

![Setup assistant progress panel with the Install the Cometly pixel step expanded, showing its details, an arrow pointing at Help me with this, and the Open step link beside it](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/setup-assistant/03.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=78e22c6593afb989d75920eef7b9bd1f)

The panel refreshes after each reply from the assistant.

## No AI credits

Messages to the setup assistant do not use your AI credits, and the assistant works when your credit balance is empty.

Instead, each space has a daily allowance of setup assistant turns, shared by everyone in the space. When it is used up, the chat shows a message that the assistant has used today's allowance for this space, with the number of turns. Try again the next day (the day is counted in UTC), or continue on the Setup page.

## Frequently asked questions

### Can I switch between the Cometly setup assistant and the manual Setup page?

Yes. Click **Switch to manual setup** to go back to the Setup page, and **Use the AI assistant** to return to the chat. Both show the same progress, because each step is checked against your live data, not against what was said in the chat.

### What is the difference between the setup assistant and the Agent?

The setup assistant only helps you finish the seven Setup steps, and it uses no AI credits. The [Agent](https://docs.cometly.com/guides/agent/overview.md) answers questions about your ads and conversions once data is coming in, and it uses AI credits. Setup conversations are kept separate from your Agent chats.

### Can my teammates see my setup assistant conversation?

No. Your setup conversation is private to you, and each person has their own conversation per space. The setup progress itself is the same for everyone in the space, and so is the daily allowance of assistant turns.

## Next steps

* [Set up Cometly](https://docs.cometly.com/getting-started/setup.md): the seven steps
* [About your business](https://docs.cometly.com/getting-started/about-your-business.md)
* [Tracking Health](https://docs.cometly.com/getting-started/tracking-health.md)
* [Use the Agent](https://docs.cometly.com/guides/agent/overview.md): the Agent for questions about your data, and how AI credits work
* [Troubleshooting](https://docs.cometly.com/support/troubleshooting/overview.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


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