22 min de leitura

Engenharia de IA: guia completo para construir sistemas de inteligência artificial em produção

Entenda engenharia de IA, RAG, agentes, MCP, avaliações, segurança, observabilidade e o caminho completo do protótipo à produção.

Engenharia de IA: guia completo para construir sistemas de inteligência artificial em produção

Um modelo de linguagem consegue escrever, resumir, classificar, extrair dados e sugerir decisões. Isso ainda não forma um sistema de IA pronto para trabalhar dentro de uma empresa.

Entre a demonstração e a produção existem dados, permissões, integrações, custos, falhas, avaliações, logs e pessoas que precisam entender o resultado. Engenharia de IA é o trabalho de unir essas partes sem deixar o modelo virar uma caixa-preta com acesso demais e critérios de menos.

Este guia explica a arquitetura completa: quando uma chamada simples resolve, quando usar RAG, onde entram agentes e MCP, como avaliar qualidade, como limitar riscos e o que precisa existir para operar a aplicação depois do lançamento.

Resposta curta: o que é engenharia de IA?

Engenharia de IA é a disciplina de projetar, construir, avaliar e operar sistemas que usam modelos de inteligência artificial para produzir resultados úteis dentro de limites conhecidos.

O modelo é um componente. O sistema inclui também:

Uma aplicação pode usar o modelo mais capaz do mercado e continuar ruim se busca documentos errados, entrega dados sem permissão, chama uma ferramenta com parâmetros ambíguos ou não sabe reconhecer quando deveria pedir ajuda.

A engenharia começa quando a equipe deixa de perguntar apenas “qual modelo vamos usar?” e passa a definir “qual resultado precisamos produzir, como provaremos que funcionou e o que acontece quando não funcionar?”.

Uma analogia para entender um sistema de IA

O material de referência enviado para este artigo compara um sistema de IA ao corpo humano. A analogia é útil desde que cada elemento seja tratado com precisão.

Camadas de um sistema de engenharia de IA, do objetivo de negócio ao modelo, conhecimento, ferramentas, controles e operação

A analogia ajuda a enxergar o principal: inteligência isolada não executa uma operação. Um cérebro sem memória, sentidos, limites e capacidade de agir não resolve o processo completo.

Engenharia de IA não é apenas prompt engineering

Prompt engineering trata da forma como instruções, exemplos e contexto são apresentados ao modelo. É importante, mas cobre somente uma parte do sistema.

Um prompt pode melhorar a estrutura de uma resposta. Ele não resolve sozinho:

Em produção, o prompt precisa ser versionado como código. Alterações precisam de revisão e avaliação, porque uma frase nova pode melhorar um tipo de tarefa e piorar outro.

A disciplina mais ampla costuma ser chamada de context engineering: decidir quais instruções, exemplos, documentos, histórico, resultados de ferramentas e metadados entram na janela do modelo em cada etapa. O desafio não é preencher a janela com tudo. É selecionar o contexto mínimo que aumenta a chance de uma resposta correta.

As camadas de uma arquitetura de IA

Uma arquitetura robusta pode ser lida em camadas. Nem todo projeto precisa de todas elas no primeiro dia, mas a equipe deve saber qual problema cada camada resolve.

1. Objetivo de negócio e contrato do sistema

Antes de escolher modelo, defina a tarefa.

“Criar um assistente inteligente” não é um contrato. “Ler o chamado, classificá-lo entre seis categorias e encaminhar para a fila correta com justificativa” é muito mais testável.

Um contrato útil descreve:

Quanto mais objetiva for a tarefa, mais fácil será escolher arquitetura e criar avaliações.

2. Dados e governança

Os dados podem entrar no treinamento, no contexto de cada chamada, em um índice de busca, na memória ou no resultado de uma ferramenta. Cada caminho tem riscos diferentes.

A equipe precisa registrar:

Uma aplicação de IA não deve receber todos os dados disponíveis “para ficar mais inteligente”. Deve receber somente o necessário para aquela tarefa.

