Entrada de documentos primeiro

Terça-feira na Vinco Instalações: orçamentos, notas de material, um contrato digitalizado torto e recibos fotografados no celular, cada um lido por uma pessoa e digitado à mão em dois lugares. O workflow mais caro do mapa custa 9,5 horas por semana assim. Este capítulo constrói o agente que faz o documento entrar sozinho, validado contra o schema antes da escrita.

Cena inventada para a didática deste curso. A consolidação já terminou na Vinco: as telas existem, o banco existe, as 23 entidades estão amarradas por 61 chaves estrangeiras e o time já trabalha dentro do sistema. A terça-feira continua idêntica à de um ano atrás porque o documento continua entrando pela porta do humano, que abre, lê, decide a que obra pertence e digita duas vezes.

Repare no que a cena da Vinco tem de específico. O problema não é falta de inteligência artificial na empresa. Rita já tinha experimentado um assistente de IA acoplado ao e-mail que resumia anexos muito bem. O resumo era bom e não servia para nada, porque terminava dentro da conversa: ninguém podia perguntar depois quanto a Vinco gastou em eletrocalha no trimestre, e nenhum resumo virou linha de tabela.

Esse é o ponto exato em que a experiência prévia de quem estuda quebra. Quem já usou IA em documento conhece a sensação de acerto imediato: joga o PDF, pede o resumo, recebe um texto plausível. O gesto é gratificante e é um beco. O paper da Boom Automations nomeia a causa numa frase que já apareceu no capítulo 1, "AI can only retrieve what one tool holds": um recurso de IA colado por cima de uma ferramenta raciocina sobre a fração da empresa que aquela ferramenta guarda, e o resultado dele morre onde nasceu. A diferença entre aquele assistente e o agente A está no destino da saída. Um devolve texto para um humano ler; o outro devolve registro estruturado para o banco, pelo caminho de escrita único que você documentou no passo 03.

As estações 01 e 05 são as que caem primeiro quando o prazo aprecia. Guardar o original antes de ler parece burocracia até a primeira vez em que a extração erra o valor de uma nota e alguém precisa conferir contra o documento de origem. Sem o arquivo preservado e amarrado ao registro, a conferência vira arqueologia na caixa de entrada de outra pessoa.

Agora o exemplo resolvido do começo ao fim, ainda na cena inventada da Vinco. Rita escolhe um tipo de documento só para a primeira semana, e escolhe o mais caro do mapa: a medição de obra. É a decisão certa pela mesma lógica que ordenou a migração no capítulo 7, ranquear pelas horas cronometradas, e aqui ela tem um bônus. O documento de medição é o que alimenta a digitação dupla mais cara do mapa da Vinco, o número que saía da planilha de medição para o Monday e voltava para a planilha de faturamento.

O primeiro artefato é uma tabela de uma página, feita com Damião do lado, ligando cada campo do documento ao campo da tabela de destino e à regra que decide se aquele valor pode ser gravado. Quem escreve essa tabela antes de escrever o extrator descobre, ali mesmo, campos cuja origem ninguém sabia explicar. Quem escreve o extrator primeiro descobre a mesma coisa semanas depois, com dado sujo no banco.

Com o mapa de campos pronto, a construção é curta e a ordem é a do fluxo. Caixa de captura e guarda do original primeiro, porque é a parte que não depende de modelo nenhum. Extração depois, medida contra um lote de documentos reais que você separou antes de começar. Validação em seguida, com a regra da soma antes das outras porque é a que reprova mais rápido. Escrita e log por último, e os dois no mesmo movimento, porque escrita sem log é a versão do agente que ninguém consegue defender numa reunião de fechamento.

O que muda na terça-feira de Rita quando essa peça entra: os anexos continuam chegando, e a fila que ela abre de manhã passa a ser de exceções para decidir. O volume de decisão humana cai para os documentos que a validação reprovou, cada um com o motivo escrito, e o resto já está no banco quando ela abre o notebook. É por isso que o autor escreve que todo mundo sente na hora: essa é a única peça da parte 4 cujo efeito aparece na primeira manhã, sem ninguém precisar aprender gesto novo.

Os erros que aparecem nessa semana são poucos e repetidos. Vale reconhecer cada um pelo sintoma, porque nenhum deles se anuncia como erro de arquitetura: todos chegam disfarçados de detalhe de prazo.

A Boom Automations relata, em material publicado em 17 de agosto de 2026, um cliente de armazenagem com 450 projetos ativos espalhados por Airtable, Excel, Dropbox e Adobe, e cinco gerentes de projeto fazendo o mesmo workflow de cinco jeitos. O sistema entregue teria 130.000 linhas de código, 41 telas, 50 tabelas de banco e 28 automações de fundo, com a IA lendo todo recibo, orçamento e fatura que entra. Para este capítulo, o dado relevante é o mais modesto de todos: a entrada de documentos sozinha encerrou anos de um time redigitando dado para fora do Adobe.

A palavra decisiva ali é "anos". O desperdício não era desconhecido, era tolerado, porque cada digitação individual custava minutos e ninguém somava os minutos. Esse é o padrão que se transporta para a sua operação. A magnitude, não: ela depende do volume de documento que entra pela sua porta, e o instrumento de medida é o mesmo do capítulo 3, horas cronometradas antes e horas cronometradas depois.

O modelo abaixo é o artefato que abre a semana. Ele é curto de propósito: uma página que qualquer pessoa da operação avalia numa leitura curta, e que já contém as decisões que costumam ser tomadas por omissão no meio da construção.

Volte para a terça-feira de Rita e note o que efetivamente mudou. A caixa de entrada continua igual, os anexos continuam chegando, e o time da Vinco não aprendeu gesto novo nenhum. O que mudou é que o dado da medição entra uma vez, na tabela onde o sistema é a fonte da verdade, com o PDF original amarrado ao registro e uma linha de log que diz de onde cada valor veio. A digitação dupla mais cara do mapa deixa de existir por falta de função. E o agente de respostas operacionais, que Rita queria construir primeiro, fica muito melhor agora, porque ele passa a consultar um banco que recebe documento em vez de um banco que espera alguém digitar.

Na segunda-feira, o movimento é este. Abra o mapa do passo 01, escolha o workflow mais caro que recebe documento de fora e preencha a especificação de uma página com a pessoa que hoje digita aquele documento. Separe um lote de documentos reais do último trimestre, com os piores incluídos, na mesma manhã. Até o fim do dia você tem os dois artefatos que a semana exige: a especificação preenchida e o lote de conferência. O critério de pronto da semana é a escrita real acontecendo no caminho autorizado, com log, e a data do corte da digitação manual marcada no calendário.