Get Agent Stats

Get comprehensive performance statistics for an agent

GET /v1/agents/{agent_id}/stats

cURL

curl https://api.playgent.com/v1/agents/agent_abc123/stats \
  -H "Authorization: Bearer your-api-key"

Response

{
  "agent_id": "agent_abc123",
  "total_runs": 156,
  "total_turns": 423,
  "pass_rate": 0.847,
  "avg_latency_ms": 2340,
  "avg_token_usage": {
    "input": 450,
    "output": 320
  },
  "scorer_breakdown": {
    "relevance": { "avg": 0.89, "min": 0.45, "max": 1.0 },
    "faithfulness": { "avg": 0.92, "min": 0.71, "max": 1.0 }
  },
  "trend_7d": {
    "pass_rate_delta": 0.05,
    "latency_delta_ms": -120
  },
  "top_failure_reasons": [
    { "reason": "Hallucination detected", "count": 12 },
    { "reason": "Off-topic response", "count": 8 }
  ]
}

Retrieve detailed performance metrics, pass rates, and failure analysis for an agent.

agent_id · string · required

Unique identifier for the agent

agent_id · string · required

Agent identifier

total_runs · integer · required

Total number of test runs

total_turns · integer · required

Total number of turns across all runs

pass_rate · number · required

Overall pass rate (0-1)

avg_latency_ms · integer · required

Average response latency in milliseconds

avg_token_usage · object · required

Average token usage per turn

Show properties

input · integer

Average input tokens

output · integer

Average output tokens

scorer_breakdown · object · required

Statistics per scorer

Show properties

[scorer_name] · object

Show properties

avg · number

Average score

min · number

Minimum score

max · number

Maximum score

trend_7d · object · required

7-day performance trend

Show properties

pass_rate_delta · number

Change in pass rate

latency_delta_ms · integer

Change in latency

top_failure_reasons · array · required

Most common failure reasons

cURL

curl https://api.playgent.com/v1/agents/agent_abc123/stats \
  -H "Authorization: Bearer your-api-key"

Response

{
  "agent_id": "agent_abc123",
  "total_runs": 156,
  "total_turns": 423,
  "pass_rate": 0.847,
  "avg_latency_ms": 2340,
  "avg_token_usage": {
    "input": 450,
    "output": 320
  },
  "scorer_breakdown": {
    "relevance": { "avg": 0.89, "min": 0.45, "max": 1.0 },
    "faithfulness": { "avg": 0.92, "min": 0.71, "max": 1.0 }
  },
  "trend_7d": {
    "pass_rate_delta": 0.05,
    "latency_delta_ms": -120
  },
  "top_failure_reasons": [
    { "reason": "Hallucination detected", "count": 12 },
    { "reason": "Off-topic response", "count": 8 }
  ]
}