google-agents-cli-eval

Evaluates ADK agents using datasets, metrics, and LLM-as-judge grading workflows.

Updated Jun 27, 2026
One-click install
npx skills add https://github.com/God-Gamer-Manyu/Google_Agentic_Engineering --skill google-agents-cli-eval-god-gamer-manyu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-agents-cli-eval
Source: https://github.com/God-Gamer-Manyu/Google_Agentic_Engineering/tree/main/.agents/skills/google-agents-cli-eval
Command: npx skills add https://github.com/God-Gamer-Manyu/Google_Agentic_Engineering --skill google-agents-cli-eval-god-gamer-manyu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-agents-cli, and includes references (resource) components.

What problem does it solve? Building an AI agent is only half the battle — knowing whether it actually works reliably is the hard part. This Skill guides you through the Agent Platform evaluation methodology so you can measure agent quality with structured datasets, built-in and custom metrics, and iterative failure analysis instead of guessing. ## Core Features & Use Cases - Quality Flywheel Workflow: Follow the five-stage loop (prepare data, run inference, grade traces, analyze failures, optimize) using agents-cli eval commands like generate, grade, compare, analyze, and optimize. - Metrics Selection & Custom Metrics: Choose from built-in metrics such as multi_turn_task_success, multi_turn_tool_use_quality, hallucination, and safety, or define custom LLM-as-judge and code-execution metrics in eval_config.yaml. - Dataset & Trace Schemas: Author single-turn, multi-turn, and multi-agent evaluation datasets, synthesize conversations with user simulation, and handle special cases like google_search built-in tools and multimodal inputs. - Use Case: Your agent's tool_use_quality score is low. Open the grade results, inspect the rubric verdicts, refine the tool descriptions, rerun generate and grade, then use eval compare to confirm the fix improved the metric without regressions. ## Quick Start Ask the assistant to run an evaluation of your ADK agent and analyze any failing metrics using the agents-cli eval workflow.

Frequently Asked Questions about google-agents-cli-eval

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

FAQPage Schema
How do I evaluate my ADK agent with agents-cli?

Run agents-cli eval generate to execute your agent over a dataset and write traces, then run agents-cli eval grade to score the traces against metrics. The shortcut agents-cli eval run chains both steps using the default artifacts/traces directory.

What metrics should I use for multi-turn agent evaluation?

Use multi_turn_task_success to check goal completion, multi_turn_tool_use_quality for tool-call correctness, and multi_turn_trajectory_quality for reasoning efficiency. Add hallucination or safety when grounding or policy compliance matters.

How do I write a custom LLM-as-judge metric for agent eval?

Define an entry under custom_metrics in eval_config.yaml with a name and prompt_template referencing {prompt}, {response}, and {agent_data}. Add the metric name to metrics_to_run, then grade with agents-cli eval grade --config.

Why does multi_turn_tool_use_quality fail for google_search agents?

google_search is a model-internal grounding feature that never appears as a function_call in the trace, so the evaluator flags an unexpected tool call. Use final_response_quality instead, which evaluates the response with adaptive rubrics.

Can I evaluate cross-session memory with agents-cli eval?

No. Each eval case runs in a fresh in-memory session, so behavior depending on a separate prior session like Memory Bank recall cannot be tested. Validate cross-session continuity with pytest integration tests instead.

Why do my agent eval scores fluctuate between runs?

Score fluctuation usually comes from non-deterministic model behavior. Set temperature=0 on the agent, use rubric-based metrics with multiple judge samples, and avoid deleting flaky cases since they reveal real non-determinism.