beam-get-agent-analytics

Retrieve Beam.ai agent analytics for task counts, completion rates, and evaluation scores.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/beam-ai-team/beam-next-skills --skill beam-get-agent-analytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beam-get-agent-analytics
Source: https://github.com/beam-ai-team/beam-next-skills/tree/main/skills/beam/beam-tools/beam-get-agent-analytics
Command: npx skills add https://github.com/beam-ai-team/beam-next-skills --skill beam-get-agent-analytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Retrieve Beam.ai agent analytics to quantify performance metrics such as task counts, completion rates, and evaluation scores.

Core Features & Use Cases

  • Retrieve task counts, completion rates, average evaluation score, and runtime for Beam.ai agents.
  • Support queries over custom date ranges or preset windows (e.g., last 7, 30, or 90 days) for production monitoring, trend analysis, and reporting.
  • CLI-based retrieval and optional JSON export for easy integration with dashboards.

Quick Start

Run the get_agent_analytics.py script with your agent_id to retrieve analytics for a chosen date range.

Frequently Asked Questions about beam-get-agent-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve agent analytics and performance metrics using the Beam API?

Retrieve Beam.ai agent analytics by running the get_agent_analytics.py script, which queries the /agent-tasks/analytics endpoint to return task counts, completion rates, and evaluation scores.

Can I query Beam.ai agent task completion rates for a custom date range?

Yes, you can query agent task completion rates over custom date ranges or preset windows like the last 7, 30, or 90 days by passing the agentId, startDate, and endDate parameters to the analytics endpoint.

How do I export agent performance metrics to JSON for dashboard reporting?

Export agent performance metrics to JSON by executing the CLI-based retrieval script, which returns structured analytics data suitable for integration with external production monitoring dashboards.

What metrics are available when monitoring Beam.ai agents in production?

Available metrics for monitoring Beam.ai agents include total task counts, completion rates, average evaluation scores, and runtime statistics, all retrievable via the analytics endpoint.

Do I need any specific dependencies to run the agent analytics script?

No external dependencies are required to run the agent analytics script, which uses a built-in BeamClient to call the /agent-tasks/analytics endpoint and display structured performance data.

Why am I getting missing data when pulling analytics for my Beam agent?

Missing analytics data typically occurs when the queried agentId has no task activity within the specified startDate and endDate range, so verify your agent's active production dates before querying.