Também é preciso separar instrução de conteúdo. Um documento recuperado por RAG pode conter uma frase como “ignore as regras anteriores”. Para o sistema, esse trecho continua sendo dado não confiável, não uma instrução autorizada.

3. Modelo

A escolha do modelo envolve qualidade, latência, custo, contexto, disponibilidade, privacidade e suporte às capacidades necessárias.

Use o modelo mais simples que cumpre o critério de aceite. Um modelo grande pode ser necessário para raciocínio difícil, mas tarefas de classificação, extração e roteamento podem funcionar melhor com modelos menores, regras ou uma combinação dos dois.

A comparação deve acontecer no conjunto de avaliação do projeto, não em perguntas escolhidas na hora. Meça pelo menos:

Trocar o modelo pode alterar respostas mesmo sem mudar o código. Por isso, o modelo e sua versão fazem parte da configuração versionada do sistema.

4. Instruções, exemplos e saída estruturada

Uma instrução boa define papel, tarefa, limites, formato e critérios. Exemplos ajudam quando mostram decisões difíceis, não apenas casos óbvios.

Quando outra parte do software consumirá a resposta, prefira saída estruturada com schema. Um objeto com campos conhecidos é mais fácil de validar do que um parágrafo que precisa ser interpretado depois.

Mesmo com schema, valide:

A saída do modelo deve ser tratada como entrada não confiável até passar por validação.

5. Recuperação de conhecimento com RAG

Retrieval-Augmented Generation combina busca e geração. Antes de responder, o sistema recupera trechos relevantes de fontes autorizadas e os entrega ao modelo.

RAG é indicado quando a aplicação precisa responder com base em:

O fluxo básico é:

  1. coletar documentos;
  2. limpar e normalizar;
  3. dividir em trechos;
  4. criar representações para busca;
  5. indexar com metadados e permissões;
  6. transformar a pergunta em consulta;
  7. recuperar candidatos;
  8. reordenar por relevância;
  9. montar o contexto;
  10. gerar a resposta com referências.

O desafio está na recuperação. Um modelo não consegue usar um documento que nunca chegou ao contexto.

A documentação da Microsoft sobre RAG chama atenção para consulta, múltiplas fontes, limite de tokens, latência e governança. Esses pontos precisam ser medidos separadamente.

Avalie RAG em duas partes:

Uma resposta bonita pode esconder uma busca ruim. Uma busca ótima também pode ser desperdiçada por uma instrução que não exige fidelidade às fontes.

6. Memória

Memória não é sinônimo de enviar a conversa inteira em todas as chamadas.

Há pelo menos quatro tipos úteis:

Cada item precisa de origem, validade, escopo e política de exclusão. Uma preferência do usuário pode permanecer. Um token de acesso, uma instrução encontrada em um documento ou uma conclusão não verificada não deve virar memória durável.

Resumir contexto também exige cuidado. Um resumo ruim pode transformar hipótese em fato e contaminar as próximas decisões.

7. Ferramentas e APIs

Ferramentas permitem que a IA consulte sistemas e produza efeitos. Exemplos:

A descrição da ferramenta é parte da interface. Nomes ambíguos e parâmetros genéricos aumentam erros.

Uma boa ferramenta tem:

A Anthropic recomenda interfaces simples e bem documentadas e destaca que equipes podem gastar mais tempo melhorando ferramentas do que o prompt geral. Isso faz sentido: o modelo só consegue agir com a precisão que a interface permite.

8. MCP

O Model Context Protocol é um padrão aberto para conectar aplicações de IA a dados, ferramentas e workflows. A documentação oficial usa a analogia de uma porta USB-C: o protocolo padroniza a conexão, sem definir sozinho a lógica completa da aplicação.

Em uma arquitetura MCP há clientes e servidores que negociam capacidades. Servidores podem expor recursos, ferramentas e prompts. O host mantém a experiência principal e decide quais conexões estarão disponíveis.

