> ## 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.

# Use the Agent

> Use the Cometly Agent to ask questions about your ads and conversions in plain language, get answers from your own data, and manage AI credits.

The Cometly Agent is an AI chat built into Cometly. You ask a question about your ads and conversions in plain language, and it answers from the data in your space (the Cometly workspace for one business or website).

It analyzes your campaign data, surfaces insights, and gives recommendations you can act on. That helps you decide where to move budget, which creatives to test and which campaigns to scale.

[See the full feature breakdown](https://www.cometly.com/features/ai-chat)

## What is the Agent?

The Agent lets you interact directly with your Cometly data using natural language. Ask questions like:

* "Which ad set generated the most leads last month?"
* "What creatives are driving the highest ROAS?"
* "How should I scale this campaign?"

The Agent looks up the data it needs in your space, then provides personalized insights and suggestions. You do not need to select campaigns or load data into the chat first.

Visit the [Agent prompt library](https://docs.cometly.com/guides/agent/prompt-library.md) for questions you can copy and adapt.

## Start a chat

**1. Open the Agent**

Click **Agent** in the left sidebar. It is also the first page you see after you log in.

You can also open the same chat next to your data from the Ads Manager: click **Ask AI** in the Ads Manager toolbar.

**2. Pick a mode**

Use the **Mode** selector to choose how the Agent works:

* **Standard** (recommended): balanced thinking and tool use. Best for most create, improve, and analyze tasks.
* **Deep research**: more thinking time for big analyses and multi-step questions across your data.

**3. Ask your question**

Type your question and send it. On an empty chat you can also start from one of the suggestions: **Create a report**, **Optimize ads** or **Troubleshoot setup**.

You can attach an image (JPEG, PNG or WebP, up to 5 MB) to a message.

## Check it worked

The Agent's answer appears in the chat, and the chat is saved in your chat list. Use **Search chats** to find it again later.

## Work with your chats

* **Unlimited chats:** you can start as many chats as you want. Click **New chat** to start one, and use **Search chats** to find an earlier one. Organize them by campaign, date range, or analysis type for easy reference later.
* **Share a chat:** click **Share** and choose **Private**, **Share with space** or **Share with team**. Only you can post into a shared chat. Other people can read it and fork it into their own chats. Chats shared with you are listed on the **Team** tab.
* **Use the reports:** when an answer includes a report, you can add it to a dashboard or schedule it as a Slack or email notification from the report card.
* **Custom instructions:** click the settings icon in the chat list (**Ask AI settings**) to give the Agent standing instructions about your business. See [Best practices for custom instructions](https://docs.cometly.com/guides/agent/custom-instructions.md).
* **Memory:** the Agent can remember facts about you, your space and your team between chats. Manage what it remembers under **Settings > Agent memory**.

## AI credits and billing

The Agent uses AI credits. Your balance is shown in the **AI Credits** pill at the top of the chat and on the **Billing** page.

New teams get **10 free AI credits** upon sign-up to test the feature.

### Ongoing usage

Each answer consumes credits. Bigger analyses and more complex questions use more.

**1 AI credit = \$1**

### Purchasing more credits

When credits run low, the account owner can buy more at any time: click the **AI Credits** pill in the chat, or **Buy credits** on the **Billing** page, and select an amount:

* 50, 100, 250, or 500 credits

Buying credits is available once your trial has ended.

## Example questions

* "Which audiences are converting best across all remarketing campaigns?"
* "What should I test next based on underperforming ads?"
* "Give me creative recommendations based on high CTR ads."

> [card] [View the Agent prompt library](https://docs.cometly.com/guides/agent/prompt-library.md)

## Frequently asked questions

### What happens when I run out of AI credits in Cometly?

The chat shows **You've used all of your AI credits** and you cannot send new messages until the balance is topped up. The account owner can buy more from the **AI Credits** pill in the chat or from the **Billing** page.

### Is the Cometly Agent the same as the Setup assistant?

No. The Agent answers questions about your ads and conversions and uses AI credits. The [Setup assistant](https://docs.cometly.com/getting-started/setup-assistant.md) only helps you finish the Setup steps, uses no AI credits, and keeps its conversations separate from your Agent chats.

### Can I use my Cometly data in ChatGPT or Claude instead?

Yes. Cometly has an MCP server (MCP is an open standard that lets AI tools call tools on another service), so assistants such as Claude, ChatGPT and Cursor can query your space's live data. See [Add Cometly to your AI agent](https://docs.cometly.com/getting-started/ai-agent.md) for how to connect one.

## Next steps

* [Copy a question from the Agent prompt library](https://docs.cometly.com/guides/agent/prompt-library.md)
* [Write custom instructions so answers fit your business](https://docs.cometly.com/guides/agent/custom-instructions.md)
* [Review what the Agent remembers in Agent memory](https://docs.cometly.com/settings/agent-memory.md)
* [Check your AI credit balance on the Billing page](https://docs.cometly.com/settings/billing.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.