Arquitetura de IA

Como intervir numa tarefa de agente de IA em andamento

Aprenda a corrigir uma tarefa longa de agente de IA em andamento com estado, versão, pontos seguros, revalidação e registro da intervenção humana.

A tarefa continua certa depois que o contexto muda?

Um agente inicia a preparação de uma análise para a diretoria. Ele reúne documentos, consulta indicadores e organiza recomendações. Vinte minutos depois, a liderança informa que uma premissa mudou: a unidade Sul saiu do escopo e o período deve terminar em setembro.

Cancelar tudo e recomeçar pode desperdiçar trabalho válido. Inserir a nova instrução diretamente no contexto pode ser pior. Parte da análise talvez já tenha produzido arquivos, criado registros ou consultado fontes com o escopo anterior.

A intervenção durante uma tarefa longa precisa entrar como uma mudança governada. O sistema registra a instrução, identifica quais partes ela afeta, chega a um ponto seguro, preserva efeitos confirmados e revalida o plano antes de continuar.

A OpenAI passou a destacar steering em trabalhos longos como uma forma de orientar agentes em marcos, sem acompanhar cada linha. Para uma empresa, a pergunta importante está na implementação: como aceitar uma correção humana sem misturar versões, repetir efeitos ou esconder o que mudou?

Este guia trata dessa fronteira. O artigo sobre cancelamento de tarefas de agentes encerra uma unidade. A aprovação assíncrona pausa diante de uma ação previamente definida. Aqui, a pessoa altera o objetivo, o escopo ou o critério de uma execução que ainda está aberta.

Quando uma intervenção é útil

A intervenção pode corrigir o trabalho sem exigir outro ciclo completo quando:

  • uma fonte oficial recebeu versão nova;
  • o escopo perdeu ou ganhou uma unidade delimitada;
  • uma premissa foi corrigida;
  • a prioridade entre entregáveis mudou;
  • surgiu uma restrição de prazo;
  • uma etapa opcional deixou de ter valor;
  • a pessoa pediu aprofundamento num ponto específico;
  • uma evidência tornou parte do plano inválida;
  • o agente precisa suspender ações e continuar apenas em leitura;
  • a entrega deve mudar de formato sem mudar seu conteúdo aceito.

Ela não deve servir como atalho para ampliar permissão, ignorar aprovação, trocar silenciosamente a fonte oficial ou alterar uma consequência já confirmada.

Uma frase como “inclua também todos os clientes” pode mudar acesso, custo, prazo e finalidade. O sistema precisa tratá-la como proposta de mudança até verificar esses limites.

Separe quatro operações

Intervir, aprovar, cancelar e iniciar outra tarefa são decisões diferentes.

Intervenção

Altera uma execução ainda válida. O sistema preserva a identidade da tarefa e cria uma nova versão do plano ou do escopo.

Aprovação

Autoriza ou rejeita uma ação delimitada, com argumentos e consequência conhecidos. Aprovar o envio de um relatório não autoriza mudar seus destinatários.

Cancelamento

Encerra trabalho futuro daquela unidade. Pode exigir limpeza, reconciliação e comunicação de resultado parcial.

Nova tarefa

Cria outra unidade quando a mudança altera finalidade, dono, dados, prazo ou resultado de forma material. Forçar uma mudança grande dentro da execução antiga destrói a legibilidade do histórico.

Defina critérios para escolher entre essas rotas. A decisão não deve depender somente da interpretação livre do modelo.

Registre a intervenção como um objeto próprio

Uma mensagem solta no chat informa intenção, mas não cria uma mudança operacional verificável.

Use um registro como:

intervention_id: int-20261002-018
run_id: analise-diretoria-2026-q3
submitted_at: 2026-10-02T18:42:11Z
submitted_by: user-184
base_plan_version: 7
requested_change:
  remove_scope: unidade-sul
  period_end: 2026-09-30
reason: fechamento revisado pela diretoria
priority: antes_da_sintese
requested_mode: aplicar_e_continuar

Acrescente:

  • identidade e papel de quem pediu;
  • canal autenticado;
  • versão do plano observada pela pessoa;
  • fonte da nova informação;
  • partes que podem ser afetadas;
  • ações que continuam proibidas;
  • prazo da instrução;
  • estado de aceite;
  • decisão do sistema;
  • evidência da aplicação.

