Get Trends

Get performance trends over time

GET /v1/analytics/trends

cURL

curl "https://api.playgent.com/v1/analytics/trends?agent_id=agent_abc123&period=30d&granularity=day&metrics=pass_rate,avg_faithfulness,avg_latency_ms,total_cost_usd" \
  -H "Authorization: Bearer your-api-key"

Response

{
  "period": { "start": "2024-11-16", "end": "2024-12-16" },
  "data_points": [
    {
      "date": "2024-11-16",
      "runs": 45,
      "pass_rate": 0.78,
      "avg_faithfulness": 0.84,
      "avg_latency_ms": 2450,
      "total_cost_usd": 1.23
    },
    {
      "date": "2024-11-17",
      "runs": 52,
      "pass_rate": 0.81,
      "avg_faithfulness": 0.86,
      "avg_latency_ms": 2380,
      "total_cost_usd": 1.45
    }
  ],
  "summary": {
    "total_runs": 1234,
    "overall_pass_rate": 0.85,
    "trend": "improving",
    "cost_total_usd": 45.67
  }
}

Retrieve performance metrics and trends for an agent over a specified time period.

agent_id · string

Filter by agent ID (optional)

period · string · required

Time period (e.g., “7d”, “30d”, “90d”)

granularity · string

Data granularity: hour, day, week (default: day)

metrics · string

Comma-separated metrics to include: pass_rate, avg_faithfulness, avg_relevance, avg_latency_ms, total_cost_usd

period · object · required

Time period

Show properties

start · string

Start date

end · string

End date

data_points · array · required

Time series data

Show data point

date · string

Date

runs · integer

Number of runs

pass_rate · number

Pass rate

avg_faithfulness · number

Average faithfulness score

avg_latency_ms · integer

Average latency

total_cost_usd · number

Total cost

summary · object · required

Period summary

Show properties

total_runs · integer

Total runs

overall_pass_rate · number

Overall pass rate

trend · string

Trend: improving, stable, declining

cost_total_usd · number

Total cost

cURL

curl "https://api.playgent.com/v1/analytics/trends?agent_id=agent_abc123&period=30d&granularity=day&metrics=pass_rate,avg_faithfulness,avg_latency_ms,total_cost_usd" \
  -H "Authorization: Bearer your-api-key"

Response

{
  "period": { "start": "2024-11-16", "end": "2024-12-16" },
  "data_points": [
    {
      "date": "2024-11-16",
      "runs": 45,
      "pass_rate": 0.78,
      "avg_faithfulness": 0.84,
      "avg_latency_ms": 2450,
      "total_cost_usd": 1.23
    },
    {
      "date": "2024-11-17",
      "runs": 52,
      "pass_rate": 0.81,
      "avg_faithfulness": 0.86,
      "avg_latency_ms": 2380,
      "total_cost_usd": 1.45
    }
  ],
  "summary": {
    "total_runs": 1234,
    "overall_pass_rate": 0.85,
    "trend": "improving",
    "cost_total_usd": 45.67
  }
}