MCP reduz integrações específicas, mas não elimina segurança. Um servidor continua sendo software que pode ler dados ou executar ações. A equipe precisa controlar:

A introdução oficial do Model Context Protocol explica o padrão e seus casos de uso. Para produção, consulte também as recomendações de segurança do protocolo.

9. Workflows e agentes

Um workflow usa caminhos definidos por código. Um agente decide o próximo passo com base no estado e nas ferramentas disponíveis.

Use workflow quando a sequência é conhecida. Por exemplo: receber arquivo, validar campos, gravar no sistema e notificar uma pessoa.

Use agente quando a tarefa exige investigação, escolha de fonte ou adaptação. Por exemplo: analisar por que uma integração falhou, buscar a documentação relevante e propor a próxima ação.

A recomendação da Anthropic é começar pela solução mais simples e aumentar a complexidade somente quando houver ganho mensurável. Muitas aplicações funcionam com uma chamada de modelo, RAG e regras. Agentes trocam previsibilidade, custo e latência por flexibilidade.

Quando um agente produz efeitos, ele precisa de contrato, estado e validação. O artigo sobre Loop Engineering detalha o ciclo de observar, agir, verificar e escalar.

Ciclo de engenharia de IA com definição do caso de uso, protótipo, avaliação, proteção, lançamento, monitoramento e melhoria

10. Políticas, guardrails e revisão humana

Guardrail não é uma frase no prompt pedindo que o modelo se comporte. É uma combinação de controles em várias camadas.

Alguns exemplos:

O OWASP Top 10 para aplicações com LLMs inclui prompt injection entre os principais riscos. A mitigação não depende de uma barreira única. É preciso reduzir privilégios, separar dados de instruções, validar efeitos e assumir que conteúdo externo pode ser adversarial.

A pessoa entra quando a decisão é irreversível, sensível, ambígua ou fora do contrato. O sistema deve chegar à revisão com evidência, proposta e motivo do bloqueio. Apenas mostrar toda a conversa transfere o trabalho de investigação para quem deveria decidir.

Avaliações: como testar um sistema probabilístico

Teste unitário continua necessário. Ele cobre parsing, regras, integração, autorização e código determinístico. Mas não mede sozinho se uma resposta está correta, apoiada nas fontes ou adequada ao caso.

Uma estratégia de avaliações combina vários níveis.

Avaliação de componente

Teste partes isoladas:

Isso ajuda a localizar o problema. Se o sistema errou porque não recuperou o documento certo, trocar o prompt final pode não resolver.

Avaliação de trajetória

Para agentes, avalie o caminho:

Duas trajetórias podem chegar à mesma resposta, mas uma delas pode ser cara, insegura ou impossível de auditar.

Avaliação de resultado

O resultado deve atender ao critério de aceite. Use verificadores determinísticos quando possível: igualdade de campos, execução de testes, leitura posterior, consistência de banco e regras de negócio.

Quando a avaliação exige julgamento, use rubricas claras e compare o avaliador automático com amostras revisadas por pessoas. Um modelo avaliador também erra e pode compartilhar vieses com o modelo avaliado.

A documentação de boas práticas de avaliações da OpenAI recomenda avaliar cedo, usar testes específicos da tarefa, registrar resultados e combinar diferentes tipos de avaliadores.

Conjunto de avaliação

Monte o conjunto com dados representativos:

Separe casos de desenvolvimento e regressão. Se a equipe ajusta o prompt olhando sempre para as mesmas entradas, pode otimizar para o conjunto em vez de melhorar o sistema.

Métricas úteis

A métrica depende da tarefa, mas um painel pode incluir:

A média esconde problemas. Acompanhe também percentis de latência e custo, além de resultados por tipo de caso, cliente, idioma e versão.

Observabilidade para IA

Logs tradicionais continuam úteis, mas aplicações de IA exigem contexto adicional.

Uma execução deve permitir responder:

