Help Center/HOW TO Guides/Run AI Marketing Agent Swarms
Back to Guides
Intermediate · 12 minutes

How to Run AI Marketing Agent Swarms

Orchestrate multiple AI agents to plan, create, and optimize your marketing at scale

What You'll Learn

What marketing agent swarms are
The 6 AI agent personas and their roles
How to enter an objective and select a workflow
Execute a swarm and view streaming output
Approval flows for high-impact actions
Track costs and token usage
Understand service tier limits
Best practices for agent orchestration

What Are Marketing Agent Swarms?

A marketing agent swarm is a multi-agent AI orchestration system. Instead of chatting with a single AI, you define a marketing objective and IPX coordinates multiple specialized AI agents to work on it simultaneously — each contributing their expertise area.

Think of it as a virtual marketing team: one agent handles strategy, another writes copy, another plans media buys, and another analyzes performance — all working in concert toward your objective.

The 6 AI Agent Personas

Strategy Director

Develops high-level marketing strategy, competitive positioning, audience segmentation, and campaign roadmaps

Content Specialist

Creates copy, headlines, ad creatives, blog posts, email sequences, and social media captions

Social Media Manager

Plans posting schedules, engagement tactics, hashtag strategies, and community management playbooks

Media Buyer

Recommends ad spend allocation, bidding strategies, audience targeting, and platform selection

Analytics Expert

Analyzes campaign data, identifies trends, forecasts performance, and generates automated insight reports

Influencer Scout

Identifies potential creator partners, evaluates audience fit, and suggests outreach strategies

Step-by-Step: Running a Swarm

1

Open the Swarm Executor

From the Marketing Command Center, click the "Run Swarm" button or navigate to the Swarm Executor panel:

  • Go to Dashboard → Marketing → Swarm Executor
  • Verify the correct entity is selected in the top bar
2

Enter Your Marketing Objective

Type a clear, specific objective into the input field. The more context you provide, the better the agents will perform:

Good: "Create a 30-day social media launch campaign for our new DeFi token targeting crypto-native millennials on Twitter and Instagram, with a $5,000 ad budget"

Too vague: "Market my token"

3

Select a Workflow Preset

Choose a workflow that determines which agents participate and in what order:

Full Campaign

All 6 agents — strategy through analytics

Content Blitz

Content Specialist + Social Media Manager

Paid Media

Strategy Director + Media Buyer + Analytics

Influencer Outreach

Influencer Scout + Strategy Director

Performance Audit

Analytics Expert + Strategy Director

Custom

Pick which agents to include manually

4

Execute and View Streaming Output

Click "Execute Swarm" to start. You'll see real-time streaming output as each agent works:

  • Each agent's output streams in its own labeled panel
  • Status indicators show which agents are active, queued, or complete
  • A consolidated summary is generated once all agents finish

Tip: You can leave the page while a swarm is running. The results will be saved and accessible from your Marketing > Swarm History tab.

5

Review Approval Flows

Certain high-impact actions require your explicit approval before agents execute them:

  • Budget commits: Any action that would spend real ad dollars
  • Public publishing: Posting content to live social channels
  • Outreach messages: Sending DMs or emails to creators on your behalf

Important: Approval requests appear as inline prompts within the swarm output. You can approve, reject, or modify each action. Unapproved actions time out after 24 hours.

6

Track Costs and Usage Limits

Each swarm execution consumes AI tokens. Monitor your usage in real time:

  • Token Counter: A live token counter is displayed at the bottom of the swarm executor during execution
  • Cost Tracking: Go to Marketing Settings > Billing & Costs to view your running total, per-swarm breakdown, and monthly limits
  • Limits Reset: Monthly usage limits reset on your billing date. You'll receive a warning at 80% utilization

Service Tiers

Starter

  • 2 agents (Content, Analytics)
  • 5 swarms/month
  • 100K tokens/month

Professional

  • All 6 agents
  • 50 swarms/month
  • 1M tokens/month

Enterprise

  • All 6 agents + custom agents
  • Unlimited swarms
  • 10M tokens/month

White-Label

  • Custom agent branding
  • Unlimited + API access
  • Custom allocation

Best Practices

Be specific with your objective

Include target audience, budget constraints, timeline, and platform preferences. The more context agents have, the more actionable their output.

Start with a Performance Audit preset

Before running a full campaign swarm, audit your current data so agents can build on real performance history instead of starting blind.

Review approval items promptly

Pending approvals block downstream agent work. Check your approval queue at least daily when a swarm is active.

Monitor token usage early in the month

Full Campaign presets use the most tokens. If you are on a Starter or Professional plan, reserve capacity for end-of-month reporting swarms.

Troubleshooting

Swarm execution stalls or times out

Problem: The swarm starts but one or more agents never finish, or the whole execution times out.

Solution:

Try the following:

  • Check if an approval request is blocking — open the Approvals tab
  • Reduce the scope of your objective if it's very broad
  • Try a smaller preset (e.g., Content Blitz instead of Full Campaign)
  • Check the status page for any ongoing service issues

Agent output quality is low

Problem: The agents produce generic or unhelpful output.

Solution:

Quality depends heavily on your input:

  • Add more specifics to your objective — audience, budget, channels, timeline
  • Make sure ad platform data is connected so agents can reference real performance
  • Use the Performance Audit preset first to give agents baseline context
  • Consider upgrading your tier for access to higher-capability models

Token limit reached mid-swarm

Problem: The swarm stops partway through with a 'token limit exceeded' error.

Solution:

Your monthly token allocation has been exhausted:

  • Check current usage in Marketing Settings > Billing & Costs
  • Wait for your monthly reset, or upgrade your tier for more capacity
  • Use smaller presets (2-agent) to conserve tokens on remaining tasks
  • Enterprise and White-Label tiers offer significantly higher limits

Related Guides

Still Need Help?

Our AI specialists can help you design the perfect swarm workflow for your goals