Skip to main content

Phoenix Agents

Phoenix Agents are AI-powered automation workflows that generate comprehensive research outputs using Phoenix MCP tools. Agents run asynchronously and produce artifacts like HTML briefs, PDFs, or structured data.

What are Phoenix Agents?​

Unlike interactive MCP tools that return immediate results, Phoenix Agents:

  • Run asynchronously - Submit a request and poll for completion
  • Produce artifacts - Generate formatted outputs (HTML briefs, PDFs)
  • Use multiple tools - Orchestrate 10+ MCP tools in a single workflow
  • Track execution - Provide traces for debugging and auditing

Available Agents​

AgentDescriptionOutput
Account Research BriefGenerate comprehensive account research briefs for sales enablementHTML brief
POV Trigger AnalystIdentify buying triggers from financial statements and earnings callsHTML brief
Buying Committee MapperMap stakeholders, assign buying roles, and recommend engagement strategiesHTML brief
Cold Email IcebreakerGenerate personalized 7-email cold outreach sequences with anti-AI detectionHTML sequence

How Agents Work​

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Your App       │     │  Agent Service  │     │  Phoenix MCP    │
│                 │────▶│  (FastAPI)      │────▶│  Tools          │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        │  1. Start run         │  2. Execute agent     │
        │                       │     (calls tools)     │
        │                       │                       │
        │  3. Poll status       │                       │
        │◀──────────────────────│                       │
        │                       │                       │
        │  4. Get artifacts     │                       │
        │◀──────────────────────│                       │
  1. Start a run - Submit input (company domain or ID) and parameters
  2. Agent executes - The agent calls multiple Phoenix MCP tools to gather data
  3. Poll for status - Check run status until completion
  4. Retrieve artifacts - Download the generated brief or report

Quick Example​

# 1. Start an account research run
curl -X POST "https://phoenix.hginsights.com/api/agents/v1/agents/account-research/runs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {"domain": "salesforce.com"},
    "params": {"depth": "standard"}
  }'

# Response: {"run_id": "abc-123", "status": "queued"}

# 2. Poll for completion
curl "https://phoenix.hginsights.com/api/agents/v1/runs/abc-123" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response: {"run_id": "abc-123", "status": "succeeded", "progress": 1.0}

# 3. Get the generated brief
curl "https://phoenix.hginsights.com/api/agents/v1/runs/abc-123/artifacts" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response: {"artifacts": [{"artifact_type": "html", "url": "/v1/runs/abc-123/artifacts/brief.html"}]}

Authentication​

Phoenix Agents use the same API keys as Phoenix MCP tools. Include your API key in the Authorization header:

Authorization: Bearer phx_your_api_key_here

To generate an API key:

  1. Log into Phoenix at https://phoenix.hginsights.com
  2. Navigate to Settings → API Keys
  3. Click Generate New API Key
warning

Keep your API keys secure. Never commit them to version control or share them publicly.

Next Steps​