Não registre tudo por padrão. Prompts, documentos e retornos de ferramentas podem conter dados pessoais, segredos ou informações comerciais. Use mascaramento, amostragem, retenção limitada e controle de acesso.

OpenTelemetry vem desenvolvendo convenções semânticas para operações de IA generativa. Padronizar spans e atributos ajuda a acompanhar o fluxo entre aplicação, modelo, recuperação e ferramentas sem prender a observabilidade a um único fornecedor.

Controles de produção em engenharia de IA: avaliações, segurança, observabilidade, custo, revisão humana e governança ao redor do sistema

Segurança em engenharia de IA

Sistemas de IA herdam riscos de software e adicionam outros relacionados a linguagem, contexto e autonomia.

Prompt injection

Uma instrução maliciosa pode vir do usuário ou de conteúdo recuperado, como página, e-mail ou documento. O modelo pode interpretá-la como ordem.

Reduza o risco tratando conteúdo externo como dado não confiável, limitando ferramentas, separando autorização da decisão do modelo e exigindo confirmação para ações sensíveis.

Vazamento de dados

A saída pode revelar conteúdo privado, contexto de outra pessoa ou informação presente em logs. Permissões devem ser aplicadas antes da recuperação e antes da ação, não apenas descritas no prompt.

Uso excessivo de ferramentas

Uma ferramenta ampla transforma um erro de interpretação em efeito real. Prefira operações pequenas, escopo por recurso e credenciais temporárias ou específicas da tarefa.

Dependência da saída

Não execute SQL, comandos, HTML ou código gerado sem validação e isolamento. Saída estruturada reduz ambiguidade, mas ainda exige schema, política e sanitização.

Cadeia de suprimentos

Modelos, SDKs, servidores MCP, plugins, bases e dependências fazem parte da cadeia. Registre versões, avalie fornecedores, restrinja atualizações automáticas em componentes sensíveis e tenha uma forma de revogar conexões.

Governança e risco

O perfil de IA generativa do NIST AI RMF organiza ações de gestão de risco ao longo do ciclo de vida. Ele é voluntário, mas oferece uma referência para mapear contexto, medir riscos, gerir controles e definir governança.

Latência, custo e desempenho

Uma arquitetura mais complexa costuma aumentar tempo e custo. Um agente que planeja, busca, usa ferramentas e valida pode fazer várias chamadas para concluir uma tarefa.

Otimize a partir do resultado, não apenas do preço por token.

Algumas estratégias:

Cache exige cuidado. Uma resposta pode depender de usuário, permissão, versão do documento e data. A chave precisa representar essas diferenças para evitar resultado desatualizado ou vazamento entre contextos.

Deploy, versionamento e LLMOps

Prompts, modelos, índices, ferramentas, políticas e avaliadores mudam. Cada mudança pode alterar o comportamento.

Uma prática saudável mantém versões de:

O pipeline deve executar avaliações antes da publicação, comparar com uma linha de base e bloquear regressões importantes. Mudanças com risco maior podem passar por rollout gradual, tráfego espelhado ou teste com um grupo pequeno.

Tenha rollback. Se o fornecedor muda o comportamento, a recuperação perde qualidade ou uma nova instrução aumenta erros, a equipe precisa voltar a uma combinação conhecida.

A equipe de engenharia de IA

O nome dos cargos varia. As responsabilidades, não tanto.

Um projeto completo costuma precisar de:

Em empresas menores, uma pessoa pode acumular papéis. Isso não elimina as responsabilidades. Apenas torna mais importante deixar decisões e critérios explícitos.

Uma equipe de TI terceirizada pode ajudar quando a empresa precisa dessas competências sem montar imediatamente um departamento completo.

Um roteiro prático do protótipo à produção

Etapa 1: escolha uma tarefa mensurável

Defina usuário, entrada, saída e critério de aceite. Evite começar por um chatbot genérico.

Etapa 2: crie uma linha de base

Teste o processo atual. Registre tempo, erro, custo e intervenção humana. Sem linha de base, é difícil saber se a IA melhorou alguma coisa.

