For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Primeiros passos com o Promptfoo

Execute sua primeira avaliação pela CLI ou com o Codex.

Use o Promptfoo, uma biblioteca de código aberto, para avaliar aplicativos e agentes de IA e realizar testes de red teaming. Defina casos de teste e verificações para medir o comportamento do aplicativo, comparar prompts ou modelos e investigar falhas. Você também pode testar aplicativos com entradas adversariais para identificar riscos de segurança.

O Promptfoo faz parte da OpenAI.

Comece com uma avaliação simples. Execute um exemplo de tradução no terminal ou peça ao Codex que configure uma avaliação para o seu aplicativo.

Comece pela CLI

Com o Node.js 22.22.0 ou superior instalado, escolha como executar o exemplo do Promptfoo. Ele usa casos de teste para comparar as traduções de diferentes modelos.

Método de instalação
npx promptfoo@latest init --example getting-started
cd getting-started

O exemplo cria o arquivo promptfooconfig.yaml com um prompt de tradução, provedores de modelos e casos de teste. Cada teste inclui uma asserção que verifica se a saída contém uma frase esperada. Configure sua chave da API da OpenAI no terminal, substituindo o valor de exemplo pela sua chave.

export OPENAI_API_KEY="<your-api-key>"

Execute a avaliação e abra o visualizador de resultados. As chamadas aos modelos feitas durante a avaliação geram cobranças pelo uso da API.

Método de execução
npx promptfoo@latest eval
npx promptfoo@latest view

Abra a URL local para comparar as saídas dos modelos e ver quais asserções passaram ou falharam. Examine também as saídas. Quando uma asserção passa, ela confirma apenas que uma condição específica foi atendida. A qualidade geral da resposta precisa ser avaliada separadamente. Edite o prompt ou os casos de teste em promptfooconfig.yaml e execute a avaliação novamente.

Resultados do Promptfoo que comparam o GPT-6.1 Sol com esforço de raciocínio médio e o GPT-6 Luna com esforço de raciocínio alto em 12 tarefas de programação, com verificações de correção e latência.

Uma avaliação separada do App Server do Codex compara gpt-6.1-sol (esforço de raciocínio médio) e gpt-6-luna (esforço de raciocínio alto) em 12 tarefas de programação. Cada resultado leva em conta os testes executáveis que verificam se o código funciona corretamente e o limite de 30 segundos. Todas as implementações passaram nos testes de código. Os resultados em vermelho indicam que o limite de tempo foi excedido.

Comece pelo Codex App

Use o plugin do Promptfoo para adicionar ao Codex habilidades para configurar e executar avaliações.

Selecione Abrir no Codex para iniciar uma tarefa ou Copiar prompt para colar o prompt em uma tarefa existente.

Prompt inicial
Use o Promptfoo para avaliar e melhorar um fluxo de trabalho importante que usa IA neste aplicativo. Leia as instruções do repositório e reaproveite a configuração de avaliação existente, se houver. Escolha para o teste um comportamento que o usuário possa observar no aplicativo. Se o objetivo não estiver claro, peça que eu o esclareça. Crie casos de teste com base nas entradas do aplicativo, incluindo solicitações comuns, casos extremos e entradas adversariais. Defina critérios de sucesso com asserções que verifiquem o comportamento esperado. Execute uma avaliação inicial, examine as falhas e teste uma alteração pontual no prompt ou na configuração. Compare as duas versões usando os mesmos casos de teste e as mesmas asserções. Relate as melhorias e regressões e inclua dados de latência e custo quando estiverem disponíveis. Mantenha as asserções inalteradas para que a comparação continue válida. Abra os resultados com os gráficos. Mostre alguns exemplos concretos do antes e do depois e recomende qual versão manter. Se a alteração não melhorar os resultados, informe isso.

O Codex pode precisar da sua ajuda com as credenciais ou com as permissões necessárias para a configuração. Avaliações que fazem chamadas a um modelo podem gerar cobranças pelo uso da API.

Próximos passos

Continue explorando a documentação do Promptfoo.