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

# Best practices for custom instructions

> Write custom instructions for the Cometly Agent that cover your funnel, KPI goals and naming conventions, so its answers fit your business.

Custom instructions for the Cometly Agent are a short block of text that tells the Agent (Cometly's AI assistant) how your business works, what goals you're aiming for, and how you manage your ads. You write them once, and the Agent reads them in every conversation.

This matters because the Agent judges your ad performance against what it knows about you. When it knows your funnel, your target cost per lead and what your campaign names mean, its suggestions on what to cut, scale or test match your account, and you don't have to repeat that context in every chat.

> [!NOTE]
>
> Only the account **Owner** can save instructions. They then apply to everyone in the team.

## Where to add your instructions

1. Click **Agent** in the left sidebar.
2. Click the settings icon in the chat list (its tooltip reads **Ask AI settings**).
3. On the **Instructions** tab, type or paste your instructions. You have up to 2,000 characters.
4. Click **Save instructions**.

Instructions are applied to every conversation in your team.

## What to include

### 1. Your funnel steps

Break down the main steps from ad click to conversion. For example:

**Ad click → lead → booked call → deal created → closed won**

### 2. Your business type

Tell the Agent what kind of business you run: SaaS, ecommerce, info product, agency, etc.

### 3. Your KPI goals

List your top metrics:

* Cost per click (CPC)
* Cost per lead (CPL)
* Cost per booked call or purchase (CPA)
* ROAS (return on ad spend)
* Close rate / show rate
* Customer acquisition cost (CAC)
* Average order value (AOV)
* Lifetime value (LTV)

### 4. Any special notes

Optional, but helpful:

* Cold vs warm traffic
* How you close (sales calls, checkout, trials, etc.)
* What kind of creatives you run (UGC, static, carousels, etc.)
* Any current tests or funnel changes

### 5. Naming conventions

If you use structured naming for campaigns, ad sets, or ads, explain what your labels mean so the Agent can identify patterns.

**Examples:**

* `H1` = Headline 1
* `V2` = Creative Version 2
* `LP1` = Landing Page 1
* `TOF_Prospecting_VSL` = Top-of-funnel prospecting with VSL page
* `INT-M25-44` = Interest-based, men age 25–44

### 6. Optimization rules

Every media buyer has their own logic for when to cut, scale, or test. Share a few of yours so the Agent can give suggestions that match your style.

These rules will vary depending on your conversion goals (e.g., purchases, webinar signups, trials, calls).

**Examples:**

* Kill ad sets with no conversion after \$50 spent
* Scale if ROAS stays above 3x for 2+ days
* Increase budget 20% daily once 3+ purchases happen
* If webinar registrations cost under \$10, duplicate to test new audiences
* Kill creatives with CTR under 0.8% by Day 2

Include 3–5 of your daily rules, especially the ones that impact how you test, cut, or scale.

## Fill-in-the-blank template

```text theme={null}
I run a [type of business] selling [product/service].
My funnel (Cometly Events): [step 1] → [step 2] → [step 3] → [step 4].

KPI goals:
- [Goal #1, like $40 CPL or 3x ROAS]
- [Goal #2]
- [Goal #3]

Other context:
- [Audience type, sales process, creative types, etc.]

Naming conventions:
- Campaigns: [Example structure]
- Ad sets: [What the names mean]
- Ads: [H1 = Headline 1, V1 = Creative 1, etc.]

Optimization rules:
- [Rule 1]
- [Rule 2]
- [Rule 3]
```

## Example: SaaS

```text theme={null}
We're a SaaS company helping advertisers track ad performance across FB, Google, TikTok, and LinkedIn.

Funnel: Ad click → lead → scheduled call → show → closed won

KPI goals:
- CPL: $40–$60
- Cost per booked call: $300–$500
- Close rate: ~40%
- ROAS: 5x

Other context:
- We run cold traffic to VSL landing pages
- Sales happen over Zoom after booking

Naming conventions:
- Campaign: TOF_Prospecting_VSL, BOFU_Retargeting_CaseStudy
- Ad sets: LOOKAL-90D-ClosedWon, INT-MediaBuyers-US
- Ads: H1-V1-UGC = Headline 1, Creative V1, UGC style

Optimization rules:
- Kill ad sets with no calls booked after $50 spend
- Duplicate winning ad sets after 3+ bookings
- Raise budget by 20% after a $250 booked call
```

## Example: Ecommerce

```text theme={null}
We're a DTC ecommerce brand selling premium fitness supplements.

Funnel: Ad click → product page → add to cart → checkout → purchase

KPI goals:
- CPA: $35–$50
- ROAS: 3x minimum
- AOV: $85
- LTV: $250+

Other context:
- Mostly cold traffic via Meta and TikTok
- Ads are UGC and lifestyle creatives

Naming conventions:
- Campaigns: PROTEIN-MayLaunch, RETARGET-7D-ATC
- Ad sets: INT-Fitness-M25-44, LAL-180D-Customers
- Ads: H1-V2-Bundle = Headline 1, Creative 2, Bundle promo

Optimization rules:
- Kill ad set if no purchase after $40
- Duplicate high-performers after 3+ purchases
- Scale 20% daily if ROAS stays above 3x
```

## Check it worked

After you click **Save instructions**, the dialog closes and a confirmation reads **AI Instructions saved successfully!** Click the settings icon again: your text is shown on the **Instructions** tab.

## Frequently asked questions

### Do custom instructions apply to everyone on my team?

Yes. There is one set of instructions per team, and the Agent uses it in every conversation, for every user and in every space (a space is a workspace inside your account). Write them for the whole team, not for one person.

### Do I need to start a new chat after changing my instructions?

No. The Agent reads the saved instructions each time you send a message, so the change applies to your next message, in a new chat or an existing one.

### What is the difference between custom instructions and Agent memory?

Custom instructions are one block of text that you write yourself, up to 2,000 characters, and the Agent reads all of it in every conversation. Agent memory is a list of short facts the Agent remembers between chats about you, your space and your team. You review and correct those on the [Agent memory](https://docs.cometly.com/settings/agent-memory.md) page.

## Next steps

* [Use the Agent](https://docs.cometly.com/guides/agent/overview.md): start a chat, pick a mode and share chats with your team.
* [Agent prompt library](https://docs.cometly.com/guides/agent/prompt-library.md): questions you can copy and adapt.
* [Agent memory](https://docs.cometly.com/settings/agent-memory.md): review what the Agent remembers about you, your space and your team.

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.