Etapa 3: comece com a menor arquitetura

Tente uma chamada estruturada. Adicione exemplos. Use RAG somente se faltar conhecimento. Use ferramenta somente se a tarefa exigir ação. Use agente somente se o caminho não puder ser definido antes.

Etapa 4: construa o conjunto de avaliação

Inclua casos reais, limites, falhas e situações de recusa. Defina quem decide quando uma resposta é aceitável.

Etapa 5: proteja dados e ações

Aplique identidade, autorização, validação, isolamento e aprovação. O modelo não deve concentrar decisão e permissão.

Etapa 6: teste a arquitetura completa

Avalie componente, trajetória e resultado. Simule timeout, documento malicioso, ferramenta indisponível, dado contraditório e custo acima do limite.

Etapa 7: instrumente antes do lançamento

Registre versões, latência, tokens, documentos, ferramentas, políticas, avaliações e resultado operacional com tratamento de dados sensíveis.

Etapa 8: lance com escopo controlado

Comece com usuários, tarefas e permissões limitados. Compare resultados com o processo anterior e mantenha uma rota de fallback.

Etapa 9: revise falhas reais

Transforme erros de produção em novos casos de avaliação. Separe erro de modelo, recuperação, ferramenta, regra, interface e processo.

Etapa 10: aumente autonomia por evidência

Aumente permissões quando o sistema demonstrar qualidade e controle no escopo atual. Autonomia não deveria ser um botão ligado no início do projeto.

Anti-padrões que tornam projetos de IA caros

Começar pelo chatbot

A interface de conversa pode esconder uma tarefa mal definida. Comece pelo processo e pelo resultado.

Enviar todos os documentos ao modelo

Mais contexto não significa melhor contexto. Excesso aumenta custo, latência e confusão.

Usar agente para fluxo previsível

Se o caminho é conhecido, escreva o workflow. Um agente adiciona variação onde talvez não exista benefício.

Avaliar pela demonstração

Uma apresentação escolhe casos favoráveis. Produção contém entradas incompletas, usuários diferentes, falhas externas e ataques.

Dar uma credencial ampla

O modelo deve receber capacidades específicas, não uma chave capaz de acessar toda a operação.

Monitorar somente tokens

Tokens explicam parte do custo. Não mostram se o usuário recebeu resposta correta ou se a ação ocorreu.

Corrigir tudo no prompt

Problemas de permissão, recuperação, schema e integração precisam de engenharia, não de uma frase mais convincente.

Guardar memória sem governança

Memória errada permanece errada por muito tempo. Registre origem, validade, escopo e exclusão.

Arquitetura de referência

Para um assistente interno que responde sobre procedimentos e abre tarefas, uma arquitetura inicial pode ser:

  1. autenticação da pessoa usuária;
  2. aplicação recebe a pergunta;
  3. política define fontes e ferramentas permitidas;
  4. busca híbrida recupera documentos que a pessoa pode acessar;
  5. reranking seleciona os trechos mais relevantes;
  6. modelo responde com referências ou identifica necessidade de ação;
  7. ação é convertida em chamada estruturada;
  8. autorização externa valida recurso e efeito;
  9. workflow executa a mudança;
  10. sistema lê o resultado e confirma;
  11. avaliação registra qualidade e aderência;
  12. observabilidade conecta toda a trajetória;
  13. casos sensíveis seguem para revisão humana.

Essa arquitetura pode começar sem agente. Se, depois, a tarefa exigir várias buscas e decisões dinâmicas, o agente entra dentro dos mesmos limites.

Como a Foyth Tech trabalha com engenharia de IA

Um projeto de IA útil começa com a operação, não com a escolha de um modelo.

Na Foyth Tech, o trabalho pode incluir:

Também é possível começar pequeno. Um primeiro projeto pode automatizar uma classificação, consultar uma base interna, preparar uma resposta ou apoiar uma etapa específica da equipe. A arquitetura cresce quando a evidência mostra necessidade.

