llm-evaluation
Ajuda seu agente a avaliar o desempenho de aplicações de IA. Ele usa testes automáticos e humanos para garantir que a IA funcione bem.
O que ela faz
Esta ferramenta ajuda a verificar se um modelo de linguagem (IA) está funcionando bem. Ela usa métodos automáticos e humanos para medir a qualidade das respostas da IA.
Quando usar
- ✓Quando você quer saber se a IA está respondendo corretamente.
- ✓Para comparar qual IA ou qual forma de perguntar funciona melhor.
- ✓Para ter certeza de que a IA não piorou depois de uma atualização.
Exemplo do que pedir para a IA
“Como posso verificar se a resposta da IA sobre a capital da França está correta?”
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 a resposta da IA com a resposta esperada usando métricas como precisão ou semelhança de texto. Também permite que pessoas avaliem a qualidade das respostas em quesitos como clareza e utilidade.
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 llm-evaluationOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/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 LLMs
Domine estratégias abrangentes de avaliação para aplicações de LLM, desde métricas automatizadas até avaliação humana e testes A/B.
Não use esta habilidade quando
- A tarefa não estiver relacionada à avaliação de LLM
- Você precisar de um domínio ou ferramenta diferente fora deste escopo
Instruções
- Clarifique objetivos, restrições e entradas necessárias.
- Aplique as melhores práticas relevantes e valide os resultados.
- Forneça etapas acionáveis e verificação.
- Use os exemplos abaixo; nenhum manual de implementação separado está incluído.
Use esta habilidade quando
- Medir o desempenho de aplicações de LLM sistematicamente
- Comparar diferentes modelos ou prompts
- Detectar regressões de desempenho antes da implantação
- Validar melhorias de alterações de prompt
- Construir confiança em sistemas de produção
- Estabelecer linhas de base e rastrear 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 Médio Recíproco)
- 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
- Fluência: 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:
- Pontual: Pontua respostas individuais
- Pareado: Compara duas respostas
- Baseado em Referência: Compara com o padrão ouro
- Livre de Referência: Julga sem verdade fundamental
Início Rápido
from llm_eval import EvaluationSuite, Metric
# Define evaluation suite
suite = EvaluationSuite([
Metric.accuracy(),
Metric.bleu(),
Metric.bertscore(),
Metric.custom(name="groundedness", fn=check_groundedness)
])
# Prepare test cases
test_cases = [
{
"input": "What is the capital of France?",
"expected": "Paris",
"context": "France is a country in Europe. Paris is its capital."
},
# ... more test cases
]
# Run evaluation
results = suite.evaluate(
model=your_model,
test_cases=test_cases
)
print(f"Overall Accuracy: {results.metrics['accuracy']}")
print(f"BLEU Score: {results.metrics['bleu']}")
Implementação de Métricas Automatizadas
Pontuação BLEU
from nltk.translate.bleu_score import sentence_bleu, SmoothingFunction
def calculate_bleu(reference, hypothesis):
"""Calculate BLEU score between reference and hypothesis."""
smoothie = SmoothingFunction().method4
return sentence_bleu(
[reference.split()],
hypothesis.split(),
smoothing_function=smoothie
)
# Usage
bleu = calculate_bleu(
reference="The cat sat on the mat",
hypothesis="A cat is sitting on the mat"
)
Pontuação ROUGE
from rouge_score import rouge_scorer
def calculate_rouge(reference, hypothesis):
"""Calculate ROUGE scores."""
scorer = rouge_scorer.RougeScorer(['rouge1', 'rouge2', 'rougeL'], use_stemmer=True)
scores = scorer.score(reference, hypothesis)
return {
'rouge1': scores['rouge1'].fmeasure,
'rouge2': scores['rouge2'].fmeasure,
'rougeL': scores['rougeL'].fmeasure
}
BERTScore
from bert_score import score
def calculate_bertscore(references, hypotheses):
"""Calculate BERTScore using pre-trained BERT."""
P, R, F1 = score(
hypotheses,
references,
lang='en',
model_type='microsoft/deberta-xlarge-mnli'
)
return {
'precision': P.mean().item(),
'recall': R.mean().item(),
'f1': F1.mean().item()
}
Métricas Personalizadas
def calculate_groundedness(response, context):
"""Verifica se a resposta está fundamentada no contexto fornecido."""
# Usa modelo NLI para verificar a implicação
from transformers import pipeline
…
Perguntas frequentes
O que são métricas automáticas?
São cálculos que a própria ferramenta faz para medir a qualidade, como a porcentagem de acertos ou o quão parecida a resposta da IA é com uma resposta ideal.
O que é avaliação humana?
É quando pessoas leem as respostas da IA e dão notas para aspectos como se a resposta faz sentido, se está correta ou se é fácil de entender.
O que é LLM-as-Judge?
É usar uma IA mais avançada para avaliar as respostas de outra IA, como se fosse um juiz.
Detalhes
Descrição original do autor
Master comprehensive evaluation strategies for LLM applications, from automated metrics to human evaluation and A/B testing.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #3470
- 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
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