A instrução pode chegar enquanto outra mudança já está sendo aplicada. A versão de base permite detectar que a pessoa decidiu sobre uma visão antiga.

Valide autoridade antes do conteúdo

O fato de a instrução parecer razoável não prova que a pessoa possui autoridade para emiti-la.

Antes de aceitar, verifique:

  1. identidade do solicitante;
  2. papel naquele processo;
  3. unidade, cliente ou projeto alcançado;
  4. tipo de mudança permitido;
  5. dados adicionais que a mudança exigirá;
  6. ações externas que poderão ser afetadas;
  7. aprovações anteriores que perderiam validade;
  8. segregação de funções aplicável.

Uma pessoa pode alterar o formato do relatório e não o período contábil. Outra pode retirar um destinatário e não acrescentar acesso a uma unidade. Modele alçadas por tipo de mudança, sem usar “pode intervir” como permissão genérica.

A identidade e credenciais de agentes ajuda a separar a conta técnica da autoridade empresarial. A intervenção precisa carregar as duas provas.

Aplique mudanças em pontos seguros

Uma tarefa longa atravessa momentos com riscos diferentes. Alguns permitem correção imediata. Outros precisam terminar, pausar ou reconciliar antes da mudança.

Exemplo de execução:

coletar_fontes
normalizar_dados
calcular_indicadores
preparar_sintese
solicitar_aprovacao
publicar_resultado

Retirar uma unidade durante coletar_fontes pode cancelar consultas ainda não iniciadas. Durante calcular_indicadores, o sistema talvez precise abandonar o cálculo parcial e refazer a etapa com o novo conjunto. Depois de publicar_resultado, a mudança não corrige retroativamente o efeito: ela exige nova versão e tratamento explícito do material anterior.

Para cada etapa, declare:

  • se aceita intervenção imediata;
  • se precisa concluir a operação atômica atual;
  • qual checkpoint é válido;
  • quais saídas parciais perdem validade;
  • quais efeitos já foram confirmados;
  • como interromper chamadas em andamento;
  • quando a nova versão passa a valer.

O ponto seguro pertence ao workflow e às ferramentas. Um prompt pedindo cautela não consegue interromper uma escrita que já chegou ao sistema de destino.

Classifique o impacto antes de continuar

Compare a mudança solicitada com o plano corrente.

Impacto local

Muda formato, ordem ou profundidade de uma saída ainda não comprometida. Reprocessa uma etapa estreita.

Impacto retroativo

Invalida uma entrada ou resultado usado por etapas concluídas. Exige voltar a um checkpoint anterior e descartar derivados.

Impacto de autoridade

Amplia dados, ferramentas, destinatários, autonomia ou consequência. Exige nova validação ou aprovação.

Impacto de finalidade

Altera o resultado empresarial esperado. Geralmente merece outra tarefa, com identidade e critérios próprios.

Impacto irreversível

Tenta modificar um efeito já executado, como mensagem enviada, registro aprovado ou pagamento confirmado. A rota adequada pode ser compensação, correção ou nova comunicação. Reescrever o histórico local não desfaz o mundo externo.

Essa classificação pode usar regras determinísticas para campos conhecidos. O modelo ajuda a explicar relações e localizar derivados, mas não deve conceder a própria ampliação de poder.

Preserve uma árvore de derivados

Para aplicar uma correção, o sistema precisa saber o que nasceu de cada fonte e decisão.

Considere:

fonte F17 -> tabela T8 -> indicador I4 -> parágrafo P12 -> slide S6

Se F17 muda, T8 precisa ser recalculada. I4, P12 e S6 ficam suspeitos até nova validação. Sem essa proveniência, o agente tende a corrigir a frase visível e manter cálculos ou recomendações criados com a premissa antiga.

Registre pelo menos:

  • identificador e versão da fonte;
  • etapa que consumiu a fonte;
  • artefato produzido;
  • regra ou transformação aplicada;
  • decisões que usaram o artefato;
  • efeito externo relacionado;
  • estado depois da intervenção.

A página sobre linhagem de dados para agentes aprofunda a trajetória entre fonte, transformação e resultado. Durante uma intervenção, essa trajetória define o raio de reprocessamento.

