evaluation
Faz seu agente criar sistemas para testar seu próprio desempenho. Ele ajuda a validar escolhas de configuração e medir melhorias ao longo do tempo.
O que ela faz
Esta ferramenta ajuda a criar um sistema para testar o desempenho de "agentes" de IA. Ela permite verificar se as instruções dadas aos agentes estão funcionando bem e se eles estão melhorando com o tempo.
Quando usar
- ✓Quando você quer testar o quão bem um agente de IA está funcionando.
- ✓Para verificar se as instruções que você deu ao agente estão corretas.
- ✓Para ver se o agente está ficando melhor depois de algumas mudanças.
Exemplo do que pedir para a IA
“Crie um teste para ver se o agente consegue encontrar informações sobre o clima em São Paulo.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ela funciona definindo o que é um bom resultado e como medir se o agente o alcançou. Isso pode envolver verificar a precisão das informações, a eficiência do uso de ferramentas e a qualidade geral da resposta.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill evaluationOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/evaluation/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Quando Usar Esta Habilidade
Construir frameworks de avaliação para sistemas de agentes
Use esta habilidade ao trabalhar com frameworks de avaliação para sistemas de agentes.
Métodos de Avaliação para Sistemas de Agentes
A avaliação de sistemas de agentes requer abordagens diferentes do software tradicional ou mesmo de aplicações de modelos de linguagem padrão. Agentes tomam decisões dinâmicas, são não determinísticos entre execuções e frequentemente não possuem respostas únicas e corretas. Uma avaliação eficaz deve considerar essas características enquanto fornece feedback acionável. Um framework de avaliação robusto permite a melhoria contínua, detecta regressões e valida que as escolhas de engenharia de contexto atingem os efeitos pretendidos.
Quando Usar
Ative esta habilidade quando:
- Testar o desempenho do agente sistematicamente
- Validar escolhas de engenharia de contexto
- Medir melhorias ao longo do tempo
- Detectar regressões antes da implantação
- Construir portões de qualidade para pipelines de agentes
- Comparar diferentes configurações de agentes
- Avaliar sistemas de produção continuamente
Conceitos Principais
A avaliação de agentes requer abordagens focadas em resultados que considerem a não determinismo e múltiplos caminhos válidos. Rubricas multidimensionais capturam vários aspectos de qualidade: precisão factual, completude, precisão de citação, qualidade da fonte e eficiência de ferramentas. LLM-como-juiz fornece avaliação escalável enquanto a avaliação humana captura casos extremos.
A percepção chave é que os agentes podem encontrar caminhos alternativos para atingir objetivos — a avaliação deve julgar se eles atingem os resultados corretos enquanto seguem processos razoáveis.
Drivers de Desempenho: A Descoberta dos 95% Pesquisas sobre a avaliação BrowseComp (que testa a capacidade de agentes de navegação em localizar informações difíceis de encontrar) descobriram que três fatores explicam 95% da variância de desempenho:
| Fator | Variância Explicada | Implicação |
|---|---|---|
| Uso de tokens | 80% | Mais tokens = melhor desempenho |
| Número de chamadas de ferramentas | ~10% | Mais exploração ajuda |
| Escolha do modelo | ~5% | Melhores modelos multiplicam a eficiência |
Essa descoberta tem implicações significativas para o design da avaliação:
- Orçamentos de tokens importam: Avalie agentes com orçamentos de tokens realistas, não recursos ilimitados
- Upgrades de modelo superam aumentos de tokens: Atualizar para Claude Sonnet 4.5 ou GPT-5.2 oferece ganhos maiores do que dobrar os orçamentos de tokens em versões anteriores
- Validação multiagente: A descoberta valida arquiteturas que distribuem o trabalho entre agentes com janelas de contexto separadas
Tópicos Detalhados
Desafios de Avaliação
Não Determinismo e Múltiplos Caminhos Válidos Agentes podem seguir caminhos válidos completamente diferentes para atingir objetivos. Um agente pode pesquisar três fontes enquanto outro pesquisa dez. Eles podem usar ferramentas diferentes para encontrar a mesma resposta. Avaliações tradicionais que verificam passos específicos falham nesse contexto.
A solução é uma avaliação focada em resultados que julga se os agentes atingem os resultados corretos enquanto seguem processos razoáveis.
Falhas Dependentes de Contexto Falhas de agentes frequentemente dependem do contexto de maneiras sutis. Um agente pode ter sucesso em consultas simples, mas falhar em consultas complexas. Ele pode funcionar bem com um conjunto de ferramentas, mas falhar com outro. Falhas podem surgir apenas após interações estendidas quando o contexto se acumula.
A avaliação deve cobrir uma variedade de níveis de complexidade e testar interações estendidas, não apenas consultas isoladas.
Dimensões de Qualidade Compostas A qualidade do agente não é uma dimensão única. Inclui precisão factual, completude, coerência, eficiência de ferramentas e qualidade do processo. Um agente pode ter uma pontuação alta em precisão, mas baixa em eficiência, ou vice-versa.
Rubricas de avaliação devem capturar múltiplas dimensões com ponderação apropriada para o caso de uso.
Design de Rubrica de Avaliação
Rubrica Multidimensional Rubricas eficazes cobrem dimensões chave com níveis descritivos:
Precisão factual: Declarações correspondem à verdade (excelente a falhou)
Completude: Saída cobre os aspectos solicitados (excelente a falhou)
Precisão da citação: Citações correspondem às fontes declaradas (excelente a falhou)
Qualidade da fonte: Usa fontes primárias apropriadas (excelente a falhou)
Eficiência de ferramentas: Usa as ferramentas corretas em um número razoável de vezes (excelente a falhou)
Pontuação da Rubrica Converta avaliações de dimensão em pontuações numéricas (0.0 a 1.0) com ponderação apropriada. Calcule pontuações gerais ponderadas. Determine o limiar de aprovação com base nos requisitos do caso de uso.
Metodologias de Avaliação
LLM-como-Juiz
…
Perguntas frequentes
Por que os agentes de IA são diferentes de programas normais para testar?
Agentes de IA tomam decisões que podem mudar a cada vez que são executados e nem sempre há uma única resposta certa. Testes precisam considerar isso.
O que é 'LLM-as-judge'?
É usar um modelo de linguagem grande (como o próprio Claude) para avaliar as respostas do agente, tornando o teste mais rápido e em maior escala.
O que são 'dimensões de qualidade'?
São diferentes aspectos que medem a qualidade de uma resposta, como se a informação está correta (precisão), se está completa, se as fontes são boas e se as ferramentas foram usadas de forma eficiente.
Detalhes
Descrição original do autor
Build evaluation frameworks for agent systems. Use when testing agent performance systematically, validating context engineering choices, or measuring improvements over time.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2940
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
dashboard-builder
Ajuda seu agente a criar painéis de monitoramento úteis. Ele transforma dados em gráficos que respondem a perguntas importantes sobre o sistema.
affaan-m/ECC
dev-team
Simula uma equipe de desenvolvimento colaborativa, onde diferentes papéis respondem a um problema juntos. É útil para obter múltiplas perspectivas sem trocar de agente manualmente.
affaan-m/ECC
ecc-council
Faz seu agente reunir um conselho de quatro vozes para tomar decisões difíceis. É útil quando há várias opções boas e é preciso debater antes de escolher.
affaan-m/ECC