Infraestrutura de IA personalizada
Diagrama de camada de superinteligência: como as partes se conectam
Guia direto do diagrama de camada de superinteligência: modelos, harness, memória, ferramentas, permissões, canais e observabilidade, e como se conectam.

Um diagrama de camada de superinteligência mostra as partes que uma empresa precisa para operar agentes de IA sob o próprio controle: modelos, harness, memória, ferramentas, permissões, canais e observabilidade. Os componentes se conectam em um único ciclo. Um canal entrega a solicitação, o harness monta o contexto a partir da memória, um modelo propõe uma ação, as permissões decidem se uma ferramenta pode executar, e a observabilidade registra o que aconteceu para que a empresa possa revisar e melhorar.
Principais pontos
- A camada é formada por partes separadas, e cada parte precisa de um dono definido antes de qualquer construção começar.
- Os modelos são o componente mais fácil de trocar, então a empresa deve ser dona do harness, da memória, das permissões e dos registros ao redor deles.
- Toda chamada de ferramenta passa por uma verificação de permissão fora do modelo, e ações de alto impacto aguardam a aprovação de uma pessoa nomeada.
- A observabilidade é a forma de provar que a camada funciona, por isso deve fazer parte do primeiro desenho, e não ser pensada depois do lançamento.
- Desenhe o diagrama para um único papel e um único critério de sucesso, e acrescente componentes só quando esse papel precisar deles.
Por que desenhar a camada antes de escolher um modelo
A maioria das empresas começa a conversa sobre IA com um fornecedor de modelos e uma demonstração. O diagrama inverte essa ordem. Ele pergunta quais partes a empresa precisa controlar, quais podem ser substituídas e quem responde por cada uma quando algo dá errado. Essas respostas importam mais do que qualquer modelo específico, porque os modelos mudam com frequência, enquanto o contexto operacional, o conhecimento aprovado e o histórico de decisões devem sobreviver a uma troca de fornecedor.
Um diagrama útil cabe em uma página. Ele tem uma caixa para cada componente, setas para o caminho de uma solicitação e uma linha no topo que nomeia o papel atendido. Qualquer caixa sem dono é a primeira lacuna a fechar. Líderes que querem fazer esse exercício a partir do planejamento podem comparar com Revisão da arquitetura de IA da empresa, e o raciocínio por trás de manter as partes substituíveis está em Dependência de fornecedor em agentes de IA.
Os sete componentes e o que cada um faz
Cada componente tem uma única função. Manter as funções separadas é o que permite trocar uma parte sem reconstruir as outras.
- Modelos: os motores de raciocínio que leem uma solicitação e propõem o próximo passo. Podem ser substituídos quando surgem opções melhores, por isso a camada nunca deve depender de um único modelo.
- Harness: o código e a configuração que executam o ciclo do agente. Ele define as instruções, limita quantos passos uma execução pode dar e decide quando parar ou encaminhar o caso para uma pessoa.
- Memória: o conhecimento aprovado que o agente pode ler, como políticas, fatos sobre produtos, histórico de contas e decisões anteriores. Ela fica fora do modelo para que a empresa possa inspecionar, corrigir e excluir o conteúdo.
- Ferramentas: as ações que o agente pode executar em outros sistemas, como consultar um embarque, rascunhar uma proposta ou atualizar um chamado. Cada ferramenta tem entrada definida, saída definida e um dono.
- Permissões: as regras que definem qual identidade de agente pode usar qual ferramenta, sobre quais dados, para quais operações, e quais ações exigem aprovação humana antes de executar.
- Canais: os lugares onde pessoas e sistemas acessam o agente, como e-mail, um espaço de chat ou um formulário web. Cada canal carrega sua própria identidade e seus próprios limites sobre o que o agente pode mostrar.
- Observabilidade: o registro de cada execução, incluindo a solicitação, a memória usada, cada chamada de ferramenta, cada aprovação, o resultado e o custo, para que alguém que não construiu o agente consiga revisar seu comportamento.
Um chatbot costuma ser um modelo com uma caixa de texto. A camada acrescenta as regras e os registros ao redor do modelo, e a maior parte do trabalho operacional está nessas regras e nesses registros, e não no modelo em si.
Como uma solicitação percorre a camada
As setas de um diagrama importam mais do que as caixas. Acompanhe uma solicitação do início ao fim para ver como os componentes dependem uns dos outros.
Cenário ilustrativo: um coordenador de atendimento de uma pequena distribuidora encaminha uma mensagem pedindo o reembolso de uma entrega atrasada. O canal associa a identidade do coordenador à solicitação, para que o agente saiba quem pediu e o que essa pessoa pode ver. O harness carrega as instruções do papel e busca a política de devoluções e o histórico do pedido na memória aprovada, e não no conhecimento geral do modelo. O modelo lê o caso e propõe duas chamadas de ferramenta: uma para consultar o registro do embarque e outra para rascunhar o reembolso.
A camada de permissões autoriza a consulta ao embarque, porque ela é somente leitura e está dentro do escopo. O reembolso é uma ação de escrita acima do limite definido pela empresa, então o harness pausa a execução e envia a proposta de reembolso a um aprovador nomeado pelo mesmo canal. Quando o aprovador confirma, a ferramenta de reembolso executa uma única vez, carregando uma chave de idempotência, de modo que uma nova tentativa após uma falha de rede não possa emitir o reembolso duas vezes. Provedores de pagamento documentam esse padrão nas orientações sobre requisições idempotentes, uma referência útil sempre que as ferramentas da própria empresa gravarem dados. Em seguida, a observabilidade armazena o rastro completo: a solicitação, os itens de memória usados, as duas chamadas de ferramenta, a aprovação e o status final.
A mesma sequência serve para a maioria dos processos de negócio. Troque o reembolso por uma minuta de contrato, um pedido de compra ou uma mudança de agenda, e os passos continuam os mesmos: identificar, buscar, propor, verificar, pausar se necessário, executar uma vez, registrar.
Onde ficam as permissões e por que elas não estão no prompt
As permissões precisam ser aplicadas fora do modelo. Um prompt pode dizer que o agente não deve emitir reembolsos acima de um limite, mas instruções são apenas orientação. O modelo também lê textos de e-mails, documentos e páginas web, e esses textos podem conter instruções próprias. As orientações da OWASP sobre prevenção de injeção de prompt se apoiam nesse ponto: não se pode confiar que uma entrada não confiável vigie o sistema que a lê. A aplicação da regra deve ficar na ferramenta, que verifica a identidade que chama, o escopo dos dados e o tipo de operação antes de agir.
A autorização também deve ser checada em cada ponto de acesso, e não presumida a partir de uma etapa anterior. As orientações da OWASP sobre autorização descrevem o mesmo princípio para código de aplicação em geral. Aplicado a agentes, isso significa dar a cada agente a sua própria identidade e as suas próprias concessões, separadas das contas dos funcionários.
Uma regra de permissão que vale a pena escrever deve dizer:
- qual identidade de agente está chamando a ferramenta
- qual operação é permitida, como leitura, rascunho, envio ou alteração
- quais campos de dados estão no escopo
- qual condição exige aprovação humana nomeada
- quando a concessão expira e quem é responsável por renová-la
Revise essas regras em um calendário fixo, e não apenas na configuração inicial. A Revisão trimestral de permissões de agentes de IA mostra como conduzir essa revisão passo a passo.
Observabilidade: o componente que prova que a camada funciona
A observabilidade responde à pergunta que todo líder de operações acaba fazendo: o que o agente fez, e por quê? A introdução à observabilidade da OpenTelemetry descreve a estrutura básica. Um trace acompanha uma solicitação por um sistema, e cada etapa dentro dele é registrada como um span, com tempo, status e atributos. Em um agente, um span pode representar uma chamada ao modelo, uma busca na memória, uma chamada de ferramenta ou uma espera por aprovação, de modo que a execução inteira se lê como uma única linha do tempo.
Registre o suficiente para julgar o comportamento sem depender do engenheiro que construiu o agente. Isso inclui o motivo de cada chamada de ferramenta, os itens de memória usados, a identidade do aprovador, o resultado final e o custo da execução. O custo por execução é o que permite ao responsável financeiro avaliar se o papel se justifica. Os mesmos registros também mostram quando uma troca de modelo deixou o agente mais lento, menos preciso ou mais caro.
A Be Human desenha, implementa e opera essa camada para empresas, e suas operações gerenciadas incluem o monitoramento desses traces, avaliações recorrentes contra o critério de sucesso definido no início e a revisão de permissões em um calendário fixo. Quando ocorre um incidente, a resposta começa pelo rastro registrado, e não pela memória de alguém, de modo que a revisão parte de evidências. A empresa mantém a propriedade do diagrama, das regras e dos registros em todo o processo.
Checklist para o primeiro diagrama
Antes de desenhar a camada para um papel real, confirme estes pontos no papel:
- Nomeie o único papel que a camada vai atender e escreva o critério de sucesso em uma frase.
- Liste cada modelo, ferramenta, fonte de memória e canal que o papel toca, com um dono para cada um.
- Marque quais itens de memória são aprovados, quais são rascunhos e quais nunca devem ser armazenados na camada.
- Escreva cada limite de aprovação como uma regra com aprovador nomeado, e não como uma esperança genérica de que o agente vai tomar cuidado.
- Dê ao agente identidade e concessões próprias, separadas de qualquer login de funcionário.
- Defina o que cada canal pode mostrar e quem pode ler a saída.
- Confirme que cada execução deixa um rastro que um revisor consegue ler sem ajuda de quem construiu o agente.
- Defina quem pode pausar o agente, como faz isso e quem é avisado.
Três erros aparecem em muitos primeiros rascunhos. O primeiro coloca o modelo no centro e trata todo o resto como encanamento, o que esconde as partes que a empresa precisa ser dona. O segundo trata a memória como um histórico de conversas salvo, o que mistura fatos aprovados com palpites. O terceiro dá ao agente um login compartilhado, o que torna suas ações impossíveis de atribuir.
Por onde começar a sua própria camada
Escolha um papel com saída clara, um conjunto pequeno de ferramentas e um critério de sucesso que alguém consiga verificar em um mês. Construa apenas os componentes que esse papel precisa e acrescente o restante quando as evidências pedirem. A camada cresce na mesma ordem da confiança: primeiro um papel, depois um segundo papel que reutiliza a mesma memória e as mesmas permissões, depois uma cobertura mais ampla.
Se ainda não está claro qual tarefa deve vir primeiro, faça o diagnóstico gratuito de IA da Be Human para identificar a primeira tarefa que vale entregar a um agente.
Perguntas frequentes
O harness é a mesma coisa que o modelo? O modelo produz o raciocínio e o próximo passo proposto, enquanto o harness é o código e a configuração ao redor que executam o ciclo, fornecem instruções e contexto, limitam o número de passos e decidem quando uma execução precisa pausar. Trocar um modelo não deveria exigir reescrever o harness, e essa é uma das razões para manter os dois separados.
Pequenas empresas precisam dos sete componentes desde o primeiro dia? Normalmente não. Um primeiro papel restrito pode usar um modelo, algumas ferramentas, uma memória com documentos aprovados, um canal, permissões básicas e um rastro simples. Os demais componentes podem ser acrescentados conforme o papel comprova seu valor e conforme cresce o risco das suas ações.
Em que a memória é diferente do que o modelo já sabe? O treinamento do modelo é um conhecimento geral controlado pelo provedor e que você não consegue inspecionar com facilidade. A memória é o material aprovado da sua empresa, armazenado fora do modelo e recuperado quando uma solicitação precisa dele, de modo que você pode revisá-lo, corrigi-lo e remover itens quando deixarem de estar corretos.
Quem deve ser dono do diagrama? Um patrocinador executivo nomeado deve ser dono da finalidade de negócio, um líder de operações deve ser dono dos limites do dia a dia e um responsável técnico deve manter os componentes. Revise o diagrama sempre que uma ferramenta, um canal ou uma permissão mudar, porque um diagrama desatualizado é pior do que nenhum para as pessoas que precisam agir a partir dele.
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.


