Skip to content

Managing Automation Agents

Manage your automation agents: finish drafts, copy and edit agents, schedule runs, re-run for fresher data, and share with your team.

The Automation Agents page has five tabs:

  • Reports — your saved agents.
  • Drafts — agents you haven't finished.
  • Aggregated — combined reports (see Aggregated Reports).
  • Shared with Me — agents others shared with you.
  • Globally Shared — agents shared with everyone in your organization.

1. Editing Drafts

  • Unfinished agents automatically become drafts.
  • Open the Drafts tab to see them.
  • Click any draft to continue setting it up.
  • Drafts let you refine instructions, steps and scheduling before activation.

💡 Tip: Use drafts to experiment with agent setups before making them live.

Edit Draft


2. Managing Agents in Reports Tab

On the Reports tab, each agent card has a menu (three horizontal dots) with these options:

  • Re-run: Run the saved plan and code again on the latest data. This is the fastest way to refresh a report.
  • Fresh run: Delete the saved plans and code, write new ones from the agent's instructions and context, then run them. Use this after you change your Account, Org or Global context, or to pick up a newer version of the template.
  • Copy: Create a full copy of the agent, including all instructions and steps.
  • Edit: Open the agent in the playground to change its steps or context.
  • Schedule: View or change the schedule and notifications. See Schedule types.
  • Auto-Export: Add every successful run's tables to a Google Sheet.
  • View Instructions: See the agent's context and step-by-step instructions.
  • Email: Choose who gets the report by email (see Notifications & Delivery).
  • Share: Share the agent with others (see Collaboration Features).
  • Rename: Change the agent's title.
  • Delete: Permanently remove the agent.

Cards on the Aggregated tab offer only Email, Share, Rename and Delete.

⚠️ Note: Deleted agents cannot be recovered.

Agent Options

Run status

While an agent runs, its card shows In Progress. If a run fails, the card shows Failed. Edit to fix! (on a draft, Failed. Click to fix!). Open the agent, fix the step that failed, and run it again.

If a scheduled run finds that the agent has no saved code to run, Aliveo automatically does a Fresh run instead.


3. Aggregated Reports

When two or more of your agents use the same pre-built template on the same schedule, with Email on, Aliveo combines their results into one report on the Aggregated tab and sends one email instead of several. This applies to weekly, biweekly and monthly schedules, not to one-off or daily agents, and not to Custom Agent or Custom Actioning agents.


4. Scheduling Agents

  • Set how often your agent should run: One off, Daily, Weekly, Biweekly, Monthly (every 30 days), Month start or Specific day of the month.
  • Change the schedule any time with Schedule on the agent's card.
  • Scheduled agents generate reports and send notifications as configured.
  • The info panel shows the next three execution dates so you can check them before saving.

Scheduling


5. Collaboration Features

  • Share Globally: Make the agent visible to everyone in your organization. They find it on their Globally Shared tab.
  • Share a Copy (via Email): Send a copy of the agent to a user (they need an Aliveo AI account). They can edit it independently; your original is untouched.
  • Share a View (via Email): Let a user view your agent as it is (they need an Aliveo AI account). They can't edit or change it. They find it on their Shared with Me tab.

⚠️ Note: Copies and shared views are independent and do not affect your original agent.

Collaboration


6. Deep-Dive Into a Report

Every report has a Deep Dive button in its right sidebar. It opens a Report Chat panel pre-loaded with the run's accounts, dates and outputs. Use it for drilldowns ("break this CPA spike down by market") or what-if questions without leaving the report.

Each run keeps its own Report Chat history; resume a past chat from the history popover in the panel header. Full guide: Report Chat.


7. Notifications & Delivery

Turn delivery on or off with the Email and Slack switches in the agent's schedule settings.

  • Email — each run is emailed to you and to anyone you shared the agent with. Each recipient gets their own email.
  • Slack — each recipient gets the report as a Slack direct message from the Aliveo app. See Slack Integration.

To send the report to more people, use Email on the agent's card:

  1. Generate a preview of the email and approve it.
  2. Add recipients. Paste or type addresses, separated by commas, tabs or new lines.
  3. Send it now, and turn on Send on scheduled runs to reuse the same email setup for future scheduled runs.

You can add addresses outside your organization only for the client domains your organization allows. To enable external domains, contact support.


Managing your automation agents is simple and flexible!