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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# List all deployed agents
$ 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
 
# Detailed view
$ 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# 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
Agents in "degraded" status are still operational but may have performance issues. Check resource allocation and consider scaling up.

JSON Output

Get structured output for automation:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# JSON output for scripting
$ 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
}
Deploy new agents with agent deploy.