llm-evaluation
Faz seu agente testar e avaliar modelos de linguagem. Garante que as aplicações de IA funcionem bem e com qualidade.
O que ela faz
Esta ferramenta ajuda a testar e medir o quão bem um modelo de inteligência artificial (IA) está funcionando. Ela usa métodos automáticos e avaliação humana para garantir a qualidade e o desempenho das aplicações de IA.
Quando usar
- ✓Quando você quer saber se a IA está respondendo corretamente.
- ✓Para comparar qual IA ou qual instrução (prompt) funciona melhor.
- ✓Para verificar se uma mudança na IA piorou o resultado antes de colocá-la para uso.
Exemplo do que pedir para a IA
“Avalie a qualidade das respostas desta IA usando métricas como precisão e relevância.”
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
A ferramenta compara as respostas da IA com respostas esperadas ou usa humanos para dar notas. Ela calcula pontuações automáticas para diferentes aspectos da qualidade.
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 wshobson/agents --skill llm-evaluationOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-application-dev/skills/llm-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.
Avaliação de LLM
Domine estratégias abrangentes de avaliação para aplicações de LLM, desde métricas automatizadas até avaliação humana e testes A/B.
Quando Usar Esta Habilidade
- Medir o desempenho de aplicações de LLM de forma sistemática
- Comparar diferentes modelos ou prompts
- Detectar regressões de desempenho antes da implantação
- Validar melhorias de mudanças de prompt
- Construir confiança em sistemas de produção
- Estabelecer linhas de base e acompanhar o progresso ao longo do tempo
- Depurar comportamento inesperado do modelo
Tipos Principais de Avaliação
1. Métricas Automatizadas
Avaliação rápida, repetível e escalável usando pontuações computadas.
Geração de Texto:
- BLEU: Sobreposição de n-gramas (tradução)
- ROUGE: Orientado a recall (resumo)
- METEOR: Similaridade semântica
- BERTScore: Similaridade baseada em embeddings
- Perplexidade: Confiança do modelo de linguagem
Classificação:
- Acurácia: Porcentagem de acertos
- Precisão/Recall/F1: Desempenho específico da classe
- Matriz de Confusão: Padrões de erro
- AUC-ROC: Qualidade do ranking
Recuperação (RAG):
- MRR: Mean Reciprocal Rank (Rank Recíproco Médio)
- NDCG: Normalized Discounted Cumulative Gain (Ganho Cumulativo Descontado Normalizado)
- Precision@K: Relevante nos top K
- Recall@K: Cobertura nos top K
2. Avaliação Humana
Avaliação manual para aspectos de qualidade difíceis de automatizar.
Dimensões:
- Acurácia: Correção factual
- Coerência: Fluxo lógico
- Relevância: Responde à pergunta
- Fluidez: Qualidade da linguagem natural
- Segurança: Sem conteúdo prejudicial
- Utilidade: Útil para o usuário
3. LLM como Juiz
Use LLMs mais fortes para avaliar saídas de modelos mais fracos.
Abordagens:
- Ponto a Ponto: Pontuar respostas individuais
- Par a Par: Comparar duas respostas
- Baseado em Referência: Comparar com o padrão ouro
- Livre de Referência: Julgar sem verdade fundamental
Início Rápido
from dataclasses import dataclass
from typing import Callable
import numpy as np
@dataclass
class Metric:
name: str
fn: Callable
@staticmethod
def accuracy():
return Metric("accuracy", calculate_accuracy)
@staticmethod
def bleu():
return Metric("bleu", calculate_bleu)
@staticmethod
def bertscore():
return Metric("bertscore", calculate_bertscore)
@staticmethod
def custom(name: str, fn: Callable):
return Metric(name, fn)
class EvaluationSuite:
def __init__(self, metrics: list[Metric]):
self.metrics = metrics
async def evaluate(self, model, test_cases: list[dict]) -> dict:
results = {m.name: [] for m in self.metrics}
for test in test_cases:
prediction = await model.predict(test["input"])
for metric in self.metrics:
score = metric.fn(
prediction=prediction,
reference=test.get("expected"),
context=test.get("context")
)
results[metric.name].append(score)
return {
"metrics": {k: np.mean(v) for k, v in results.items()},
"raw_scores": results
}
# Usage
suite = EvaluationSuite([
Metric.accuracy(),
Metric.bleu(),
Metric.bertscore(),
Metric.custom("groundedness", check_groundedness)
])
test_cases = [
{
"input": "What is the capital of France?",
"expected": "Paris",
"context": "France is a country in Europe. Paris is its capital."
},
]
results = await suite.evaluate(model=your_model, test_cases=test_cases)
Padrões detalhados e exemplos práticos
A documentação detalhada dos padrões está em references/details.md. Leia este arquivo quando o nível de navegação acima for insuficiente.
Perguntas frequentes
O que são métricas automáticas?
São cálculos que medem a qualidade das respostas da IA, como a semelhança com um texto de referência (BLEU, ROUGE) ou a correção (Acurácia).
O que é avaliação humana?
É quando pessoas leem e avaliam as respostas da IA, verificando se são corretas, coerentes, úteis e seguras.
O que é LLM-as-Judge?
É usar uma IA mais avançada para avaliar as respostas de outra IA, comparando ou dando notas.
Detalhes
Descrição original do autor
Implement comprehensive evaluation strategies for LLM applications using automated metrics, human feedback, and benchmarking. Use when testing LLM performance, measuring AI application quality, or establishing evaluation frameworks.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4890
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
screen-reader-testing
Faz seu agente testar sites usando leitores de tela para garantir que sejam acessíveis.
wshobson/agents
wcag-audit-patterns
Ajuda seu agente a auditar sites para acessibilidade e corrigir problemas de acordo com as diretrizes WCAG.
wshobson/agents
multi-reviewer-patterns
Faz seu agente coordenar revisões de código paralelas, deduplicando achados e consolidando relatórios.
wshobson/agents
parallel-debugging
Permite ao agente depurar problemas complexos com investigações paralelas e análise de causa raiz.
wshobson/agents
Skills parecidas
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC