Hyperfold AI

Agent List

View and monitor deployed agents and their status.

Overview

The hyperfold agent list command shows all deployed agents with their current status, performance metrics, and configuration. Use it to monitor agent health and identify issues.

List Agents

View all agents in your project:

hyperfold agent list
$ hyperfold agent list

AGENTS (4 total)

NAME                 TYPE          STATUS    SESSIONS   LAST ACTIVE
sales-bot-01         negotiator    active    127        2 min ago
sales-bot-02         negotiator    active    89         5 min ago
fulfillment-agent    fulfillment   active    45         1 min ago
recommender-01       recommender   idle      0          3 hours ago

$ hyperfold agent list --verbose

NAME: sales-bot-01
  ID:           agent_abc123
  Type:         negotiator
  Status:       active
  Region:       us-central1
  Created:      2025-12-01T10:00:00Z
  Last Active:  2025-12-19T14:28:00Z

  PERFORMANCE (24h):
    Sessions:       127
    Conversions:    42 (33%)
    Avg Discount:   12.3%
    Revenue:        $8,450

  CONFIGURATION:
    Model:          gpt-4o
    System Prompt:  1,247 tokens
    Max Sessions:   50 concurrent

Agent Types

TypePurpose
negotiatorPrice negotiation with buyer agents
fulfillmentOrder fulfillment and shipping
recommenderProduct recommendations and bundles
orderOrder management and status
adsPromotional content for ad networks
customCustom agent implementations

Agent Details

Get comprehensive information about a specific agent:

# Get detailed info for specific agent
$ hyperfold agent get sales-bot-01

AGENT: sales-bot-01
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

IDENTITY
  ID:             agent_abc123
  Name:           sales-bot-01
  Type:           negotiator
  Status:         active

DEPLOYMENT
  Region:         us-central1
  Instances:      3 (auto-scaled)
  Cloud Run URL:  https://sales-bot-01-xyz.run.app

CONFIGURATION
  LLM Model:      gpt-4o
  Temperature:    0.7
  Max Tokens:     2048
  System Prompt:  "./prompts/negotiator-v2.txt"

CONNECTIONS
  Catalog:        Firestore (default)
  Payments:       Stripe (connected)
  CRM:            Salesforce (connected)

LIMITS
  Max Concurrent: 50 sessions
  Rate Limit:     100 req/min
  Session TTL:    1 hour

METRICS (last 24h)
  Total Sessions:     127
  Active Sessions:    12
  Conversion Rate:    33%
  Avg Response Time:  1.2s
  Error Rate:         0.3%

Filtering & Search

Filter the agent list by various criteria:

# Filter by status
$ hyperfold agent list --status=active
$ hyperfold agent list --status=idle
$ hyperfold agent list --status=error

# Filter by type
$ hyperfold agent list --type=negotiator
$ hyperfold agent list --type=fulfillment
$ hyperfold agent list --type=recommender

# Search by name
$ hyperfold agent list --search="sales"

# Filter by region
$ hyperfold agent list --region=us-central1

# Multiple filters
$ hyperfold agent list --type=negotiator --status=active

# Output as JSON
$ hyperfold agent list --output=json

Status Monitoring

Monitor agent status in real-time:

# Watch agent status in real-time
$ hyperfold agent list --watch

[Live] Refreshing every 5s... (Ctrl+C to stop)

NAME                 STATUS    SESSIONS   REQ/MIN   ERRORS
sales-bot-01         active    127 →129   45        0
sales-bot-02         active    89         32        0
fulfillment-agent    active    45 →47     28        0
recommender-01       idle      0          0         0

[14:30:15] sales-bot-01: New session started
[14:30:18] fulfillment-agent: Order fulfilled (order_789)
[14:30:22] sales-bot-01: Conversion! $162.00

# Health check for all agents
$ hyperfold agent health

AGENT HEALTH CHECK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

sales-bot-01         ✓ healthy
  Response time:     120ms (p95: 340ms)
  Memory:            256MB / 512MB
  CPU:               23%

sales-bot-02         ✓ healthy
  Response time:     115ms (p95: 310ms)
  Memory:            234MB / 512MB
  CPU:               19%

fulfillment-agent    ⚠ degraded
  Response time:     890ms (p95: 2.1s) ← HIGH
  Memory:            478MB / 512MB ← NEAR LIMIT
  CPU:               67%

recommender-01       ✓ healthy (idle)
  Last active:       3 hours ago

JSON Output

Get structured output for automation:

$ hyperfold agent list --output=json

{
  "agents": [
    {
      "id": "agent_abc123",
      "name": "sales-bot-01",
      "type": "negotiator",
      "status": "active",
      "region": "us-central1",
      "metrics": {
        "sessions_24h": 127,
        "conversion_rate": 0.33,
        "avg_response_ms": 120
      }
    }
  ],
  "total": 4,
  "active": 3,
  "idle": 1
}