Infraestrutura de IA personalizada
Atualizar infraestrutura de IA sem refazer tudo: troque uma peça por vez
Troque o modelo, um conector ou a memória da camada de IA da empresa sem refazê-la nem perder registros. Plano passo a passo com checagens em cada etapa.

Você pode atualizar uma peça da camada de IA da empresa sem refazer o sistema inteiro, mas só se cada parte tiver limites definidos, se os registros que ela grava ficarem em um repositório que a empresa controla e se toda substituição passar pelo mesmo teste antes de tocar no trabalho real. Troque um componente por vez, começando por aquele cuja falha é mais fácil de ver e de desfazer. Mantenha a versão anterior em funcionamento até que a nova tenha se sustentado em uso real.
Principais pontos
- Defina cada parte da camada pelas suas entradas, suas saídas e os registros que ela grava.
- Guarde a memória e os registros do negócio em repositórios que a empresa possui, separados de qualquer modelo específico.
- Troque um componente por mudança e rode a mesma avaliação antes e depois.
- Mantenha a versão anterior disponível até que a substituta tenha se saído bem no trabalho real.
- Registre cada mudança com o responsável, o motivo e a condição que dispara a reversão.
Mapeie as peças antes de mexer em qualquer coisa
Uma camada de IA da empresa é mais fácil de atualizar quando você consegue nomear as suas peças. Na maioria das configurações há cinco: o modelo que lê e escreve texto, as instruções e o contexto operacional que dizem ao sistema como a empresa funciona, os conectores de ferramentas que permitem ler ou alterar sistemas como agenda, CRM ou ferramenta de faturamento, o repositório de memória onde ficam fatos, decisões e histórico de clientes, e as regras de permissão que definem o que cada parte pode fazer.
Escreva essas peças em uma única página. Um mapa de arquitetura simples, com uma caixa por peça, setas para o fluxo de dados e um responsável nomeado para cada caixa, basta para a maioria das decisões. Se você não consegue dizer quais registros um conector grava, ou quem responde por eles, ainda não está pronto para substituí-lo, porque não sabe o que a substituição precisa preservar.
Qual componente trocar primeiro?
Nem toda peça carrega o mesmo risco, e a ordem da troca importa. Use este guia para decidir por onde começar:
- Troque o modelo primeiro quando suas instruções, definições de ferramentas e casos de avaliação forem escritos de forma independente de um fornecedor. Uma troca de modelo deve alterar a qualidade do raciocínio e da redação, não os registros.
- Troque um conector de ferramenta quando a nova versão expuser as mesmas ações, com os mesmos nomes, campos de entrada e mensagens de erro. Trate qualquer mudança nas permissões concedidas como uma mudança de permissão, e não como detalhe técnico.
- Troque o repositório de memória por último, e somente depois de ter uma exportação verificada e um mapeamento campo a campo dos registros antigos para a nova estrutura.
- Nunca troque duas peças na mesma entrega. Se o comportamento mudar, você precisa saber qual mudança o causou.
O desenho neutro em relação ao modelo é o que torna a primeira opção prática. Quando prompts, esquemas de ferramentas e casos de teste ficam em documentos da própria empresa, e não dentro do console de um fornecedor, trocar o modelo vira um exercício de comparação, e não uma migração. O mesmo princípio explica por que o repositório de memória é a peça mais sensível de mover: é o único componente em que um erro se transforma em perda permanente de histórico.
Um passo a passo para trocar um componente
Use esta sequência para qualquer mudança em uma única peça, seja ela um modelo, um conector ou um repositório:
- Escreva uma solicitação de mudança com o responsável, o motivo, o benefício esperado e a condição em que você fará a reversão.
- Congele o contrato de interface atual: as entradas, as saídas, os erros conhecidos e a lista de registros que o componente grava.
- Faça uma cópia de segurança de cada registro que o componente toca e confirme que a cópia abre e se lê corretamente.
- Construa a substituta atrás da mesma interface, sem enviar a ela nenhum tráfego real ainda.
- Rode o conjunto de avaliação existente nas versões antiga e nova, e compare os resultados caso a caso, e não por médias.
- Execute a nova versão em modo sombra, em que ela recebe pedidos reais, suas saídas são registradas e nada chega a clientes ou sistemas.
- Passe uma pequena parcela do trabalho real para a nova versão, acompanhe as taxas de erro e a qualidade dos registros, e amplie a parcela somente se os resultados se mantiverem.
- Mantenha a versão antiga disponível por um período combinado e registre a decisão final no histórico de mudanças.
O processo de solicitação de mudança é onde a maioria das equipes descobre o responsável que faltava ou a condição de reversão que nunca foi declarada. Por isso vale concluí-lo antes de qualquer trabalho técnico começar.
Mantenha os registros íntegros quando a memória mudar
A memória é onde as atualizações mais costumam dar errado. Um repositório de memória guarda mais do que texto. Ele registra quem disse o quê, quando uma decisão foi aprovada e de onde veio cada fato. Ao mover esse material, leve junto os campos de proveniência, as datas originais e o identificador da fonte que criou cada entrada. Sem eles, o novo repositório terá afirmações que ninguém consegue rastrear até um documento ou uma pessoa, e o agente as usará com a mesma confiança que usa para fatos verificados.
As gravações também precisam ser seguras para repetir. Se um conector expira e tenta de novo, a segunda gravação não pode criar uma nota duplicada de fatura ou uma segunda cópia da preferência de um cliente. Plataformas de pagamento resolvem isso com chaves de idempotência: o cliente envia uma chave única em cada requisição, e uma nova tentativa com a mesma chave devolve o resultado original em vez de agir de novo. Seus próprios conectores precisam da mesma disciplina, seja o fornecedor compatível com isso ou não. Eventos recebidos de sistemas externos também devem ser verificados antes de entrar na memória, para que uma origem inesperada não consiga acrescentar registros ao seu repositório.
Para preparar o material antes de qualquer migração, vale ver como a empresa transforma arquivos físicos e papéis soltos em uma memória organizada, com campos e origens claros.
Teste a substituta contra a mesma avaliação
Uma substituição só é uma atualização se tiver desempenho igual ou melhor nos casos que importam para o seu negócio. Monte um conjunto pequeno de avaliação com trabalho real: pedidos comuns, os casos de borda que sua equipe já resolve à mão, alguns erros passados e pelo menos um pedido que o agente deveria recusar ou encaminhar. Pontue as versões antiga e nova nos mesmos casos e registre três coisas: se a ferramenta certa foi chamada com as entradas certas, se o registro correto foi gravado e se o agente pediu aprovação quando as regras exigiam.
O guia de avaliações da OpenAI e os textos da Anthropic sobre avaliação de agentes descrevem a avaliação pelo resultado final de uma tarefa, e não apenas pela redação de uma resposta. Essa distinção pesa durante uma troca, porque um modelo pode soar mais fluente enquanto produz um registro diferente.
Cenário ilustrativo: uma empresa usa um agente que redige orçamentos para clientes a partir de uma tabela de preços guardada em um conector de ferramenta. A equipe troca o modelo por outro que escreve mais rápido. No conjunto de avaliação, o novo modelo trata bem os orçamentos comuns, mas aplica um desconto por volume em vários casos em que a versão antiga corretamente não aplicava nenhum. A equipe não publica a mudança. Ajusta as instruções, roda os mesmos casos de novo, confirma a lógica de desconto em todos eles e só então inicia o modo sombra.
Controle as permissões durante a troca e depois confira os resultados
Um novo modelo ou conector pode pedir ações que a versão anterior nunca usou. Antes de qualquer troca, compare as permissões concedidas e as permissões das ferramentas linha por linha, e dê à substituta apenas o que a tarefa atual exige. Guarde as credenciais na camada de ferramentas, e não nos prompts, para que um documento com instruções escondidas não consiga ampliar o que o agente pode fazer. A orientação da OWASP sobre injeção de prompt recomenda tratar textos recuperados ou recebidos como dados, e não como instruções, e a orientação da OWASP sobre autorização recomenda aplicar as verificações de acesso fora do modelo. O Model Context Protocol oferece uma interface consistente para conexões de ferramentas, o que facilita substituir um conector, mas uma interface padronizada não elimina a necessidade de revisar o que o conector tem permissão de fazer.
Na operação gerenciada, a Be Human mantém as partes do agente de cada empresa documentadas como componentes separados, com responsáveis nomeados. Assim, uma troca é tratada como mudança rastreada, com avaliação, cópia dos registros e caminho de reversão, e não como reconstrução. Monitoramento e avaliações recorrentes mostram se a substituta se comporta como a peça anterior, as revisões de permissão confirmam que os escopos continuaram restritos, e identidade, memória e contexto operacional permanecem sob controle da empresa o tempo todo.
Se você quer descobrir qual peça da sua própria camada deve ser a primeira mudança, faça o diagnóstico gratuito da Be Human para identificar a primeira tarefa que vale entregar a um agente.
Perguntas frequentes
Posso trocar o modelo sem tocar no repositório de memória? Sim, na maioria das configurações bem documentadas. O repositório de memória guarda registros, e não o comportamento do modelo. Por isso, uma troca de modelo deve deixar os fatos armazenados intactos, desde que instruções e esquemas de ferramentas estejam guardados separadamente e o novo modelo seja testado com os mesmos casos de avaliação antes do uso real.
Preciso parar o agente enquanto troco um componente? Normalmente não. O modo sombra permite que o componente novo receba pedidos reais enquanto suas saídas apenas são registradas, e a passagem gradual do trabalho real permite ampliar a mudança em etapas. Parar o agente só é necessário quando a mudança altera registros de um jeito que não pode rodar ao lado da versão antiga.
E se o componente novo não conseguir ler os registros antigos? Não force a migração. Primeiro exporte uma cópia de segurança, mapeie cada campo antigo para um campo novo ou marque-o como descontinuado, e guarde a exportação original em um armazenamento somente de leitura. Só troque o componente depois que o mapeamento tiver sido revisado e a cópia tiver sido confirmada como legível.
Com que frequência devemos repetir essas verificações? Repita a avaliação e as checagens de permissão após cada troca de componente e também nas revisões periódicas da camada, porque fornecedores atualizam modelos e conectores sem sempre mudar seus nomes. Uma revisão recorrente com os mesmos casos mostra as mudanças de comportamento cedo, antes que cheguem a clientes ou aos registros da empresa.
Seu próximo passo
Descubra primeiro onde um agente de IA cabe na sua empresa.
Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.
Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.


