CASO DE USO EM PRODUÇÃO

API de IA para gerar código

Exemplo: a equipe recebe uma tarefa pequena para adicionar exportação CSV a uma página de relatórios sem mudar a API pública. O modelo recebe a tarefa, convenções, arquivos afetados e comando de testes. Retorna um diff unificado e testes que comprovam o funcionamento.

Requisitos convertidos em uma alteração testada e revisável
API de IA para gerar código

Implementação para produção

API, modelo principal e configuração alternativa

Escolha para produçãoRecomendaçãoPor quê
APIPOST /v1/chat/completionsRequisição do servidor compatível com OpenAI
Modelo principalgpt-5.6-terraTerra é a base porque é preciso entender o repositório e produzir alterações úteis, sem precisar do Sol em toda tarefa.
Modelo alternativogpt-5.5Use gpt-5.5 em alterações pequenas e isoladas só após passar nos mesmos testes. Passe ao Sol se cruzar limites da arquitetura ou o Terra falhar duas vezes no mesmo teste.
Modelo para tarefas mais difíceisgpt-5.6-solUse só se a rota principal não atingir o limite de qualidade ou complexidade
Formato esperadoTexto ou alterações conforme a tarefaUm diff aplicado sem conflitos e testes para cada critério de aceitação.
01
Exemplo

Geração de código em produção

Exemplo: a equipe recebe uma tarefa pequena para adicionar exportação CSV a uma página de relatórios sem mudar a API pública. O modelo recebe a tarefa, convenções, arquivos afetados e comando de testes. Retorna um diff unificado e testes que comprovam o funcionamento.

A LLMFly AI é usada apenas para gerar. O aplicativo verifica a alteração numa cópia temporária de trabalho, executa lint e testes e retorna falhas como uma nova mensagem. A primeira resposta não é mesclada diretamente.

02
Arquitetura

Como funciona o processo de geração de código

  • Obtenha tarefa, convenções, arquivos e comando de testes.
  • Peça um diff e os testes novos ou alterados.
  • Aplique a alteração só numa cópia temporária de trabalho.
  • Execute validação determinística e retorne falhas para uma única tentativa limitada de correção.
  • Envie a alteração aprovada para revisão humana.
03
Requisição de API

Chame gpt-5.6-terra pela LLMFly AI

Envie a requisição pelo servidor. Troque o conteúdo e os esquemas de exemplo pelos dados e ferramentas do aplicativo.

request.example
curl https://app.llmfly.ai/v1/chat/completions \
  -H "Authorization: Bearer $LLMFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "system", "content": "You are editing an existing repository. Return only a unified diff. Preserve public APIs, follow the supplied conventions, and include tests for every acceptance criterion."},
      {"role": "user", "content": "Add CSV export to the report page. Files and acceptance criteria follow below."}
    ]
  }'
04
Escolha do modelo

Por que gpt-5.6-terra é o modelo principal

Terra é a base porque é preciso entender o repositório e produzir alterações úteis, sem precisar do Sol em toda tarefa.

Use gpt-5.5 em alterações pequenas e isoladas só após passar nos mesmos testes. Passe ao Sol se cruzar limites da arquitetura ou o Terra falhar duas vezes no mesmo teste.

05
Aceitação

Testes de aceitação de geração de código

MétricaCondição de aprovação
Taxa de compilação e testes aprovadosA alteração compila e todos os testes afetados passam em isolamento
Cobertura de requisitosCada critério tem um arquivo alterado ou teste correspondente
Alterações desnecessárias de arquivosSem mudanças alheias em arquivos, dependências ou interfaces públicas sem justificativa
Custo por alteração aceitaGeração, novas tentativas, testes e revisão dentro do orçamento por alteração
06
Tratamento de falhas

Falhas a tratar antes de publicar

  • Testar apenas exemplos simples
  • Aceitar código que compila mas não atende aos requisitos
  • Dar contextos diferentes a cada modelo
  • Ignorar o custo de revisão e correção
07
Saída

Saída e histórico de execução

Um diff aplicado sem conflitos e testes para cada critério de aceitação.

Registre ID do modelo e da requisição, tokens, novas tentativas, validação e decisão final em cada execução de produção.

Dúvidas frequentes

O que incluir no teste de geração de código?

Use tarefas dos seus repositórios com requisitos, comandos e critérios de revisão fixos.

O código gerado deve ser mesclado automaticamente?

Trate como uma alteração ainda não confiável. Compile e teste em isolamento e exija revisão conforme o risco.

Basta o preço por token para comparar APIs de código?

Não. Compare o custo por alteração aceita após novas tentativas, testes, revisão e correção.

Teste esta configuração com seus dados

Compare principal e alternativo com as mesmas requisições, ferramentas e regras de validação.

Comparar modelos