O seu agente de IA não automatiza um fluxo de trabalho que nunca viu
O conhecimento dos fluxos de trabalho ficou sempre concentrado em três pessoas seniores. Em 2026 esse estrangulamento passa a ser um problema de automação: um agente de IA não lê o que está nas cabeças das pessoas, lê rastos.
- Tickets de TI Tier-1
- −35%
- Tempo até primeira PR
- 1 semana
- Pontos de decisão por fluxo
- 3 a 7
- Fluxos sem registo escrito
- ~80%
A versão curta.
Cada fluxo de trabalho que a equipa corre hoje está na cabeça de alguém. A Filomena sabe a reconciliação. O Rui sabe o deploy. O André sabe a renovação. O sénior que sabe como uma coisa se faz sempre foi o estrangulamento para quem entra e para os clientes. Em 2026 esse estrangulamento passa a ser o estrangulamento da IA. Um agente não consegue ler o que está nas cabeças das pessoas. Consegue ler rastos gravados de como o fluxo correu numa terça-feira concreta. As empresas que gravaram os fluxos em 2025 são as que estão a pôr agentes a correr em 2026. As outras continuam em entrevistas a tentar arrancar o fluxo da cabeça do sénior.
O novo estrangulamento: os fluxos estão concentrados em três cabeças seniores
O conhecimento dos fluxos está concentrado em três cabeças seniores. Uma scale-up de 220 pessoas tinha o helpdesk de TI assente em três engenheiros que respondiam às mesmas vinte perguntas todas as segundas-feiras. As perguntas viviam na cabeça dos séniores, o wiki tinha screenshots de 2022, e a equipa continuava a contratar mais support engineers porque era a única forma conhecida de escalar. Depois a equipa gravou vinte guias em dois dias e o volume de tickets Tier-1 caiu 35% em oito semanas. O estrangulamento mudou de disponibilidade humana para cobertura de biblioteca.
A camada seguinte é o agente. Quando um fluxo está gravado, pode ser repetido por uma pessoa, resumido por um LLM, ou executado por um agente. O mesmo artefacto serve três públicos. A investigação do Nielsen Norman Group sobre porque é que os utilizadores fazem scan em vez de ler explica porque é que as pessoas precisam de guias curtos e estruturados. A mesma propriedade (estruturado, scaneável, rastreável) é o que um agente precisa para aprender o fluxo.
O problema em 2026 é que 80% dos fluxos numa equipa mid-market típica nunca foram gravados. Foram executados milhares de vezes pela Filomena, pelo Rui, pelo André. Foram descritos em páginas de Notion em que ninguém confia. Foram narrados em chamadas Talkdesk de onboarding que ninguém voltou a ver. Nenhum destes formatos produz um rasto que um agente saiba consumir.
Um staff engineer numa fintech B2B portuguesa encontrou exatamente este padrão quando substituiu um README de 2400 linhas por doze guias: o README descrevia o setup, os guias deixavam o rasto. Os engenheiros novos faziam a primeira PR numa semana em vez de três. Um agente que venha automatizar o setup do ambiente de desenvolvimento vai precisar dos mesmos rastos, não do README.
O que um agente de IA precisa mesmo para automatizar um fluxo
Um agente que automatiza um fluxo precisa de cinco entradas. Uma descrição não as entrega. Um guia gravado entrega.
| Entrada | O que é | Onde o guia gravado a fornece |
|---|---|---|
| Sequência de passos | A lista ordenada dos cliques e acções de teclado | A step list do Capture, pela ordem certa |
| Estado de ecrã esperado | O aspeto que o ecrã deve ter antes de cada passo | O screenshot com timestamp de cada passo |
| Pontos de decisão | Bifurcações onde é precisa avaliação do operador | A narração ao clique ("se o cliente está em zona UE, clicar aqui") |
| Tratamento de exceções | O que fazer quando um passo falha | Guias de troubleshooting ligados por modo de falha |
| Razão | Porquê este clique e não a alternativa | Voz convertida em texto de passo |
Uma SOP em Notion entrega a sequência e às vezes a razão. Falha o estado de ecrã, os pontos de decisão e as exceções. Um vídeo Loom entrega o estado de ecrã e a razão, mas obriga o agente a fazer OCR a cada frame e a transcrever o áudio para extrair tudo. A abordagem por Loom funciona, só que o custo de extração é alto o suficiente para quase ninguém investir nele.
Um guia gravado escrito para leitores humanos já tem as cinco entradas em forma estruturada. A documentação Claude Computer Use da Anthropic e o Model Context Protocol consomem ambos step lists estruturadas com prova de ecrã. O formato converte para qualquer um deles com transformação mínima. Um guia gravado é, na prática, o dado de treino para agentes mais barato que uma empresa pode produzir. O difícil é a gravação. A integração com o agente é a parte fácil.
Porque é que guias gravados batem SOPs e vídeos para treinar agentes
O formato que reduz o custo de extração do agente é o formato que automatiza mais depressa. Três formatos, três custos de extração.
SOP em Notion ou Confluence (custo de extração: alto). O agente recebe prosa. Tem de fazer parse da intenção, inferir a sequência, adivinhar pontos de decisão, postular o estado de ecrã. A maioria dos agentes que tenta automatizar a partir de prosa alucina os passos não descritos. As equipas que tentaram esta via em 2025 acabaram por reescrever a SOP num prompt estruturado, o que dá o mesmo trabalho de gravar o guia uma vez.
Loom ou screen recording (custo de extração: médio-alto). O agente tem de correr OCR em cada frame, transcrever o áudio e alinhar os dois fluxos. É tecnicamente possível. A investigação do Nielsen Norman Group sobre legibilidade, leitura e compreensão sublinha porque é que os humanos não consomem Loom como documentação. O mesmo problema de densidade torna o vídeo uma entrada ineficiente para agentes. O custo de processamento de um agente sobre vídeo também não é desprezável quando se passa para uma biblioteca de 50 guias.
Guia gravado (custo de extração: baixo). O agente recebe JSON estruturado: passos ordenados, screenshots com timestamp, razão narrada por passo, manipuladores de exceção ligados. Está próximo do que a investigação da Anthropic descreve como formato de entrada ideal para fluxos agent-readable. O agente corre contra o guia de forma determinística e treina-se de novo só num passo quando a interface muda.
A assimetria de custo compõe-se ao nível da biblioteca. Vinte SOPs em Notion são vinte projetos de conversão para agente. Vinte guias gravados são uma integração. As equipas que constroem a biblioteca no formato certo recebem a camada de agentes praticamente de graça. O mesmo pattern aparece nas comparações entre alternativas ao Scribe para equipas de operações: o que decide o resultado é o formato em que a documentação é guardada.
Como gravar para humanos e agentes ao mesmo tempo
O fluxo de gravação que produz um guia útil para um leitor humano é o mesmo que produz um rasto útil para um agente. Três acrescentos afinam-no para ambos os públicos.
1. Narrar o porquê em cada clique. "Clico Save" é um passo. "Clico Save antes de adicionar a integração para o fluxo não ficar órfão se a ligação fizer timeout" é um exemplo de treino. Tanto o colega novo a ler o guia como o agente a aprender o fluxo precisam do segundo. As três primeiras descrições de passo são o critério que a investigação do Nielsen Norman Group sobre o padrão de leitura em F mostra que os leitores usam para decidir se continuam. O mesmo se aplica ao agente que decide se segue o guia tal como está ou se passa para outro.
2. Ser explícito nos pontos de decisão. "Se o cliente está no plano UE, clicar Configurar RGPD. Caso contrário, saltar para o passo 7." É nos pontos de decisão que a maioria dos agentes falha quando automatiza a partir de prosa. Um guia gravado que nomeia a bifurcação e o critério converte-se diretamente em fluxo de controlo do agente. A maioria dos fluxos tem entre três e sete pontos de decisão. Encontrá-los a rever um Loom é caro. Encontrá-los num guia estruturado é uma pesquisa.
3. Documentar os modos de falha como irmãos. Cada falha conhecida ganha o seu pequeno guia de troubleshooting, ligado ao principal. Um staff engineer numa empresa B2B de observabilidade fez exatamente isto: cada modo de falha conhecido virou um guia curto, ligado a partir de uma única entrada do wiki de engenharia. Os engenheiros novos encontravam o modo de falha em segundos. O agente faz o mesmo: quando o caminho primário falha, percorre o guia de exceção ligado.
Estes três acrescentos custam, grosso modo, dois minutos por gravação. O retorno em tempo de integração de agente mede-se em dias. A extensão Chrome do Capture está construída em volta deste fluxo de gravação, e a mesma biblioteca que serve as pessoas hoje vai servir os agentes em 2026.
A biblioteca compõe-se: de documentação a infraestrutura de agentes
A biblioteca de TI com 20 guias que cortou os tickets Tier-1 em 35% não é só documentação. É um roteiro de automação. O mesmo se passa com o padrão de onboarding de cliente em doze minutos e com a biblioteca de SOPs SOC 2: quando o fluxo está gravado, o passo seguinte óbvio é automatizar os casos mais simples.
Três padrões desenrolam-se ao nível da biblioteca.
O agente fica com os casos simples. O guia de reset de MFA vira um agente de reset de MFA que trata de 80% dos casos sem supervisão. O guia de configuração de VPN vira um agente de setup de VPN para quem entra. As primeiras implantações de agente cobrem os fluxos onde os pontos de decisão são simples e os modos de falha estão bem documentados. Os casos difíceis ficam com pessoas e tornam-se o trabalho de documentação do ano seguinte.
A biblioteca cresce em incrementos amigáveis ao agente. Quando a equipa percebe o que um guia precisa para ser agent-readable (pontos de decisão nomeados, modos de falha ligados, narração explícita), os vinte guias seguintes já chegam nesse formato. A biblioteca compõe-se em utilidade, não só em contagem.
Os auditores chegam a seguir. As SOPs prontas para auditoria já exigem as mesmas propriedades que o agente precisa: execução com timestamp, prova nos pontos de decisão, tratamento de exceções. Os Trust Services Criteria do AICPA pedem prova de execução, não descrição de política. O método "gravar primeiro" satisfaz o auditor e o agente. Dois leitores, um artefacto. No contexto português, os fluxos documentados em equipas que respondem à CNPD ao abrigo da Lei n.º 58/2019, ou em scale-ups como a Sword Health e a Feedzai que já operam sob escrutínio SOC 2 e RGPD, são exatamente o tipo de artefacto que um agente pode repetir amanhã.
As empresas que documentaram em 2024-2025 são as que estão a pôr agentes a correr em 2026. As que adiaram a documentação partem do zero: têm de gravar os fluxos E construir os agentes, em sequência. A assimetria compõe-se. A documentação deixou de ser um projeto à parte. É o pré-requisito da próxima vaga de automação 2026-2027. O dossier completo sobre seis equipas está em o caso dos guias passo a passo.
Perguntas frequentes.
- Que plataformas de agentes de IA já consomem hoje guias de fluxo gravados?
O Claude Computer Use da Anthropic e qualquer agente construído sobre o Model Context Protocol consomem diretamente step lists estruturadas com prova de ecrã. Os Assistants e o Agents API da OpenAI consomem JSON semelhante. As frameworks de automação de browser (Playwright + LLM) consomem step lists em markdown. O padrão é sempre o mesmo: estruturado, ordenado, com timestamp, com pontos de decisão explícitos. É a forma que um guia gravado já tem.
- Vale a pena esperar que os agentes de IA amadureçam antes de gravar fluxos?
Não. A gravação paga-se já hoje (leitores humanos, menos tickets, onboarding mais rápido) e paga-se outra vez mais tarde (dado de treino para agentes). As equipas que começaram a gravar em 2024-2025 são as que têm a integração de agente mais profunda em 2026. Não há versão desta estratégia em que esperar ajude.
- E os fluxos que só a Filomena conhece?
Começar pelos mais explicados. O mesmo padrão dos leitores humanos: pegar no fluxo que a Filomena explica cinco vezes por semana, gravá-lo uma vez com ela a narrar, e vê-lo deixar de ser explicado. A disciplina de gravar empurra o saber tácito para uma forma que pessoas, agentes e auditores conseguem todos consumir. O guia para documentar o acolhimento de clientes percorre o método de gravação.
- O agente consegue tratar de um fluxo quando o guia está incompleto?
Às vezes. A maioria das implantações de agente em produção em 2026 escala para humanos em estados não reconhecidos ou em pontos de decisão não mapeados. A completude do guia determina a taxa de escalada. Nomear pontos de decisão e ligar modos de falha reduz a taxa de escalada em cerca de uma ordem de magnitude nas implantações observadas. O custo de gravação para acrescentar pontos de decisão explícitos é de dois minutos por guia. O custo de escalada evitado mede-se em horas de operador por semana.
- Não é apenas mais um ângulo de hype IA para vender ferramentas de documentação?
O guia gravado paga-se com ou sem agente. O ângulo do agente é upside, não a proposta de valor central. Uma equipa de Customer Success de quatro pessoas que usa guias para evitar a videochamada, uma equipa de TI que corta tickets Tier-1, uma agência que transforma a passagem de pasta numa linha facturável: todos estes ganhos existem com ou sem agente em produção. A camada agente é a década seguinte a compor-se por cima.
Comece a gravar antes de os agentes precisarem disso. Os dois lados pagam.
O Capture transforma um fluxo de trabalho num guia estruturado em doze minutos. Extensão Chrome gratuita, sem registo. A mesma biblioteca que ajuda as pessoas a evitar a videochamada vai servir os agentes quando chegarem em 2026.
Guias passo a passo: seis equipas, uma só mecânica
A pessoa sénior que conhece o fluxo de trabalho de cor torna-se o estrangulamento. O wiki apodrece. O Loom que ninguém vê acumula pó num ficheiro. Os guias passo a passo quebram esse padrão nas seis equipas que vimos a fazer isto em produção.
Porque o acolhimento de engenharia via README apodrece sempre
Todo o README de acolhimento apodrece em dois trimestres. O defeito é estrutural, não editorial, e reescrevê-lo com mais força não corrige nada.
SOC 2: procedimentos prontos para auditoria, sem sprint de documentação
Um auditor SOC 2 não quer páginas Notion bonitas. Quer prova de que um controlo correu. Um guia gravado pelo dono do processo, com cliques datados, é a prova mais limpa que a maioria dos auditores vê no ano todo.
Grave um workflow.
Extensão Chrome gratuita. Sem registo.