Skip to main content

Introduction

Once your agent is configured and tested, you can execute it in two ways:

Immediate execution

Launch a task now and get results instantly

Scheduling

Schedule automatic executions according to a calendar

Immediate execution

Launch a task manually

In tasks pages, invoke your agents How to test your Agent
1

Select your agent

In your project, click on the agent to execute
2

Provide parameters

If agent requires input data, fill out the form
3

Launch execution

Confirm to start the task

Agent Orchestration (Magentic)

What is agent orchestration?

Agent orchestration allows you to create agent teams that collaborate to accomplish complex tasks. Each agent has its specialized role, and together they form an intelligent and coordinated system.
Powered by Magentic: We use the Magentic framework for multi-agent orchestration, enabling intelligent and autonomous coordination.

Why orchestration?

Some tasks require multiple skills:Example: Product launch
  • Marketing Agent: Creates content and visuals
  • Social Media Agent: Schedules posts
  • Analytics Agent: Tracks performance
  • CRM Agent: Updates customer segments
  • Orchestrator: Coordinates everything

Monitor execution in real-time

Once launched, you can monitor your task live:

Status

Running, Succeeded, Failed, Pending

Progress

Current step and % completion

Live logs

Each action performed in real-time

Task scheduling

Create a schedule

1

Access scheduling

On your agent’s page, click “Schedule”
2

Choose frequency

Select from predefined options or create custom rule
3

Define parameters

Time, timezone, and any input parameters
4

Enable scheduling

Save and enable to start automation

Predefined frequencies

⏰ Every hour
⏰ Every 2 hours
⏰ Every 6 hours
⏰ Every 12 hours
Use cases: Monitoring, real-time alerts, competitive intelligence

Custom scheduling (Enterprise)

For specific needs, use cron syntax:
# Format: minute hour day month day_of_week

# Every weekday at 9:00 AM
0 9 * * 1-5

# Every Monday and Wednesday at 2:30 PM
30 14 * * 1,3

# 1st and 15th of each month at 8:00 AM
0 8 1,15 * *

# Every 15 minutes
*/15 * * * *

# Every day at 9am, 12pm and 6pm
0 9,12,18 * * *

# Last day of each month at midnight
0 0 28-31 * *
Test tool: Use crontab.guru to verify your cron syntax and visualize next executions.

Execution history

View history

All executions are recorded and accessible:
Overview of all executions:
  • Date and time
  • Duration
  • Status (Success / Failure)
  • Cost in credits
  • Trigger (Manual / Scheduled / Event)

Notifications

Stay informed about your agent executions.

Configure notifications

notifications:
  email:
    enabled: true
    recipients: ["[email protected]", "[email protected]"]
    events:
      - on_failure
      - on_success_if_critical
    include_logs: true
    include_results: true

Best practices

  • Avoid peak hours for heavy tasks
  • Space out executions to avoid overloading third-party APIs
  • Use explicit timezones
  • First test with low frequency
  • Always configure a retry strategy
  • Enable failure notifications
  • Regularly monitor history
  • Keep a fallback agent
  • Use economical models for simple tasks
  • Limit number of parallel executions
  • Archive obsolete agents
  • Monitor credit consumption

Next steps