1Smells de IA
37 smells de IA em sistemas com LLM
Code smells para IA: sinais de que o prompt, o agente ou o pipeline vai doer mais tarde. O sistema funciona, mas fica caro, frágil ou inseguro.
- itens
- 37
- Grupos
- 7
Inchaços 6
Coisas que cresceram tanto que ninguém mais entende nem consegue mexer.
- Smell
Prompt Inchado
O system prompt passou de 3 mil tokens e cada bug resolvido virou mais um parágrafo.
- Smell
Ferramentas Demais
O agente tem 40 ferramentas com nomes parecidos e escolhe a errada com frequência.
- Smell
Contexto Podre
A conversa longa carrega histórico velho que confunde o modelo e encarece cada turno.
- Smell
System Prompt Roteador
Um único prompt tenta tratar vendas, suporte e financeiro com blocos de SE o usuário pedir X.
- Smell
Acúmulo de Exemplos
O prompt tem 30 exemplos fixos e ninguém lembra por que cada um está lá.
- Smell
Mega-Agente
Um agente só faz pesquisa, escrita, revisão e publicação com o mesmo contexto e as mesmas ferramentas.
Abusos de controle 6
Fluxo de controle escondido no lugar errado: dentro do prompt ou entregue ao acaso.
- Smell
Pilha de Regras
O prompt acumula SEMPRE, NUNCA e IMPORTANTE em caixa alta, e as regras brigam entre si.
- Smell
Prompt Máquina de Estados
O prompt descreve etapas (primeiro pergunte o CPF, depois o endereço) e o modelo pula ou repete etapas.
- Smell
Loop Sem Fim
O agente pode chamar ferramentas para sempre; o único limite é o cartão de crédito.
- Smell
Agente Onde Bastava uma Chain
O caminho é sempre o mesmo, mas um agente autônomo decide a ordem a cada execução.
- Smell
Retry Cego
Qualquer erro dispara nova tentativa, inclusive erros que nunca vão passar.
- Smell
Subagentes em Cascata
Subagentes criam subagentes sem limite de profundidade nem de custo.
Impeditivos de mudança 5
Qualquer ajuste vira medo, porque ninguém sabe o que vai quebrar.
- Smell
Prompt Sem Eval
O prompt muda em produção sem nenhum conjunto de casos para provar que não piorou.
- Smell
Prompt Preso ao Modelo
Trocar de modelo ou de versão quebra tudo, porque o prompt depende de manias do modelo antigo.
- Smell
Exemplos Chumbados
Os exemplos estão dentro do código e mudar um exige deploy.
- Smell
Prompt Espalhado
Pedaços de prompt montados com concatenação em vários arquivos.
- Smell
Prompt Sem Versão
Ninguém sabe qual versão do prompt gerou a resposta que o cliente reclamou.
Dispensáveis 5
Peças que custam token, tempo e atenção sem pagar a conta.
- Smell
Autocrítica Inútil
Uma etapa de revise sua resposta que dobra o custo e quase nunca muda nada.
- Smell
Ferramentas Fantasma
Ferramentas no schema que não são chamadas há meses, mas ocupam contexto em toda requisição.
- Smell
LLM Fazendo Conta
O modelo calcula impostos, formata datas ou valida CPF, coisas que uma função faz sem errar.
- Smell
RAG Desnecessário
Um pipeline de busca vetorial para 20 páginas que cabem inteiras no contexto.
- Smell
Multi-Agente Decorativo
Cinco agentes com nomes de cargo que passam texto um para o outro sem dividir trabalho real.
Acopladores 4
Etapas grudadas por formatos frágeis, onde mudar uma quebra a outra.
- Smell
Passagem em Texto Livre
Uma etapa entrega texto solto para a próxima, que precisa adivinhar o formato.
- Smell
Rascunho Compartilhado
Vários agentes escrevem no mesmo histórico e um polui o raciocínio do outro.
- Smell
Ferramenta que Cospe HTML
A ferramenta devolve a página inteira, com menu e rodapé, e o modelo se perde.
- Smell
Vazamento de Formato do Provedor
O formato de mensagem de um provedor específico se espalhou pelo código de negócio.
Segurança 5
Brechas que transformam um texto qualquer em uma ação real.
- Smell
Efeito Sem Portão
O agente envia email, paga ou apaga dados sem nenhuma confirmação.
- Smell
Ordem Vinda do Dado
Texto de páginas, emails ou documentos entra no prompt com o mesmo peso das instruções.
- Smell
Segredo no Prompt
Chaves, senhas ou dados internos estão no prompt e podem ser repetidos para o usuário.
- Smell
Ferramenta Superpoderosa
Uma ferramenta de consulta tem permissão de escrita, ou um run_sql aceita qualquer comando.
- Smell
Saída Executada Sem Validação
Código, SQL ou comandos gerados pelo modelo rodam direto, sem checagem nem sandbox.
Operação 6
O sistema funciona na demo e sangra dinheiro ou tempo em produção.
- Smell
Custo Sem Teto
Não existe limite de gasto por usuário, por tarefa ou por dia.
- Smell
Voo Cego
Quando algo dá errado, ninguém consegue ver quais chamadas, ferramentas e contexto levaram à resposta.
- Smell
Fila Indiana de Chamadas
Cinco chamadas independentes rodam uma depois da outra e o usuário espera 20 segundos.
- Smell
Pagando Duas Vezes
O mesmo contexto grande e as mesmas perguntas são processados do zero toda vez.
- Smell
Eval no Olhômetro
A qualidade é medida testando cinco perguntas na mão antes do deploy.
- Smell
Refém de um Provedor
Quando a API do modelo cai ou fica lenta, o produto inteiro para junto.