Use versões explícitas do plano

Uma execução pode começar com plan_version = 7. A intervenção aceita cria a versão 8.

A versão nova deve mostrar:

base_version: 7
new_version: 8
change_set:
  - unidade-sul removida
  - period_end alterado para 2026-09-30
invalidated_outputs:
  - tabela-por-unidade-v3
  - sintese-executiva-draft-2
preserved_outputs:
  - inventario-fontes-v5
required_revalidation:
  - indicadores consolidados
  - destinatarios da entrega

Workers e ferramentas recebem a versão aplicável. Resultado produzido com versão anterior não entra silenciosamente na consolidação nova.

Quando duas intervenções chegam próximas, use controle de concorrência. Uma mudança baseada na versão 7 não deve sobrescrever outra já aceita na versão 8. O sistema devolve conflito e pede revisão sobre o estado atual.

Escolha entre continuar, voltar, pausar ou abrir outra tarefa

A decisão de aplicação pode usar quatro rotas.

Continuar do ponto atual

Adequado quando a mudança afeta somente trabalho futuro e nenhum resultado anterior precisa ser revisto.

Voltar a um checkpoint

Use quando uma etapa concluída depende da premissa alterada. Marque derivados como inválidos e retome do último estado comprovadamente compatível.

Pausar para decisão

Necessário quando o impacto alcança permissão, finalidade, contrato, dado sensível ou efeito incerto. Preserve estado e apresente as alternativas a uma pessoa autorizada.

Encerrar e criar nova unidade

Escolha quando o objetivo mudou de forma material ou quando misturar versões prejudicaria auditoria, cobrança, SLA ou responsabilidade.

Registre o motivo da rota. “O agente decidiu reiniciar” ajuda pouco. “A mudança retirou uma unidade usada em três cálculos e numa aprovação pendente; retomada no checkpoint anterior à agregação” permite operar e revisar.

Não confunda correção com edição do histórico

O histórico deve preservar:

  • instrução original;
  • plano anterior;
  • trabalho já concluído;
  • intervenção recebida;
  • validações feitas;
  • decisão de aplicação;
  • versão nova;
  • partes invalidadas;
  • ações compensatórias;
  • resultado final.

Mostrar apenas a versão mais recente apaga a explicação de por que o agente consultou uma fonte, abandonou um cálculo ou repetiu uma etapa.

A interface pode destacar o estado corrente, mas o registro de auditoria precisa manter a sequência. A pessoa que revisa o resultado deve conseguir separar o que foi produzido antes e depois da mudança.

Trate ferramentas em andamento de forma individual

Ao receber uma intervenção, liste as chamadas ativas.

Para cada uma, verifique:

  • pode ser cancelada?
  • o cancelamento é confirmado?
  • produz somente leitura?
  • pode ter concluído apesar da resposta ausente?
  • possui chave idempotente?
  • aceita versão ou condição na escrita?
  • o resultado ainda terá validade?
  • exige reconciliação?

Uma consulta de leitura pode terminar e ter a saída descartada. Uma criação de tarefa no CRM precisa ser consultada antes de repetição ou compensação. Um envio externo talvez não possa ser recolhido.

O kill switch para agentes contém autonomia diante de risco. A intervenção é mais estreita: altera uma unidade com intenção de continuar, mantendo os mesmos controles sobre ferramentas e efeitos.

Exemplo: análise trimestral em andamento

A tarefa analise-diretoria-2026-q3 usa quatro unidades e fecha o trimestre em 30 de setembro.

O agente concluiu a coleta, normalizou os dados e iniciou a síntese. A pessoa responsável envia duas correções:

1. Remover a unidade Sul porque seus números ainda estão em revisão.
2. Manter o período encerrado em 30/09. Não usar a parcial de outubro.

O sistema:

  1. autentica a solicitante e confirma alçada sobre o relatório;
  2. registra a intervenção sobre plan_version = 7;
  3. impede que a síntese atual chegue à aprovação;
  4. termina a operação local de gravação do rascunho;
  5. marca indicadores consolidados e trechos derivados como inválidos;
  6. preserva fontes das outras unidades;
  7. volta ao checkpoint anterior à consolidação;
  8. cria plan_version = 8;
  9. recalcula os indicadores com três unidades;
  10. registra a exclusão da Sul como limite de cobertura;
  11. exige nova revisão antes de publicar.

