Skip to content
Docs/AI Agent

Agent Handoffs

When you ask a complex question that falls squarely into one domain, the main agent can hand off to a specialized sub-agent. Each sub-agent has a focused system prompt and a filtered set of tools, making it more effective at its specialty.

Available Specialists

SEO Audit Specialist

Focused on technical SEO: crawling, metadata, headers, structured data, robots.txt, sitemaps, broken links, redirects, canonicals, internal linking, and Core Web Vitals. Use this for comprehensive site health checks.

Content Strategist

Focused on content: keyword research, content briefs, meta writing, content analysis, content gaps, topic ideas, topic authority, SERP analysis, and competitor content comparison. Use this for content planning and optimization.

Analytics Analyst

Focused on data: Search Console queries/pages/dates, traffic analytics, Ahrefs metrics, and position tracking. Use this for data-driven insights and trend analysis.

When Handoffs Happen

The main agent decides when to hand off based on the request. For example:

  • "Do a deep technical audit of my site" - hands off to SEO Audit Specialist
  • "Help me plan content for the next quarter" - hands off to Content Strategist
  • "Analyze my traffic trends for the last 6 months" - hands off to Analytics Analyst
  • "Check my site and suggest improvements" - the main agent handles it directly since it spans multiple domains

How It Works Internally

When a handoff occurs, the sub-agent runs its own tool-calling loop with its specialized prompt and filtered tools. Once it finishes, its findings are returned to the main agent, which can add context or follow up.