Getting Started with Automation Agents
Automation Agents are your assistants for analytics and reporting. They follow your instructions, run analyses and deliver insights on a schedule. Here's how to set up your first agent.
1. Open the Automation Agents Tab
- Click Automation Agents in the left navigation bar.
- The Reports tab lists your agents.
- Select any agent to see its report for each run date.
2. Create a New Automation Agent
- Click New Agent.
- If you have an unfinished draft, Aliveo asks whether to continue it. Click Yes, Continue to pick up the draft, or No, Create New to start over.
- To start from an agent you already have, use Copy on its card instead (see Managing Agents).
Setup has three steps: Select Accounts, Select Agent Template and Configure Context. Click Next Step to move on and Back to go back.
3. Select Account(s)
- Choose the account(s) your agent will work on. The templates you see next depend on this choice.
- Accounts that are still loading data show Not yet ready and can't be selected.
4. Choose a Template
- Pick a pre-built template, or Custom Agent to start from a blank slate. (The page is headed Step 2: Template Selection.)
- Filter by group (Monitoring Agents, Optimization Agents, Reporting Agents, Keyword Agents, Creative Agents, Actioning Agents) or use Search for a template.
- For the full list, see the Agent Library.
5. Configure Context
This is where you set your agent's mission.
- Title and Description — filled in from the template. Click either one to edit it.
- Data Context — the main data the agent reads (for example, Keyword Data or Ad Performance Data).
- Grouping Context — the level the data is grouped at (for example, Campaign).
- Workflow Specific Context — instructions that apply to every step (for example, "Use the last 12 weeks of data"). This layers on top of your Account, Org and Global context. See The Context System for how the levels stack.
Pre-built templates set Data Context and Grouping Context for you. You can change them only for Custom Agent and the Custom Actioning templates.
Some templates show a note at the top with values to fill in, such as a page name or an ad-name pattern. Update these in Workflow Specific Context before you continue.
Instructions
Pre-built templates also list their steps under Instructions. Edit any step's text, delete a step, or add one with Analyze or Summarize:
- Analyze — runs one analysis and can output a table and a chart.
- Summarize — pulls together the results of the Analyze steps. An agent can have one Summarize step, and it is always last.
6. Start Building
Click Start Building. What happens next depends on the template:
- Pre-built templates — Aliveo saves the agent and runs it in the background. A Scheduled Execution message confirms the run, and closing it takes you to the Drafts tab. When the run finishes, you get a notification and the agent moves to Reports with the template's default schedule. Change the schedule any time with Schedule on its card.
- Custom Agent and Custom Actioning templates — Aliveo opens the playground, where you write and test the steps yourself.
7. Build and Test in the Playground
The playground is where you write steps, run them and check the output before you save. You also land here when you Edit an agent.
- Write steps in chat. Describe what you want in the chat panel. Type @ to refer to an existing step, for example to change it.
- Add a step. Use Add Step to write one yourself.
- Run and review. Each step runs in turn and shows its result, with the table, chart and the code it used.
- Confirm the dates. Aliveo works out each step's date range from your instructions. Click Confirm Date on a step to open Confirm generated dates, check the range and change it if needed. Relative dates such as "last 12 weeks" move forward with every scheduled run. Saving a new date re-runs the step.
- Edit. Use Edit Description on a step to change its instructions, or Edit Context to change the agent's context.
- Finish the run. Execute remaining & save runs every step you haven't run yet and saves the agent. While it runs, the report shows in Drafts.
8. Set Scheduling Preferences & Save
Click Save in the playground. A dialog asks Do you want to save the workflow and schedule it?
Schedule types
Choose One off to run once, or Scheduled to repeat it. For a scheduled agent, pick:
| Schedule | Runs |
|---|---|
| Daily | Every day |
| Weekly | Every 7 days |
| Biweekly | Every 14 days |
| Monthly | Every 30 days |
| Month start | On the 1st of every month |
| Specific day | On a day of the month you choose, such as the 15th |
Monthly, Month start and Specific day share one button: click the arrow next to Monthly to switch between them. With Specific day, months that don't have that day run on their last day. Pick the 31st and February runs on the 28th or 29th.
Set the Next Execution Date for the first run. The info panel below the schedule buttons shows the next three execution dates. The Schedule Help icon lists each schedule type.
Notifications
For scheduled agents, Notification Settings has two switches:
- Email — each run is emailed to you and to anyone you shared the agent with. Each recipient gets their own email. To add more recipients, use Email on the agent's card (see Managing Agents).
- Slack — each recipient gets the report as a Slack direct message from the Aliveo app. See Slack Integration.
With Email on, you can also add a Conditional Alert: a condition such as "CTR drops more than 20% week over week". The email then goes out only when the condition is met. Leave it empty to get an email after every run.
To also send each run's tables to a Google Sheet, turn on Auto-Export to Google Sheets.
Click Save & Close to save your agent. It now runs on your schedule.
If you close the playground without saving, the same dialog offers Close without Saving.
9. Re-running and Refreshing
Once an agent is live, you can run it again from its card's three-dot menu:
- Re-run — runs the saved plan and code again on the latest data. Use this when the data has been refreshed.
- Fresh run — deletes the saved plans and code, writes new ones from the agent's instructions and context, then runs them. Use this after you change your Account, Org or Global context, or to pick up a newer version of the template.
See Managing Agents for the full menu.
Automation Agents help you automate repetitive analysis, deliver consistent insights, and save time. Explore templates, customize steps, and schedule your agents to fit your business needs!



