google-agents-cli-eval

Evaluate ADK agents with metrics, evalsets, and the iterative eval-fix loop.

google ↓ 60k
Claude Code
View source ↗

What it does

  • Inference input (what you give to eval generate) — a user prompt or a partial conversation ending in a user prompt. The agent runs and produces traces.
  • metricstorun — the selection list of metric names to execute on this run. Names resolve to built-in metrics first, then to entries in custommetrics.
  • multiturntasksuccess # built-in
  • examplellmmetric # selected from custommetrics pool below
  • agentturncount # selected from custommetrics pool below
  • name: examplellmmetric
  • name: agentturncount

Requirements & configuration

  • Requires: agents-cli (uv tool install google-agents-cli) — install uv first if needed.
  • | "I just need to fix the eval dataset, not the agent" | If you're always adjusting expected outputs, your agent has a behavior problem. Fix the instructions or tool logic first. |
  • {agentdata} — the full structured turns/events trace, useful when the judge needs to reason about tool calls or intermediate reasoning.

Configuration: GOOGLE_CLOUD_LOCATIONGOOGLE_GENAI_USE_VERTEXAIGEMINI_API_KEY

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Evaluate ADK agents with metrics, evalsets, and the iterative eval-fix loop.

Source

Repository: https://github.com/google/agents-cli

google-agents-cli-eval FAQ

What does the google-agents-cli-eval skill do?

> This skill should be used when the user wants to "run an evaluation", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Agent Platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Do NOT use for API code patterns (use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold). Inference input (what you give to eval generate) — a user prompt or a partial conversation ending in a user prompt. The agent runs and produces traces. metricstorun — the selection list of metric names to execute on this run. Names resolve to built-in metrics first, then to entries in custommetrics.

What does google-agents-cli-eval require?

Requires: agents-cli (uv tool install google-agents-cli) — install uv first if needed. | "I just need to fix the eval dataset, not the agent" | If you're always adjusting expected outputs, your agent has a behavior problem. Fix the instructions or tool logic first. | {agentdata} — the full structured turns/events trace, useful when the judge needs to reason about tool calls or intermediate reasoning. Configuration keys: GOOGLE_CLOUD_LOCATION, GOOGLE_GENAI_USE_VERTEXAI, GEMINI_API_KEY.

How do I install google-agents-cli-eval?

Run: npx -y skills add https://github.com/google/agents-cli --skill google-agents-cli-eval --agent claude-code — the source lives at github.com/google/agents-cli.

Maintain google-agents-cli-eval?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

google-agents-cli-eval on getagentictools
[![google-agents-cli-eval on getagentictools](https://getagentictools.com/badge/skills/google-agents-cli-google-agents-cli-eval.svg)](https://getagentictools.com/skills/google-agents-cli-google-agents-cli-eval?ref=badge)
npx agentictools info skills/google-agents-cli-google-agents-cli-eval

The second line is the CLI lookup for this page — handy in READMEs and docs.