O documento mais barato de um projeto de agente de IA é também o que mais decide o resultado dele. É o escopo, uma ou duas páginas escritas antes de qualquer contratação. Projeto que dá errado quase sempre deu errado aqui, meses antes de alguém perceber.
Nós citamos escopo estreito em praticamente todo artigo desta série, e chegou a hora de ensinar a escrever um. A parte que surpreende quem nunca fez é que a seção mais importante não é a lista do que o agente faz. É a lista do que ele não faz, escrita com a mesma seriedade.
Este guia mostra as seis seções do documento, um exemplo preenchido para copiar, e o teste que diz se o seu escopo está pronto ou está bonito. Você precisa de duas horas e do histórico do processo que o agente vai assumir. Não precisa de fornecedor ainda, e é justamente esse o ponto. Escopo se escreve antes da proposta, para julgar a proposta.
O que é o escopo de um agente?
Escopo de agente é a fronteira escrita do que o sistema decide sozinho. Ele responde quatro perguntas sem ambiguidade. O que o agente faz, o que ele não faz, o que ele enxerga e o que acontece quando o assunto sai da fronteira.
Não confunda com especificação técnica. Escopo é documento de negócio, escrito por quem conhece a operação, em linguagem que o dono, o time e o fornecedor leem igual. A técnica vem depois, para servir a ele.
As seis seções do documento
- A tarefa do agente, escrita em uma frase que qualquer pessoa da empresa entende.
- A lista explícita do que ele não faz, mesmo que pareça óbvio.
- As fontes que ele consulta e os campos que enxerga em cada uma.
- As ações que ele executa sozinho e as que exigem aprovação humana.
- O transbordo, quando passa para uma pessoa, para quem e levando o quê.
- O dono do agente na empresa e a data da próxima revisão do escopo.
Um exemplo ajuda a calibrar o tamanho. Para um agente de consulta de pedido, o documento inteiro cabe em página e meia. Tarefa em duas linhas, oito itens de não faz, três fontes com os campos nomeados, duas ações livres e três preparadas, quatro gatilhos de transbordo, um nome e uma data. Escopo maior que isso costuma ser dois projetos grampeados.
Seção 1. A tarefa em uma frase
Uma frase, com verbo concreto e objeto específico. “Responder pergunta de prazo, status e segunda via para clientes ativos pelo WhatsApp.” Se a frase precisa de “e também” duas vezes, são dois agentes, não um.
A frase serve de juiz para o resto do documento. Toda funcionalidade proposta depois se pergunta contra ela, isso serve à tarefa ou é outro projeto disfarçado.
Seção 2. A lista do que ele não faz
É a seção que separa escopo de verdade de material de venda. Liste o que o agente não responde, não decide e não promete, incluindo o que parece óbvio. Não negocia desconto. Não confirma pedido sem pagamento. Não fala de assunto jurídico. Não responde sobre concorrente. Não altera cadastro.
Essa lista tem dois leitores. O fornecedor, que vai precificar o projeto certo em vez do projeto imaginado. E o futuro, porque daqui a seis meses alguém vai pedir para o agente fazer mais uma coisinha, e a lista é o que transforma esse pedido em decisão consciente em vez de acúmulo silencioso.
Seção 3. O que ele enxerga
Nomeie cada fonte e, dentro dela, os campos. Não escreva “acessa o ERP”. Escreva “consulta no ERP os campos status do pedido, data prevista e transportadora, dos pedidos do próprio cliente”. A diferença entre as duas frases é a diferença entre permissão mínima e vazamento esperando ocasião.
Escreva também o espelho, o que ele não enxerga mesmo estando na mesma tabela. Margem, custo, anotação interna. Como mostramos na série, permissão larga é a origem da maior parte dos incidentes com agente, e essa seção é onde ela se evita no papel.
Seção 4. O que ele executa sozinho
Separe em duas colunas. O que ele faz sem ninguém aprovar, responder consulta, enviar segunda via, registrar a conversa. E o que ele prepara mas não dispara, cancelamento, estorno, alteração de dado cadastral, qualquer coisa com dinheiro ou com vínculo.
A regra prática que usamos é o teste do arrependimento. Ação que não dá para desfazer em um clique não entra na primeira coluna no primeiro trimestre. Depois que o agente prova estabilidade, a fronteira pode andar, com decisão registrada.
Seção 5. O transbordo
Defina os gatilhos que tiram a conversa do agente. Assunto fora da lista, cliente pedindo humano, sinal de irritação, terceira tentativa sem resolver. Defina o destino, qual fila, qual pessoa, em qual horário. E defina a bagagem, o histórico completo vai junto, para o cliente não recomeçar.
Transbordo mal escrito é onde agente bom vira experiência ruim. O cliente não se irrita porque o robô não sabia, se irrita porque ficou preso com ele.
Seção 6. O dono e a revisão
Um nome, não um departamento. Quem responde pelo agente, recebe os relatórios de conversa e decide ajuste. E uma data de revisão do escopo, trimestral no primeiro ano, porque a operação muda e o documento precisa mudar junto.
Agente sem dono é o padrão de mercado, e é por isso que tanto agente degrada em silêncio até alguém desligar. Dono nomeado no escopo evita a degradação e evita a órfã digital na fiscalização.
Vale fechar o documento com uma linha de contexto de negócio, por que esse agente existe e qual número ele deve mover. Tempo de resposta, custo por conversa, prazo de proposta. É a linha que conecta o escopo à conta de retorno e evita o projeto que funciona perfeitamente sem servir para nada.
O teste de qualidade do escopo
Escopo pronto passa em dois testes, e os dois cabem em meia hora.
O teste da mensagem. Pegue dez mensagens reais do histórico do processo, incluindo duas esquisitas. Para cada uma, pergunte a alguém que não participou da escrita, “pelo documento, essa mensagem é do agente ou de pessoa?”. Se a resposta sair rápida e igual para leitores diferentes, a fronteira está clara. Se der debate, a seção 2 está rasa.
O teste da proposta. Envie o escopo para dois fornecedores e compare as propostas. Escopo bom produz propostas comparáveis, do mesmo tamanho de projeto. Propostas de tamanhos muito diferentes denunciam que cada um leu uma fronteira, e o documento precisa fechar antes de qualquer assinatura.
| Seção | Pergunta que ela responde | Sinal de que está rasa |
|---|---|---|
| Tarefa | O que ele faz? | Frase com dois “e também” |
| Não faz | O que fica de fora? | Menos de cinco itens na lista |
| Enxerga | Que dado ele lê? | Nome de sistema sem nome de campo |
| Executa | O que dispara sozinho? | Ação irreversível na coluna do sozinho |
| Transbordo | Quando sai dele? | Gatilho sem destino e sem bagagem |
| Dono | Quem responde? | Nome de departamento no lugar de pessoa |
Erros comuns
- Deixar o fornecedor escrever o escopo. Ele vai escrever o que sabe entregar, não o que a sua operação precisa. Fornecedor bom melhora o documento, mas a primeira versão é sua, porque a fronteira é sua.
- Escopo grande para render mais no mesmo projeto. Agente que faz cinco coisas na primeira versão erra nas cinco e ninguém descobre qual regra quebrou. Escopo curto entrega em semanas e cresce por decisão, como fizemos no desenho de atendimento repetitivo.
- Pular a lista do não faz por parecer negativa. É a seção que protege o preço, o prazo e o cliente. Sem ela, todo mal entendido do projeto vira aditivo pago por você.
- Escrever acesso por sistema em vez de por campo. “Acessa o CRM” autoriza tudo que está no CRM. Vazamento futuro começa nessa frase preguiçosa.
- Tratar o documento como contrato de gaveta. Escopo sem data de revisão envelhece e o agente real se descola do papel. A revisão trimestral leva vinte minutos e mantém os dois iguais.
- Confundir escopo com teste. O escopo diz onde a fronteira fica. Provar que o agente respeita a fronteira é outra etapa, e o roteiro dela está em como testar um agente de IA antes de colocar em produção.
Perguntas frequentes
Quanto tempo leva para escrever um escopo assim?
Duas horas para a primeira versão, com o histórico do processo na mão, e mais uma rodada curta com o time da operação para fechar a lista do não faz. É o melhor retorno por hora de todo o projeto.
Preciso de escopo mesmo comprando ferramenta pronta?
Precisa, e talvez mais. Na ferramenta pronta a tentação de ligar tudo que ela oferece é grande, e o escopo é o que diz quais funções ficam desligadas. A fronteira continua sendo sua, mesmo quando o software é de prateleira.
Quem da empresa deve escrever?
Quem conhece o processo por dentro, com o dono do agente definido na seção 6 segurando a caneta. Tecnologia revisa a viabilidade depois. Documento escrito só pela tecnologia descreve o sistema, não a operação.
O escopo pode mudar depois que o agente está no ar?
Pode e deve, na revisão marcada e com registro do que mudou. O que não pode é mudar por acúmulo, um pedido aqui e outro ali, sem ninguém redesenhar a fronteira. É assim que agente de escopo curto vira agente genérico sem que ninguém tenha decidido isso.
Próximo passo
Abra um documento em branco e escreva a seção 1 e a seção 2 do agente que você tem, ou do que pretende contratar. Vinte minutos. Se a lista do não faz travar em três itens, você acabou de descobrir que a fronteira ainda mora na sua cabeça, e é mais barato descobrir isso hoje do que na fatura do aditivo.
Se quiser as seis seções revisadas por quem escreve escopo toda semana, fale com a gente no WhatsApp, ou veja como isso entra no diagnóstico da metodologia CORE.
4 comentários