Infraestrutura de IA personalizada
Entrega de agentes de IA: o que a empresa deve receber por escrito
Entrega de agente de IA por escrito: prompts, exportação de memória, mapa de permissões, runbooks e avaliações que sua equipe executa.

Quando uma equipe externa devolve um agente de IA para a sua empresa, a entrega deve ser um conjunto de arquivos escritos que a sua equipe consegue ler, executar e auditar sem depender dessa equipe. No mínimo, você deve receber as instruções do agente, uma exportação da memória com as fontes, um mapa de permissões que liste cada ferramenta e escopo de dados, runbooks para operar e parar o agente e os registros de avaliação que mostram se ele funciona. Se algum desses itens existir apenas nos sistemas do fornecedor ou na cabeça de uma pessoa, o projeto não terminou. Apenas mudou de lugar a dependência.
Principais pontos
- Uma entrega está completa somente quando sua empresa consegue operar, pausar e mover o agente sem o construtor original.
- Prompts, instruções e descrições de ferramentas pertencem a você como texto versionado, não como histórico de conversa.
- Uma exportação de memória deve mostrar o que o agente sabe, de onde cada item veio e quem pode corrigi-lo.
- Um mapa de permissões lista cada ferramenta, conta e escopo de dados, com o limite de aprovação anexado a cada um.
- Runbooks e registros de avaliação transformam o conhecimento tácito em verificações que sua equipe consegue repetir.
Por que a entrega é um conjunto de arquivos, não uma reunião
Muitos projetos terminam com uma chamada de apresentação e uma gravação. A gravação mostra o que foi discutido, mas não mostra como o agente está configurado para agir na próxima terça-feira. Entregas escritas podem ser testadas. Alguém da sua equipe pode abri-las, comparar com o sistema em produção e perceber quando os dois divergem.
Um teste útil é imaginar que o gerente de operações saia da empresa na semana seguinte. Um colega competente conseguiria manter o agente rodando, pausá-lo com segurança e explicar suas decisões usando apenas os arquivos que você tem? Se a resposta depender de uma ligação para o construtor, a entrega está incompleta. Peça os arquivos antes de formalizar o aceite do trabalho, porque o seu poder de exigi-los diminui quando o contrato é encerrado.
Prompts e instruções que você deve possuir
O arquivo de instruções é a descrição de cargo do agente. Ele define para que o agente serve, o que ele nunca deve fazer, quando precisa passar um caso para uma pessoa e qual tom usar em cada canal. Trate esse arquivo como documento controlado. Ele deve estar em texto simples ou em formato padrão, guardado em um local que sua empresa controla, com histórico de versões e um responsável nomeado dentro da organização.
Um pacote completo de instruções costuma conter:
- A declaração de papel, escrita como o trabalho que o agente faz e o trabalho que ele não faz.
- Regras de escalonamento, indicando a pessoa ou a fila que recebe cada tipo de exceção e o prazo esperado de resposta.
- Regras de idioma e tom para cada canal, incluindo português ou inglês quando ambos forem usados.
- Descrições das ferramentas, com os casos em que a ferramenta não deve ser chamada.
- Um número de versão, a data da última alteração e o nome de quem aprovou.
Não aceite instruções que existam apenas dentro do painel de um fornecedor ou em uma conversa compartilhada. Esses textos podem ser editados sem registro e podem desaparecer quando a conta for encerrada. Verifique também se o agente trata texto vindo de e-mails, documentos ou páginas da web como instrução. Conteúdo não confiável pode tentar sobrepor as regras do agente, por isso a fronteira entre instrução e dado precisa estar escrita e ser imposta pelo sistema, não deixada apenas ao prompt.
Exportações de memória e suas fontes
Memória é o que o agente consegue recuperar ao responder: notas de clientes, regras de produto, documentos de política, decisões passadas e tarefas abertas. Na maioria dos agentes empresariais, a memória não é um único banco de dados. É uma combinação de fatos armazenados e documentos que o agente recupera no momento da resposta, um padrão geralmente chamado de geração aumentada por recuperação, descrito em termos simples pela AWS. Essa estrutura importa na entrega, porque a exportação precisa incluir tanto o conteúdo quanto o mapa de onde cada parte veio.
Uma exportação de memória que é apenas um despejo bruto é difícil de auditar. Peça:
- Os documentos de origem, ou ponteiros estáveis para eles, em um formato que sua empresa consiga ler sem software especial.
- O índice ou o repositório de memória em forma exportável, com um documento curto que descreva a estrutura.
- Um registro do que foi incluído, alterado ou apagado, com datas e a pessoa ou processo responsável.
- Uma regra para expirar ou corrigir informações desatualizadas.
- Marcações em qualquer item que contenha dados pessoais, para que as obrigações de privacidade acompanhem o arquivo.
Peça ao fornecedor que demonstre a exportação escolhendo cinco itens ao acaso e rastreando cada um até a fonte. Se um rastreamento falhar, a memória ainda não pertence à sua empresa, mesmo que tenha sido tecnicamente entregue.
Mapa de permissões e inventário de ferramentas
O mapa de permissões responde a uma pergunta que todo líder de operações acaba fazendo: o que este agente pode acessar e quem aprovou isso? Cada ferramenta, conta e escopo de dados que o agente usa deve aparecer no mapa com a identidade sob a qual ele opera e as ações que pode executar. Orientações padrão de autorização recomendam negar acesso por padrão e conceder apenas o que cada tarefa exige. O mapa é o lugar onde esse princípio vira algo que você consegue verificar.
Para cada entrada, registre:
- O sistema, a conta ou a API que o agente acessa, e a identidade que usa para se conectar.
- As ações permitidas, separadas em leitura, rascunho e escrita.
- O limite de aprovação, ou seja, quais ações precisam de uma pessoa nomeada para confirmá-las antes de executar.
- O responsável que pode conceder, alterar ou revogar o acesso.
- A data da última revisão e o resultado dela.
Compare o mapa com as configurações reais das contas antes de aceitá-lo. Uma permissão de escrita criada para um teste e nunca removida é um dos achados mais comuns em uma primeira revisão, e é fácil de passar despercebida quando o documento e o sistema são mantidos separadamente. Para o processo recorrente, veja como revisar permissões dos agentes de IA a cada trimestre.
Runbooks, avaliações e cópias de segurança
Um runbook é o documento que uma pessoa segue quando algo dá errado ou quando uma ação de rotina é necessária. Ele deve explicar como iniciar e parar o agente, como colocá-lo em um modo reduzido em que apenas rascunha respostas, quem contatar durante um incidente, como reverter uma alteração de prompt ou de permissão e onde os registros são guardados. Escreva-o para um operador competente que nunca viu o agente, porque essa provavelmente será a pessoa que vai lê-lo.
Registros tornam o runbook utilizável. Os conceitos de rastros, métricas e logs, apresentados na introdução de observabilidade da OpenTelemetry, valem para agentes tanto quanto para qualquer outro serviço de software. Peça que cada ação do agente seja registrada com data e hora, a ferramenta chamada, o resultado da aprovação e a versão das instruções em vigor. Sem essa trilha, ninguém consegue explicar uma decisão ruim depois que ela acontece.
Os registros de avaliação mostram se o agente atinge seu critério de sucesso. Entregue os casos de teste, os resultados esperados, o resultado de cada execução e a versão testada em cada data. Um conjunto pequeno e fixo de casos que sua equipe entende vale mais do que um benchmark extenso que ninguém consegue ler.
Por fim, peça uma cópia de segurança das instruções, da memória e da configuração, junto com uma restauração registrada em um ambiente de teste. Uma cópia que nunca foi restaurada é apenas uma suposição.
Cenário ilustrativo e checklist de entrega
Cenário ilustrativo: um distribuidor regional entrega um agente que responde perguntas de contas comerciais para a equipe de vendas. No encerramento, a equipe recebe o arquivo de instruções, uma exportação de memória que liga cada resumo de política ao documento de origem, um mapa de permissões com acesso somente leitura ao sistema de pedidos e acesso apenas de rascunho à fila de e-mails de saída, e um runbook que explica como colocar o agente em modo de rascunho. Depois, o gerente de contas que entendia o agente deixa a empresa. Como os arquivos estão completos, o líder de operações pausa o agente, confere o mapa de permissões, encontra uma permissão de escrita antiga deixada por um teste e a remove no mesmo dia.
Antes de aceitar qualquer entrega, confirme:
- Cada arquivo tem um responsável nomeado dentro da sua empresa.
- As instruções estão guardadas em um local que você controla, com histórico de versões.
- Uma amostra de itens de memória rastreia até um documento de origem.
- O mapa de permissões coincide com as configurações reais das contas.
- O conjunto de avaliação está salvo, com resultados para a versão atual.
- Uma restauração foi feita pelo menos uma vez em ambiente de teste.
- Alguém que não construiu o agente leu o runbook e considerou suficiente.
Como a Be Human mantém a entrega atualizada após o lançamento
A Be Human projeta, implanta e opera infraestrutura de IA personalizada, e a entrega faz parte desse trabalho, não é apenas um documento de encerramento. Na operação gerenciada, edições de prompt, mudanças de permissão e atualizações de memória são registradas como solicitações que informam o motivo, o aprovador e o efeito esperado, como descrito em como solicitar e aprovar mudanças em um agente de IA gerenciado. Monitoramento e avaliações recorrentes mostram se o agente ainda atinge seu critério de sucesso, e revisões de permissão confirmam que o mapa continua descrevendo a realidade. A empresa mantém a propriedade dos arquivos o tempo todo, de modo que a entrega continua sendo um estado atual, e não uma única transferência. Se você não tem certeza de qual tarefa deve ser entregue primeiro a um agente, o diagnóstico de IA da Be Human pode ajudar a encontrá-la.
Perguntas frequentes
Precisamos do código-fonte do fornecedor para ser donos do agente? Nem sempre, mas você precisa de todos os elementos que moldam o comportamento do agente em forma legível. Isso significa as instruções, as descrições de ferramentas, a exportação de memória, o mapa de permissões e as configurações. O código-fonte importa mais se você pode mover o agente para outra plataforma, então levante a questão enquanto a escolha da plataforma ainda estiver aberta.
Quem deve ter as contas de administrador depois da entrega? Pessoas nomeadas dentro da sua empresa devem ter acesso de administrador, e pelo menos duas delas devem conseguir agir em uma emergência. Qualquer acesso mantido pelo fornecedor deve ter prazo, ser registrado e ser removido quando o escopo do trabalho mudar. Revise essas contas como parte do mapa de permissões, não como uma tarefa à parte.
Podemos pedir a memória em um formato que nossas próprias ferramentas leiam? Sim, e você deve especificar esse formato antes de o trabalho começar. Peça formatos abertos e documentados, como texto simples, planilhas ou arquivos de documento padrão, junto com uma descrição curta de como os registros se relacionam entre si. Uma exportação que só a plataforma original consegue ler é sinal de dependência.
Com que frequência os arquivos da entrega devem ser atualizados? Atualize-os sempre que instruções, permissões ou memória mudarem, e revise o conjunto completo em um calendário fixo. Os arquivos só são úteis enquanto correspondem ao agente em produção, então um documento desatualizado deve ser tratado como falha a corrigir, não como detalhe menor. Atribua essa revisão a uma pessoa nomeada para que não dependa da memória de ninguém.
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.


