CASO DE USO EM PRODUÇÃO

API de IA para refatorar repositórios

Uma equipe separa a lógica de cobrança de uma aplicação monolítica, mantendo os contratos HTTP e de eventos. O Sol primeiro mapeia responsáveis, chamadas, gravações, migrações, testes e pontos de reversão. O código só é solicitado depois da aprovação desse mapa.

Mapa de dependências para planejar a refatoração de vários arquivos
API de IA para refatorar repositórios

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-solO Sol é adequado porque refatorar um repositório exige entender dependências amplas e manter decisões consistentes entre etapas.
Modelo alternativogpt-5.6-terraUse Terra em cada etapa de implementação bem delimitada após o Sol preparar o plano. Não se usa um modelo menor para alterar limites de arquitetura sem revisão.
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 mapa de impacto aprovado e um unified diff reversível por etapa.
01
Exemplo

Refatoração de repositórios em produção

Uma equipe separa a lógica de cobrança de uma aplicação monolítica, mantendo os contratos HTTP e de eventos. O Sol primeiro mapeia responsáveis, chamadas, gravações, migrações, testes e pontos de reversão. O código só é solicitado depois da aprovação desse mapa.

A implementação é dividida em várias solicitações pequenas. Cada solicitação altera um limite de dependência, gera um patch e inclui os comandos exatos para verificar compatibilidade.

02
Arquitetura

Como funciona o processo de refatoração de repositórios

  • Prepare e aprove o mapa de impacto.
  • Fixe interfaces públicas e testes do comportamento inicial.
  • Implemente um limite de dependência por solicitação.
  • Verifique compatibilidade e migrações após cada patch.
  • Pare e revise o plano se surgir uma dependência não prevista.
03
Requisição de API

Chame gpt-5.6-sol 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-sol",
    "messages": [
      {"role": "system", "content": "Plan a repository refactor before editing. Preserve the listed public contracts. First return an impact map and reversible checkpoints; do not produce code until a checkpoint is selected."},
      {"role": "user", "content": "Extract billing from the monolith while preserving the attached HTTP and event contracts."}
    ]
  }'
04
Escolha do modelo

Por que gpt-5.6-sol é o modelo principal

O Sol é adequado porque refatorar um repositório exige entender dependências amplas e manter decisões consistentes entre etapas.

Use Terra em cada etapa de implementação bem delimitada após o Sol preparar o plano. Não se usa um modelo menor para alterar limites de arquitetura sem revisão.

05
Aceitação

Testes de aceitação de refatoração de repositórios

MétricaCondição de aprovação
Preservar o comportamentoOs testes de comportamento têm resultados equivalentes antes e depois
Compatibilidade da API públicaInterfaces públicas documentadas e chamadas aceitas continuam compatíveis
Mudanças de arquivos não previstasCada arquivo alterado consta no mapa aprovado ou tem um motivo registrado
Concluir sem correção manualA refatoração chega à última etapa sem um engenheiro refazer a abordagem
06
Tratamento de falhas

Falhas a tratar antes de publicar

  • Enviar o repositório inteiro sem selecionar contexto
  • Misturar refatoração e novas funcionalidades
  • Pular testes entre etapas
  • Avaliar qualidade só pelo tamanho do diff
07
Saída

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

Um mapa de impacto aprovado e um unified diff reversível por etapa.

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

Quanto contexto do repositório devo enviar?

Envie primeiro o mapa de arquitetura e os arquivos afetados; busque dependências conforme o plano.

Como avaliar uma refatoração grande?

Revise comportamento, compatibilidade, limites, testes e mudanças não previstas em cada etapa.

Uma solicitação deve fazer toda a refatoração?

Divida o trabalho em mudanças reversíveis e valide entre etapas.

Teste esta configuração com seus dados

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

Comparar modelos