google/adk-eval-guide

Guia essencial sobre a metodologia de avaliação do ADK — métricas, esquema de evalset, LLM-como-juiz, pontuação de trajetória de ferramentas e causas comuns de falha. Leia antes de executar qualquer avaliação ADK.

O que é adk-eval-guide?

Este guia (google/adk-eval-guide) é um recurso obrigatório para desenvolvedores que utilizam o Google Agent Development Kit (ADK) e precisam avaliar a qualidade de seus agentes. Ele descreve a metodologia completa de avaliação do ADK, incluindo métricas de avaliação, o esquema do conjunto de avaliação (evalset), o uso de um LLM como juiz (LLM-as-judge), a pontuação de trajetória de ferramentas (tool trajectory scoring), e as causas comuns de falha. Você deve consultar este guia antes de executar `adk eval`, ao depurar resultados de avaliação, ou sempre que precisar entender por que seu agente está se comportando de forma inesperada. Ele não deve ser usado para padrões de código de API (use o adk-cheatsheet), implantação (use o adk-deploy-guide) ou scaffolding de projetos (use o adk-scaffold). O guia foi projetado para funcionar em todas as plataformas compatíveis com o ADK.

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

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que adk-eval-guide faz?

LEIA OBRIGATORIAMENTE antes de executar qualquer avaliação ADK. Metodologia de avaliação ADK — métricas de avaliação, esquema de evalset, LLM-como-juiz, pontuação de trajetória de ferramentas e causas comuns de falha. Use ao avaliar a qualidade do agente, executando adk eval ou depurando resultados de avaliação. NÃO use para padrões de código de API (use adk-cheatsheet), implantação (use adk-deploy-guide) ou scaffolding de projetos (use 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").

Habilidades Relacionadas