Skip to content
TrueROASDocs
DocsIntegrations

What is the Your Agents page and what can I do there?

Turn Alert Agent on or off, see when it runs and whether something blocks it, open its alert settings and add notes it should know.

Open Your Agents

  1. Open Setup in the left menu and click Integrations.
  2. Under AI Agents, find the Your Agents card with Assistants that watch your store and do work for you. Switch each one on or off.
  3. Click See agents. Once an agent is on, the card shows Active and how many agents are on, for example 1 of 1 agents on, and the button reads Manage.

The page Your Agents opens with Turn on assistants that watch your store and do work for you. They learn as they go and share what they learn with each other. It has no item in the left menu, so the card is the way in.

The page shows the agents of the store you have selected at the top of the left menu. Without a selected store, it reads Select a store to manage its agents. If the agents cannot be loaded, a red box shows the reason.

The Alert Agent card

The page has one agent, Alert Agent, with the description Decides when a change in your ad performance is actually worth alerting you about. What its alerts contain and where you see them is explained in What are Alert Agent reports?.

The card shows:

  • The switch at the top right, which turns the agent on or off.
  • On or Off, the agent's current state.
  • Runs daily around 14:00 your time, the time of its daily check. Your time here means your store's time zone.
  • A blocked or error label when something went wrong, as described below.
  • The gear icon at the bottom right (tooltip Alert settings), which opens the alert settings. It works while the agent is off too, so you can set things up before you turn it on.
  • While the agent is on, the Teach this agent box.

Turn Alert Agent on or off

  1. Click the switch at the top right of the Alert Agent card.
  2. The label under the description changes to On or Off.

If the change cannot be saved, a red box on the card reads Couldn't save that change. Please try again., or gives the reason. Close it with the x at its right.

The switch is shared with Enable Alert Agent in the Alert Agent window that the gear on the Reports page opens, as explained in What are Alert Agent reports?.

When something blocks the agent

Before each run, Alert Agent checks that it can run. If a check fails, it skips the run and the card shows blocked. While the agent is on, a box under the labels gives the reason, with a hint in brackets:

ReasonHintWhat to do
Connect your Meta Ads or Google Ads account to enable this agent.(/integrations)Connect a Meta Ads or Google Ads account for this store. See How do I connect, refresh or disconnect my Facebook account for Meta Ads? or How do I connect, re-link or unlink Google Ads on the Integrations page?.
This store is inactive.(Reactivate the store to run agents.)Make the store active again. If your subscription ended, see What happens after I cancel, and how do I restart my subscription?.

An error label means the last run stopped with an error.

Both labels only change at the next run, not right after you fix the problem. They go away at the next run that passes the checks. If you expected an alert and got none, see Why didn't Alert Agent email me when my ROAS changed?.

Alert settings

Click the gear icon on the card. A window titled Alert Agent opens with Choose how big a change has to be before we email you, and who gets the email. It has two parts:

Click Save at the bottom of the window to keep your changes. Close the window with the X in the top right corner. The window has no on or off switch; the switch on the card does that.

Teach this agent

While Alert Agent is on, the card has a box called Teach this agent. It holds knowledge the agent uses every time it runs, with the field What should it know? (e.g. 'We never discount over 20%'). How to add and remove notes is explained in How do I teach Alert Agent what matters for my store?.

Good to know

  • Everything on this page is for the whole store, not only your login. The switch, the notes and the alert settings are the same for everyone on the store.
  • Only the store owner or an admin can save the alert settings in the gear window. Everyone else sees them greyed out.
  • You cannot change when Alert Agent runs, or start a run, from this page.
  • The alerts Alert Agent sent are listed on the Reports page, as described in What are Alert Agent reports?.
  • On a phone, the agent card fills the width of the screen.