A Patrícia pediu ao assistente de e-mail para "limpar o que é spam". Ele apagou 112 e-mails e esvaziou a lixeira. Horas depois, confirmou dados de pagamento a um suposto fornecedor; no dia seguinte, mandou a tabela de preços para 640 contatos. Esse poder veio no padrão da ferramenta. Nesta aula você escreve o contrato que limita cada ferramenta ao mínimo.
1Separar ler, preparar, escrever e o que nunca sai sem aprovação
2Escopo e limite: quais registros, campos, destinos e valores
3Credencial guardada fora do texto, com identidade própria do agente
4Repetir sem duplicar, erro com destino e registro de cada ação
Objetivo: dar a cada ferramenta do agente o acesso mínimo: leitura ou escrita, escopo, limite, credencial fora do prompt, registro e quem aprovou.
01 · A escada do acesso
Cada operação de uma ferramenta fica num degrau. Comece de baixo e suba só com motivo escrito. Clique em cada degrau.
Clique em cada bloco do diagrama para ver o que ele faz.
Módulo 5 do método Gestoria (INEMA): leitura × escrita e escopo mínimo. Os degraus combinam com as cores da alçada do G3 (verde, amarelo, vermelho). Horizonte: empresa fictícia de estudo.
02 · O contrato de uma ferramenta
Quatro regras que corrigem o assistente de e-mail da Horizonte (F9 no laboratório). Você decide; a TI configura e confirma.
1. Liste o que ela consegue
Peça à TI, ou ao fornecedor, a lista de todas as operações que a ferramenta permite. O risco está no que ela consegue fazer, não no que você imaginou que ela faria.
Para cada operação, escolha o degrau. O padrão de fábrica costuma ser o mais aberto, porque assim a ferramenta "funciona de primeira".
F9 no laboratórioEscopos: ler, enviar, apagar, mover e ler contatos. Aprovação automática para ler, enviar, responder, apagar e esvaziar a lixeira. Aprovação humana: desligada. Aprovado por: "pode ligar", do Carlos, por WhatsApp.
2. Escopo e limite
Escreva o alcance de cada operação: quais registros (só o cliente da conversa), quais campos (sem CPF), quais destinos (só quem escreveu), quais valores (até R$ 5 mil).
Peça que o limite fique na ferramenta, não só nas instruções. A frase "nunca dê mais de 5%" no texto do agente é um pedido; o teto configurado no app de pedidos é uma trava.
Na Horizontecriar_pedido: cliente cadastrado, preço da tabela vigente, desconto até 5%, valor até R$ 5 mil. Acima disso a ferramenta só aceita rascunho, que espera a Patrícia.
3. Credencial fora do texto
A senha ou chave de acesso fica guardada no servidor ou num cofre de senhas, nunca nas instruções do agente, numa planilha ou no navegador. Tudo o que vai para o navegador é público, como mostra a chave exposta no app de pedidos do laboratório (F1).
O agente usa um acesso com nome próprio, não a senha da Patrícia: assim o registro diz quem fez, e dá para cortar o agente sem cortar a pessoa.
Na HorizonteA caixa comercial@ ganha um acesso "hora-email", só de leitura, guardado pelo Rafael no cofre. A chave antiga, que circulou num arquivo de configuração, é trocada.
4. Repetir sem duplicar
Se a conexão cai e o agente tenta de novo, o pedido não pode sair duas vezes. Peça à TI uma marca única por operação (o número da conversa e a versão do pedido); repetiu a marca, a ferramenta recusa.
Defina quantas tentativas, quanto tempo de espera, para quem vai o erro com o contexto, e o registro de cada ação. Conector muda: em 28/07/2026 foi noticiada uma versão nova do MCP que quebra servidores antigos (fonte secundária, não confirmada; confira). O contrato no papel é o que você usa para refazer e testar.
Na Horizontecriar_pedido: no máximo 2 tentativas, 30 segundos de espera; falhou, o caso vai para a Juliana com a conversa e o rascunho. Toda chamada fica registrada com conversa, valor e versão.
03 · Modelo para copiar: contrato de ferramenta
Um contrato por ferramenta, numa página. A aba ao lado mostra os dois contratos da Hora e o F9 corrigido.
Contrato de ferramenta
CONTRATO DE FERRAMENTA · <nome> · agente <...> · versão <...> · data <...>
Dono (negócio): <nome> · Configura e confirma (TI): <nome>
O QUE ELA CONSEGUE FAZER (lista da TI/fornecedor, completa):
| Operação | Efeito fora da empresa? | Degrau (ler / rascunho / escrever com limite / fora) |
|---|---|---|
| <...> | sim/não | <...> |
ESCOPO: registros <...> · campos permitidos <...> · campos proibidos <...>
DESTINOS PERMITIDOS: <...>
LIMITES NA FERRAMENTA (não só no texto): <valor, quantidade, destinatários>
APROVAÇÃO: <quem> · sobre o conteúdo exato · prazo <...>
CREDENCIAL: acesso próprio do agente "<nome-do-acesso>" guardado em <cofre/servidor>
(nunca no prompt, na planilha ou no navegador) · troca em <periodicidade>
REPETIÇÃO: marca única = <...> · tentativas <n> · espera <s>
ERRO: vai para <nome> com <conversa, rascunho, motivo>
REGISTRO: <o que fica gravado> · guardado por <prazo>
APROVADO POR: <nome, data, neste documento> (mensagem de "pode ligar" não vale)
Prompt · o que a ferramenta faz que o contrato não diz
Você é revisor de segurança de processos. Abaixo estão a lista de
operações que uma ferramenta permite (da documentação ou da
configuração) e o contrato que limita o uso dela por um agente de IA.
Não configure nada: aponte.
1. Que operação a ferramenta permite e o contrato não menciona?
2. Algo que não se desfaz (apagar, pagar, enviar para muitos) ficou
ao alcance do agente?
3. Algum limite existe só no texto e não na ferramenta?
4. A credencial aparece em algum lugar visível?
5. O que acontece se a mesma ação for repetida por engano?
Operações / configuração:
"""<cole>"""
Contrato:
"""<cole>"""
Simulação: exemplo ilustrativo
Hora · contratos v1 · Horizonte, empresa fictícia de estudo · dona: Patrícia · TI: Rafael
consultar_cliente · ler · só o cliente do telefone da conversa · campos: razão social, CNPJ, endereço de entrega cadastrado, condição de pagamento · proibido: CPF, outros clientes · registro de cada consulta.
criar_pedido · escrever com limite · cliente cadastrado, preço da tabela vigente, desconto até 5%, valor até R$ 5 mil (trava no app) · acima: só rascunho, aprovação da Patrícia em 2 h úteis · marca única: conversa + versão do pedido · 2 tentativas · erro para a Juliana · acesso "hora-pedidos" no cofre do Rafael · aprovado pelo Carlos neste documento.
Ficam: ler a caixa comercial@ e ler contatos (degrau ler).
Viram rascunho: responder e enviar. A Patrícia aprova cada envio; um destinatário por vez; nada de lista inteira.
Saem do agente: apagar e-mail, esvaziar lixeira, mover em massa. Spam se marca; quem apaga é uma pessoa.
Aprovação humana: ligada. Credencial: chave trocada, acesso próprio "hora-email" no cofre.
O que já aconteceu: o e-mail de troca de conta bancária vira incidente (o financeiro confirma por telefone com o fornecedor); a lixeira esvaziada é pedida ao provedor de e-mail, se ainda der; os 640 contatos recebem correção se a tabela estava errada.
Aprovado por: Carlos, no contrato, depois de ler. O "pode ligar" por WhatsApp não vale como aprovação.
04 · Prática
Os contratos da Hora e a correção do F9 para treinar; uma ferramenta sua para valer.
1 · Dois contratos e o F9
35 min
Abra a configuração da Hora e escreva os contratos de consultar_cliente e criar_pedido com o modelo. Depois abra o assistente de e-mail do laboratório, leia a configuração e o registro das últimas ações, e escreva o contrato corrigido: o que fica, o que vira rascunho, o que sai do agente, e o que fazer com as quatro ações já registradas.
Pronto quando: há 3 contratos (2 da Hora e 1 do e-mail), cada operação com degrau, nenhum apagar ou esvaziar ao alcance do agente, limite em número em toda operação com valor ou destinatários, credencial com acesso próprio e lugar de guarda, marca contra repetição no criar_pedido, e uma providência para cada uma das 4 ações registradas.
2 · Uma ferramenta sua
40 min
Escolha a ferramenta mais poderosa que um agente ou automação usa no seu processo (e-mail, ERP, CRM, planilha compartilhada). Peça à TI ou ao fornecedor a lista completa de operações. Escreva o contrato e rode o prompt de revisão. Entregue à TI e peça a confirmação por escrito das travas.
Pronto quando: o contrato tem a lista completa de operações com degrau, escopo, limites que existem na ferramenta, credencial fora do texto, destino do erro e registro, e você tem a confirmação escrita da TI (ou a lista do que ainda falta configurar, com prazo).
5 perguntas. A explicação aparece depois da sua tentativa.
Pergunta 1 de 5
O assistente de e-mail foi ligado com aprovação automática para apagar e esvaziar a lixeira. Quem decidiu isso?
Correto
Aprovação vale para um conteúdo exato. "Pode ligar" não dizia nada sobre apagar ou enviar. O contrato existe para que alguém decida, operação por operação, e assine.
Não é essa
Aprovação vale para um conteúdo exato. "Pode ligar" não dizia nada sobre apagar ou enviar. O contrato existe para que alguém decida, operação por operação, e assine.Rever: O contrato de uma ferramenta
Pergunta 2 de 5
As instruções da Hora dizem "nunca dê mais de 5% de desconto". Isso basta?
Correto
Instrução é pedido; trava na ferramenta é limite. A ordem escondida do F6 mostra que um texto colado pelo cliente pode passar por cima do que está escrito no agente.
Não é essa
Instrução é pedido; trava na ferramenta é limite. A ordem escondida do F6 mostra que um texto colado pelo cliente pode passar por cima do que está escrito no agente.Rever: A escada do acesso
Pergunta 3 de 5
Onde fica a senha que o agente usa para acessar o app de pedidos?
Correto
O que está nas instruções, numa planilha ou no navegador pode vazar. Acesso próprio também faz o registro dizer "foi o agente" e permite cortá-lo sem afetar a Patrícia.
Não é essa
O que está nas instruções, numa planilha ou no navegador pode vazar. Acesso próprio também faz o registro dizer "foi o agente" e permite cortá-lo sem afetar a Patrícia.Rever: O contrato de uma ferramenta
Pergunta 4 de 5
A conexão caiu no meio de um pedido e o agente tentou de novo. O que o contrato precisa garantir?
Correto
Repetir é normal; duplicar é estrago. A marca única (conversa + versão do pedido) faz a ferramenta recusar o que já fez, e o erro vai para uma pessoa com o contexto.
Não é essa
Repetir é normal; duplicar é estrago. A marca única (conversa + versão do pedido) faz a ferramenta recusar o que já fez, e o erro vai para uma pessoa com o contexto.Rever: O contrato de uma ferramenta
Pergunta 5 de 5
Foi noticiada uma versão nova do conector que quebra os antigos. Por que o contrato no papel ajuda?
Correto
A notícia sobre o MCP vem de fonte secundária e precisa ser conferida, mas o ponto vale para qualquer conector: ele muda, e o contrato é a referência para conferir que nada passou a ter mais acesso do que devia.
Não é essa
A notícia sobre o MCP vem de fonte secundária e precisa ser conferida, mas o ponto vale para qualquer conector: ele muda, e o contrato é a referência para conferir que nada passou a ter mais acesso do que devia.Rever: O contrato de uma ferramenta
Teste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
06 · Resumo
Escada do acessoLer, rascunho, escrever com limite. Apagar, pagar e enviar em massa ficam fora.
Lista completaO risco está no que a ferramenta consegue, não no que você pretende.
Trava fora do textoLimite na ferramenta, credencial no cofre, acesso com nome do agente.
Repetir, errar, registrarMarca única, tentativas, destino do erro e registro de cada ação.
