CASO DE USO EM PRODUÇÃO
Exemplo: uma pull request altera o middleware de autenticação. O serviço envia diff, funções próximas, regras de segurança e mapa das linhas alteradas a codex-auto-review. O modelo só deve retornar problemas com um caminho concreto de falha.
Implementação para produção
| Escolha para produção | Recomendação | Por quê |
|---|---|---|
| API | POST /v1/chat/completions | Requisição do servidor compatível com OpenAI |
| Modelo principal | codex-auto-review | codex-auto-review é a primeira rota específica de revisão automática disponível no catálogo atual. |
| Modelo alternativo | gpt-5.6-terra | Use Terra quando precisar de mais raciocínio sobre o repositório. Escale ao Sol um problema grave em discussão, não toda PR comum. |
| Modelo para tarefas mais difíceis | gpt-5.6-sol | Use só se a rota principal não atingir o limite de qualidade ou complexidade |
| Formato esperado | JSON validado | Problemas em JSON: arquivo, linha, gravidade, título, evidências, caminho de falha e correção sugerida. |
Exemplo: uma pull request altera o middleware de autenticação. O serviço envia diff, funções próximas, regras de segurança e mapa das linhas alteradas a codex-auto-review. O modelo só deve retornar problemas com um caminho concreto de falha.
O serviço rejeita comentários sem arquivo, linha alterada, gravidade, evidências e solução. Os testes incluem PRs sem erros; mais comentários não significam uma revisão melhor.
Envie a requisição pelo servidor. Troque o conteúdo e os esquemas de exemplo pelos dados e ferramentas do aplicativo.
curl https://app.llmfly.ai/v1/chat/completions \
-H "Authorization: Bearer $LLMFLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "codex-auto-review",
"messages": [
{"role": "system", "content": "Review the supplied diff. Report only actionable defects introduced by this change. Each finding needs file, changed line, severity, failure path, evidence, and a minimal fix."},
{"role": "user", "content": "Review this authentication middleware pull request against the attached repository rules."}
],
"response_format": {"type": "json_object"}
}'codex-auto-review é a primeira rota específica de revisão automática disponível no catálogo atual.
Use Terra quando precisar de mais raciocínio sobre o repositório. Escale ao Sol um problema grave em discussão, não toda PR comum.
| Métrica | Condição de aprovação |
|---|---|
| Detecção de erros reais | Detecta falhas graves introduzidas nos testes |
| Taxa de falsos positivos | Alterações corretas não recebem bloqueios nem problemas inventados |
| Evidências por linha | Cada problema aponta a menor faixa relevante e explica a falha |
| Aceitação por revisores | Revisores qualificados consideram o comentário correto, útil e digno de exibição |
Problemas em JSON: arquivo, linha, gravidade, título, evidências, caminho de falha e correção sugerida.
Registre ID do modelo e da requisição, tokens, novas tentativas, validação e decisão final em cada execução de produção.
Inclua alterações corretas e conte problemas que um revisor rejeite por erro ou falta de ação útil.
Nem sempre. Comece pelo diff e arquivos relevantes; acrescente contexto quando precisar.
Use um esquema com arquivo, linha, gravidade, explicação, evidências e solução sugerida.
Compare principal e alternativo com as mesmas requisições, ferramentas e regras de validação.