Community생산성 & 협업github.com

google/adk-eval-guide

ADK 평가를 실행하기 전에 반드시 읽어야 할 가이드. 에이전트 품질 평가, adk eval 실행, 평가 결과 디버깅 시 사용하세요.

adk-eval-guide란 무엇인가요?

이 스킬은 ADK(Agent Development Kit) 평가 방법론에 대한 필수 가이드입니다. 평가 메트릭(정확도, F1, 정밀도, 재현율 등), evalset 스키마 정의, LLM-as-judge를 활용한 자동 평가, 도구 궤적(trajectory) 점수 계산 방식, 그리고 일반적인 실패 원인들을 상세히 설명합니다. 특히 LLM-as-judge 설정 시 주의할 점(예: 프롬프트 편향, 평가 기준 과잉)과 올바른 참조 데이터 구성법을 중점적으로 다룹니다. 이 가이드는 adk eval 명령어로 에이전트 품질을 측정하거나, 평가 결과에서 이상 징후를 발견했을 때 디버깅 목적으로 사용해야 합니다. API 코드 패턴, 배포, 프로젝트 스캐폴딩 등 다른 작업에는 적합하지 않으므로 각각 adk-cheatsheet, adk-deploy-guide, adk-scaffold를 참조하세요.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/google/adk-docs/tree/main/skills/adk-eval-guide

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

adk-eval-guide은(는) 무엇을 하나요?

ADK 평가를 실행하기 전에 꼭 읽어야 합니다. ADK 평가 방법론 — 평가 지표, 평가 세트 스키마, LLM-as-judge, 도구 궤적 점수 매기기, 일반적인 실패 원인. 에이전트 품질 평가, adk eval 실행, 또는 평가 결과 디버깅 시 사용하세요. API 코드 패턴(adk-cheatsheet 사용), 배포(adk-deploy-guide 사용), 또는 프로젝트 스캐폴딩(adk-scaffold 사용)에는 사용하지 마세요.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

google/adk-cheatsheet

MUST READ before writing or modifying ADK agent code. ADK API quick reference for Python — agent types, tool definitions, orchestration patterns, callbacks, and state management. Includes an index of all ADK documentation pages. Do NOT use for creating new projects (use adk-scaffold).

google/adk-deploy-guide

MUST READ before deploying any ADK agent. ADK deployment guide — Agent Engine, Cloud Run, GKE, CI/CD pipelines, secrets, observability, and production workflows. Use when deploying agents to Google Cloud or troubleshooting deployments. Do NOT use for API code patterns (use adk-cheatsheet), evaluation (use adk-eval-guide), or project scaffolding (use adk-scaffold).

google/adk-dev-guide

ALWAYS ACTIVE — read at the start of any ADK agent development session. ADK development lifecycle and mandatory coding guidelines — spec-driven workflow, code preservation rules, model selection, and troubleshooting.

google/adk-observability-guide

MUST READ before setting up observability for ADK agents or when analyzing production traffic, debugging agent behavior, or improving agent performance. ADK observability guide — Cloud Trace, prompt-response logging, BigQuery Agent Analytics, third-party integrations, and troubleshooting. Use when configuring monitoring, tracing, or logging for agents, or when understanding how a deployed agent handles real traffic.

google/adk-scaffold

MUST READ before creating or enhancing any ADK agent project. Use when the user wants to build a new agent (e.g. "build me a search agent") or enhance an existing project (e.g. "add CI/CD to my project", "add RAG").

관련 스킬