adk-eval-guide

Evaluate ADK-based agents using metrics, evalsets, and LLM-as-judge.

9|1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/hq-opensource/si-mapper --skill adk-eval-guide-hq-opensource
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adk-eval-guide
Source: https://github.com/hq-opensource/si-mapper/tree/main/.agents/skills/adk-eval-guide
Command: npx skills add https://github.com/hq-opensource/si-mapper --skill adk-eval-guide-hq-opensource

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This guide provides a structured methodology for evaluating ADK-based agents, detailing evaluation metrics, evalset schemas, and the use of LLM-as-judge to assess performance.

Core Features & Use Cases

  • Comprehensive ADK evaluation framework covering criteria, eval_config, and evalsets.
  • Step-by-step running instructions for scaffolded and non-scaffolded setups, plus recommended debugging workflows.
  • Clear guidance on selecting appropriate metrics (tool trajectory, final response quality, safety) and how to interpret results in real projects.

Quick Start

Consult this guide before running any ADK evaluation and follow the steps to set up your first evaluation.

Frequently Asked Questions about adk-eval-guide

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

FAQPage Schema
How do I evaluate ADK-based agents using LLM-as-judge?

Evaluate ADK-based agents using LLM-as-judge by configuring structured evaluation metrics, defining evalset schemas, and running the evaluation to assess tool trajectories and final response quality. The guide details this complete methodology.

What metrics should I use for ADK agent evaluations?

ADK agent evaluations use metrics covering tool trajectory accuracy, final response quality, and safety. Selecting appropriate metrics depends on your specific evaluation criteria and the agent's intended task scope.

How do I set up scaffolded and non-scaffolded ADK evaluations?

Set up scaffolded and non-scaffolded ADK evaluations by following step-by-step running instructions that configure the eval_config and evalsets. Both setups support running evaluations and debugging workflows.

Why is my ADK agent evaluation failing or returning low scores?

ADK agent evaluations fail or return low scores due to issues in tool trajectories or final responses. Diagnose these common failures by interpreting the LLM-as-judge scores and following the recommended debugging workflows.

Do I need a specific evalset schema to run ADK evaluations?

Yes, running ADK evaluations requires a structured evalset schema to define test cases and expected outcomes. The guide provides schemas and criteria for configuring your eval_config properly.

Can I tune evaluation criteria for my custom ADK agent?

Yes, you can tune evaluation criteria for custom ADK agents. The guide includes references for running evaluations, tuning criteria to fit specific use cases, and debugging results.