Se sua empresa tem um processo que poderia usar IA, mas precisa de segurança, integração e critérios de qualidade, fale com a Foyth Tech.

Referências

Perguntas frequentes

Engenharia de IA exige treinar um modelo próprio?

Não. Muitos projetos usam modelos prontos por API e concentram a engenharia em contexto, dados, integração, avaliação e segurança. Treinamento ou fine-tuning só deve entrar quando os testes mostram que instruções, exemplos e recuperação não atendem ao caso.

RAG elimina alucinações?

Não. RAG fornece fontes relevantes, mas o sistema ainda pode recuperar trechos errados, ignorar evidência ou produzir afirmações que não estão nos documentos. Avalie recuperação e geração separadamente e exija referências quando o caso pedir rastreabilidade.

MCP substitui APIs?

Não. MCP padroniza como aplicações de IA descobrem e usam recursos e ferramentas. Os servidores podem encapsular APIs existentes. Autenticação, autorização, disponibilidade e regras de negócio continuam necessárias.

Todo agente precisa de memória?

Não. Muitas tarefas funcionam com o estado da execução atual. Memória de longo prazo só deve existir quando uma informação precisa permanecer e há regra clara de origem, validade, acesso e exclusão.

Como calcular o custo de uma aplicação de IA?

Some modelos, busca, armazenamento, ferramentas, infraestrutura, observabilidade e revisão humana. Divida pelo resultado aceito, não apenas pelo número de chamadas. Inclua percentis altos, porque tarefas difíceis podem consumir muito mais do que a média.

Qual é o primeiro passo para implementar IA em uma empresa?

Escolha uma tarefa específica, defina o resultado aceitável e registre como ela funciona hoje. Depois, crie um protótipo simples e um conjunto de casos de avaliação antes de adicionar RAG, agentes ou múltiplas integrações.

Perguntas frequentes

O que é engenharia de IA?
Engenharia de IA é a disciplina de transformar modelos de inteligência artificial em sistemas úteis, verificáveis e operáveis. Ela combina software, dados, modelos, recuperação de conhecimento, ferramentas, avaliações, segurança, observabilidade e processos humanos.
Qual é a diferença entre engenharia de IA e engenharia de software?
A engenharia de software tradicional parte de regras determinísticas. Sistemas de IA incluem componentes probabilísticos, nos quais a mesma entrada pode produzir variações. Por isso, além de testes de código, a equipe precisa avaliar qualidade semântica, segurança, contexto, custo e comportamento em conjuntos representativos de casos.
Todo sistema de IA precisa de RAG?
Não. RAG faz sentido quando a resposta depende de conhecimento privado, atualizado ou rastreável. Para tarefas de classificação, extração ou transformação de texto, uma chamada bem estruturada ao modelo pode ser suficiente. A arquitetura deve começar simples e ganhar componentes apenas quando uma necessidade mensurável justificar.
Qual é a diferença entre workflow e agente de IA?
Um workflow segue etapas definidas pelo software. Um agente decide dinamicamente quais passos e ferramentas usar dentro de limites estabelecidos. Workflows são mais previsíveis; agentes são úteis quando o caminho depende da evidência encontrada. Muitos sistemas de produção combinam os dois.
Como avaliar se uma aplicação de IA está pronta para produção?
Defina casos de teste, critérios de aceite e limites de risco. Meça qualidade da resposta, recuperação de contexto, uso correto de ferramentas, segurança, latência, custo e taxa de intervenção humana. Depois, valide o sistema completo com dados representativos e monitore o comportamento em produção.
Como a Foyth Tech pode ajudar em um projeto de engenharia de IA?
A Foyth Tech pode mapear o caso de uso, desenvolver o protótipo, integrar dados e ferramentas, implementar RAG ou agentes quando fizer sentido, criar avaliações, controles de segurança e observabilidade, além de acompanhar a evolução do sistema em produção.

Continue lendo