O relatório final informa que a unidade Sul ficou fora por decisão registrada. A versão anterior permanece no histórico e não aparece como resultado vigente.

Estados que deixam a intervenção legível

Um modelo de estados pode usar:

recebida
validando_autoridade
avaliando_impacto
aguardando_ponto_seguro
aceita
rejeitada
conflito_de_versao
aplicando
revalidando
aplicada
aplicacao_parcial
exige_nova_tarefa
exige_reconciliacao

Cada transição registra horário, ator, versão, motivo e evidência. Estados finais precisam indicar se a execução continuará, ficará pausada ou encerrará.

Teste mudanças durante o trabalho real

Inclua cenários como:

  1. correção antes da primeira ferramenta;
  2. mudança durante uma consulta longa;
  3. retirada de escopo depois de um cálculo;
  4. ampliação de dados sem permissão;
  5. alteração de destinatário depois da aprovação;
  6. instrução baseada numa versão antiga;
  7. duas intervenções conflitantes;
  8. cancelamento de ferramenta sem confirmação;
  9. efeito externo concluído com resposta perdida;
  10. worker antigo entregando resultado da versão anterior;
  11. retomada depois de reinício do processo;
  12. mudança que exige nova tarefa;
  13. intervenção expirada antes da aplicação;
  14. solicitante que perde o papel durante a pausa;
  15. reprocessamento que ultrapassa o prazo final.

Confirme versão final, efeitos externos, itens descartados, fontes preservadas, aprovações invalidadas e linguagem exibida à pessoa.

Métricas para operar intervenções

Acompanhe:

  • intervenções por tipo de tarefa;
  • tempo entre recebimento e ponto seguro;
  • mudanças aceitas, rejeitadas e conflitantes;
  • etapas reprocessadas;
  • saídas invalidadas;
  • efeitos que exigiram reconciliação;
  • execuções convertidas em nova tarefa;
  • intervenções por problema de briefing;
  • intervenções por mudança real do ambiente;
  • falhas causadas por resultado de versão antiga;
  • custo e prazo adicionais por mudança;
  • qualidade final depois da revalidação.

Muitas intervenções podem indicar um briefing fraco, fontes voláteis ou ausência de marcos de revisão. Poucas intervenções também não provam bom desenho: a interface pode simplesmente impedir supervisão útil.

Checklist de implementação

  • [ ] Cada execução possui identidade e versão do plano?
  • [ ] A intervenção registra pessoa, papel, versão e motivo?
  • [ ] Autoridade é verificada por tipo de mudança?
  • [ ] O workflow declara pontos seguros?
  • [ ] Chamadas ativas podem ser listadas e tratadas?
  • [ ] Derivados mantêm vínculo com fonte e versão?
  • [ ] Resultados antigos são invalidados de forma explícita?
  • [ ] Workers recusam saída de versão superada?
  • [ ] Efeitos confirmados não são apagados do histórico?
  • [ ] Mudanças de permissão voltam para aprovação?
  • [ ] Conflitos entre intervenções são detectados?
  • [ ] Existe critério para criar outra tarefa?
  • [ ] A retomada usa checkpoint compatível?
  • [ ] O resultado final mostra limites e mudanças materiais?
  • [ ] Testes cobrem ferramenta em andamento e resposta incerta?

Supervisão precisa conseguir mudar a rota

Agentes que executam trabalho longo encontram um ambiente que continua mudando. Documentos recebem versões novas, prioridades mudam e premissas caem enquanto a tarefa ainda está aberta.

Uma intervenção segura combina identidade, autoridade, versão, análise de impacto, ponto seguro, linhagem, checkpoint e revalidação. A pessoa consegue corrigir o rumo. O sistema continua responsável por mostrar onde a correção entrou e o que precisou ser refeito.

Fontes oficiais verificadas em 2 de outubro de 2026:

As fontes confirmam mecanismos e padrões do ecossistema citado. A política de intervenção, as alçadas, os pontos seguros e o tratamento de efeitos externos pertencem à arquitetura de cada empresa e precisam ser testados no ambiente adotado.