Versão 1
100/100 · 46 tokensSummarize the incident report below for the on-call engineering team in 5 bullet points. Include the root cause, the customer impact, and the fix. Return a markdown list.
<report>
{{report}}
</report>Testes de prompts
Trate prompts como arquivos de código-fonte. Um único comando confere cada prompt de um repositório com um padrão de qualidade, um orçamento de tokens e um limite de gravidade, e faz o build falhar quando algum estiver quebrado.
Um prompt que funcionava no mês passado pode quebrar com uma edição bem-intencionada: um parágrafo duplicado, um formato de saída removido, uma chave colada. Os testes de prompts pegam isso na revisão, e não em produção.
O comando promptflow check lê os arquivos de prompts que você indicar e falha quando um arquivo pontua abaixo do seu mínimo, usa mais tokens que o seu máximo ou tem um achado igual ou acima da gravidade escolhida. O limite padrão é critical, então uma credencial vazada sempre falha. As configurações ficam em um arquivo .promptflowrc.json na raiz do repositório.
São testes estáticos. Eles examinam o texto do prompt e nunca chamam um modelo, por isso são rápidos, gratuitos e idênticos em toda execução. Eles não substituem testes de saída com um modelo; ficam antes deles e eliminam as falhas que não precisam de um modelo para serem encontradas. Testes baseados em modelos estão no roadmap e não estão disponíveis hoje.
Exemplo prático
Duas versões do mesmo prompt, comparadas pelo motor quando esta página foi construída. A edição parecia inofensiva e removeu o formato de saída. Os resultados do motor e os prompts gerados aparecem em inglês, exatamente como o motor e a API os retornam.
Summarize the incident report below for the on-call engineering team in 5 bullet points. Include the root cause, the customer impact, and the fix. Return a markdown list.
<report>
{{report}}
</report>Summarize the incident report below for the on-call engineering team. Include the root cause, the customer impact, the fix, and some other details if relevant.
{{report}}Calculado pelo motor quando esta página foi construída. Com a configuração abaixo, a versão 2 passa na verificação com pontuação mínima de 70.
{
"include": ["prompts/**/*.md"],
"model": "gpt-4.1",
"minScore": 70,
"maxTokens": 2000,
"failOn": "critical"
}promptflow check
promptflow compare prompts/summary.v1.md prompts/summary.v2.mdO mesmo arquivo sempre gera o mesmo resultado, então um build vermelho significa que o prompt mudou.
Nada é enviado a um provedor, então não há segredos para gerenciar nem nada a pagar por execução.
Um repositório de arquivos de prompts é verificado em segundos.
Cada falha indica o arquivo, a regra e a correção, com link para a referência da regra.
A verificação: pontuação mínima, máximo de tokens e gravidade de falha sobre um conjunto de globs.
Código de saída 1 diante de qualquer achado crítico, para um simples passa ou falha.
Diferença de tokens, qualidade e achados entre duas versões de um prompt.
Execução só de segurança, que falha diante de um achado de segurança crítico.
Todos os comandos aceitam --json para uso em scripts e dashboards.
Globs de inclusão, modelo, limites e regras ignoradas em .promptflowrc.json.
Rode check em um job do GitHub Actions para que uma mudança de prompt abaixo do padrão não possa ser mesclada.
Defina maxTokens para manter os prompts de sistema dentro da margem planejada.
Deixe fail-on em critical para que uma chave ou senha commitada falhe na hora.
Rode validate nos arquivos de prompts preparados para ter retorno antes do push.
Não. As verificações são estáticas: analisam o texto do prompt com regras determinísticas. Executar prompts em um modelo e pontuar a saída está no roadmap e não está disponível hoje.
Ainda não. Até o pacote ser publicado, compile a CLI a partir de uma cópia do repositório. A documentação da CLI traz os comandos.
Qualquer arquivo de texto. Aponte os globs de inclusão para os arquivos que guardam seus prompts, como arquivos Markdown ou .prompt.txt.
Sim. Liste os códigos das regras em ignore no .promptflowrc.json para ignorá-las em todo o repositório.
Todos os produtos rodam o mesmo motor, então se combinam sem surpresas.
Guias da central de conhecimento de engenharia de prompts que explicam as ideias que este produto aplica.
Gratuito, determinístico e privado. Sem cadastro.