Pular para o conteúdo
Skillpedia
Agentes41 mil · #4890

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

https://github.com/wshobson/agents/blob/main/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/wshobson/agents/blob/main/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-evaluation

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-application-dev/skills/llm-evaluation/SKILL.md -o SKILL.md
Conteú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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas