Validar tarefas antes de gravar com agente de IA

A frase parece uma tarefa, mas ainda pode ser uma pendência

Uma reunião termina com a anotação: “confirmar o novo prazo com o fornecedor”. O agente identifica um verbo, um objeto e uma intenção de trabalho. Ainda faltam duas informações: quem fará a confirmação e até quando.

Se a integração gravar essa frase diretamente no sistema de projetos, a equipe recebe uma tarefa com aparência oficial e responsabilidade indefinida. O problema desaparece da ata e reaparece numa fila em que ninguém sabe quem deve agir.

A fronteira entre extração e escrita precisa de um gate de validação. O agente pode propor a tarefa. Um componente determinístico confere os campos, a evidência, a aprovação, o estado atual e a duplicidade antes de permitir a gravação.

Este recorte é diferente de desenhar todo o fluxo de reuniões ou apenas exigir uma saída em JSON. A pergunta aqui é estreita: que condições precisam estar satisfeitas no instante anterior à escrita em um sistema oficial?

Separe proposta, pendência e tarefa aceita

Uma única lista chamada “tarefas” comprime estados que pedem tratamentos diferentes.

Proposta

O agente encontrou uma frase que pode representar trabalho. Ela ainda aguarda validação. Nenhum registro oficial foi criado.

Pendência de definição

Existe trabalho provável, mas falta responsável, prazo, resultado esperado, fonte ou autoridade. O item deve voltar ao dono da reunião ou do processo com a lacuna explícita.

Tarefa aceita

Os campos obrigatórios passaram pelas regras, a aprovação necessária existe, a versão continua válida e o destino confirmou a gravação.

Rejeitada

O trecho descreve hipótese, comentário, atualização para ciência ou decisão já concluída. Criar tarefa só aumentaria ruído.

Essa separação evita que o modelo precise escolher entre inventar um campo e perder o item. Ausência vira um estado operacional visível.

Defina o contrato mínimo da tarefa

O contrato deve nascer do sistema que receberá o registro e da decisão que a equipe precisa tomar depois. Um conjunto inicial pode conter:

• identificador estável da proposta;
• descrição da entrega esperada;
• responsável único;
• prazo ou condição temporal válida;
• origem da informação;
• objeto relacionado, como projeto, cliente ou processo;
• evidência de conclusão;
• aprovador, quando exigido;
• estado da validação;
• motivo do bloqueio;
• chave de duplicidade;
• versão da fonte e da política.

“Revisar orçamento” ainda deixa espaço demais. “Paulo revisa as premissas de custo da versão 3 e devolve o arquivo com comentários até 23 de setembro” permite acompanhar entrega, dono, objeto e prazo.

O contrato também precisa representar ausência. Campo nulo não deve significar ao mesmo tempo “não mencionado”, “não aplicável” e “falha de extração”. Use estados claros, como ausente_na_fonte, precisa_confirmacao, nao_aplicavel e conflitante.

O artigo sobre saídas estruturadas para agentes de IA detalha schema, validação sintática e estados de ausência. O gate de escrita começa depois dessa estrutura e decide se o objeto pode produzir consequência no destino.

Trate cinco condições como bloqueios reais

1. Responsável indefinido

Uma equipe ou departamento raramente funciona como dono executável. Exija uma pessoa ou papel operacional resolvível no diretório da empresa. Se o nome citado estiver ambíguo, preserve os candidatos e peça confirmação.

O agente não deve atribuir a tarefa à pessoa que falou, ao organizador da reunião ou ao gestor mais próximo apenas para preencher o campo.

2. Prazo ausente ou incoerente

Nem toda tarefa precisa de uma data arbitrária. Ela precisa de uma condição temporal que o processo consiga acompanhar. Pode ser uma data, uma janela ou uma dependência explícita.

Bloqueie datas anteriores à origem, prazos impossíveis e expressões que perderam referência, como “sexta-feira” sem data ou fuso. Se a reunião menciona “responder até sexta”, isso pode indicar prazo de retorno, sem provar que a execução principal deve terminar no mesmo dia.

3. Evidência de origem ausente

A proposta deve apontar para um trecho, nota, decisão ou registro que sustenta a interpretação. A referência permite conferir se a fala continha compromisso ou apenas sugestão.

Guardar somente o resumo do agente torna a validação circular: o sistema usa a própria interpretação como prova.

4. Aprovação necessária não confirmada

Algumas tarefas podem ser internas e reversíveis. Outras iniciam comunicação externa, alteram condição comercial, concedem acesso, publicam conteúdo ou movimentam dinheiro.

O gate precisa consultar a política de alçada. Uma marca textual como “aprovado” não basta quando a decisão exige identidade do aprovador, objeto, versão, escopo e validade.

5. Item semelhante já existente

A mesma ação pode aparecer na transcrição, na ata e no resumo final. Também pode ter sido criada manualmente enquanto o agente processava a reunião.

Compare identificador da origem, objeto, entrega, responsável e versão. Quando houver correspondência forte, encaminhe para vínculo ou atualização. Não crie outro registro por reflexo.

Validação sintática e validação operacional fazem trabalhos diferentes

Structured Outputs pode exigir que a resposta siga um JSON Schema. A documentação oficial da OpenAI informa que todos os campos precisam ser declarados como obrigatórios no modo estrito e que um valor opcional pode ser representado por união com null.

Isso ajuda a receber um objeto previsível. Ainda não confirma que o responsável existe, que a fonte sustenta a tarefa, que a aprovação vale ou que o registro não está duplicado.

Organize o gate em camadas:

1. validar forma, tipos, enumerações e versão do schema;
2. interpretar estados de ausência sem preenchimento automático;
3. resolver identidades contra fonte autorizada;
4. conferir prazo, política e alçada;
5. comparar o estado atual do objeto;
6. pesquisar duplicidade no destino;
7. reservar a gravação por chave estável;
8. escrever somente a versão aceita;
9. confirmar o identificador retornado pelo sistema;
10. registrar resultado e rota das exceções.

A documentação de function calling da OpenAI descreve funções como ferramentas definidas por schema que podem conectar o modelo a dados e ações externas. Essa conexão entrega argumentos à aplicação. A aplicação continua responsável por validar e executar a ação permitida.

Use uma fila de pendências em vez de corrigir silenciosamente

Quando o gate encontra uma lacuna, ele deve produzir uma pergunta pequena e acionável.

Exemplos:

• responsavel_ausente: “Quem assume a confirmação do prazo com o fornecedor?”
• prazo_ausente: “Qual data ou condição encerra esta tarefa?”
• fonte_ausente: “Que trecho ou decisão sustenta a criação deste item?”
• aprovacao_necessaria: “Quem possui alçada para autorizar a publicação?”
• possivel_duplicidade: “A tarefa T-184 representa a mesma entrega?”

A fila precisa manter a proposta original, a lacuna, a fonte disponível, a decisão necessária e o dono da resolução. Mandar a transcrição completa com “favor conferir” devolve todo o trabalho para a pessoa.

Defina também expiração. Uma pendência antiga pode perder valor quando projeto, preço, cliente ou prioridade mudam. Resolver o campo depois não autoriza usar o restante do contexto sem revalidação.

Teste sintético da fronteira antes da integração

Em 21 de setembro de 2026, a Júpiter executou um teste local e isolado do gate com seis entradas sintéticas. O laboratório não chamou CRM, gerenciador de projetos nem API externa.

Os casos foram:

1. tarefa completa e aprovada;
2. tarefa sem responsável;
3. tarefa sem prazo;
4. tarefa sem referência de origem;
5. tarefa completa sem aprovação exigida;
6. repetição do identificador já aceito.

O validador permitiu uma escrita, encaminhou quatro itens para pendência e bloqueou uma duplicidade. O teste confirma o comportamento da regra local usada no exemplo. Ele não prova compatibilidade com um produto específico nem substitui homologação da integração real.

A matriz mínima ficou assim:

| Entrada | Rota esperada | Consequência permitida | |---|---|---| | completa, aprovada e inédita | aceitar | reservar e gravar | | sem responsável | pendência | nenhuma escrita | | sem prazo | pendência | nenhuma escrita | | sem fonte | pendência | nenhuma escrita | | sem aprovação | pendência | nenhuma escrita | | identificador existente | duplicidade | reutilizar ou revisar |

O valor do teste está no caso negativo. Uma demonstração que só envia a tarefa perfeita não revela se o agente transforma ausência em certeza.

Reserve antes de gravar

Consultar duplicidade e escrever em duas etapas independentes abre uma corrida. Duas execuções podem consultar o destino, não encontrar a tarefa e criar o mesmo item.

Use uma chave estável derivada da origem e da entrega. Por exemplo:

reuniao:R-184 + acao:A-03 + destino:projeto-P-12

A reserva precisa ser atômica no componente que controla a escrita. Apenas uma execução avança. A outra lê o estado existente e segue para reutilização, espera ou revisão.

O guia de idempotência em agentes de IA aprofunda chaves, reservas, respostas incertas e reconciliação. Aqui, a chave protege especificamente a passagem de uma proposta validada para uma tarefa oficial.

Revalide a versão no momento da consequência

Uma proposta pode permanecer minutos ou dias na fila de aprovação. Nesse intervalo, o documento muda, outra pessoa assume, a tarefa é criada manualmente ou a decisão perde validade.

Antes da escrita, confira:

• a fonte continua na versão examinada;
• o objeto permanece ativo;
• o responsável ainda possui vínculo e acesso;
• a aprovação cobre a versão atual;
• o prazo continua possível;
• a tarefa não apareceu por outro canal;
• a política aplicada permanece vigente.

Se algo mudou, reconstrua a proposta ou peça nova decisão. Aprovação de uma versão não deve ser reaproveitada para outra carga.

Confirme o efeito no sistema de destino

Uma resposta HTTP sem identificador de objeto pode deixar o resultado incerto. O fluxo precisa guardar:

• chave da tentativa;
• horário;
• payload validado;
• versão da política;
• identidade que autorizou;
• resposta do destino;
• identificador criado;
• consulta de confirmação;
• estado final;
• próxima ação quando a confirmação falhar.

Se a conexão cair depois do envio, consulte o destino antes de repetir. Falha de confirmação pode coexistir com escrita concluída.

A tarefa só entra no estado aceita quando o sistema oficial confirma o registro esperado. Até lá, use resultado_incerto e encaminhe reconciliação.

Métricas para saber se o gate melhora o processo

Acompanhe medidas que orientem correção:

• propostas recebidas;
• tarefas aceitas na primeira passagem;
• pendências por campo ausente;
• tempo até resolver cada lacuna;
• itens rejeitados por não representarem trabalho;
• duplicidades bloqueadas;
• aprovações vencidas;
• conflitos de versão;
• escritas sem confirmação;
• tarefas corrigidas logo após criação;
• registros órfãos por responsável;
• tarefas vencidas sem evidência de conclusão.

Uma taxa alta de pendências pode indicar notas ruins, contrato exigente demais ou reunião sem decisão clara. O gate expõe a causa. Afrouxar a regra para aumentar o número de tarefas criadas apenas devolve o problema à equipe.

Checklist antes de liberar a escrita

• [ ] Proposta, pendência e tarefa aceita possuem estados separados?
• [ ] O contrato exige entrega, dono, prazo e origem?
• [ ] Ausência e conflito aparecem sem preenchimento inventado?
• [ ] Identidades são resolvidas numa fonte autorizada?
• [ ] A política informa quando aprovação é necessária?
• [ ] Aprovação está ligada ao objeto, versão e validade?
• [ ] O destino foi consultado para duplicidade?
• [ ] A reserva de gravação é atômica?
• [ ] Mudanças ocorridas durante a espera geram revalidação?
• [ ] O efeito recebe confirmação do sistema oficial?
• [ ] Resultado incerto bloqueia repetição automática?
• [ ] Pendências chegam a um dono com pergunta específica?
• [ ] Casos negativos fazem parte do teste de regressão?

Fontes consultadas

Fontes oficiais verificadas em 21 de setembro de 2026:

• OpenAI, Structured model outputs, para uso de JSON Schema, modo estrito e limites entre estrutura e significado;
• OpenAI, Function calling, para a passagem de argumentos estruturados entre modelo, aplicação e ferramentas.

A gravação é uma decisão, não uma etapa automática

O agente pode localizar uma intenção de trabalho com rapidez. A tarefa oficial exige mais: responsável resolvido, prazo compreensível, evidência de origem, autoridade válida, versão atual e ausência de duplicidade.

Coloque um gate determinístico entre interpretação e escrita. Lacunas seguem para uma fila pequena, casos aceitos recebem reserva e o destino confirma o efeito. Assim, o sistema preserva o que ainda precisa ser decidido sem fabricar execução no lugar da equipe.