--- titulo: Execução por evento e agenda versao: "1.1.1" condicao: "edição candidata; operação em conta não observada" aplica: "Modelo de Gestão de Agentes de IA 1.2.0-rc.1; M10, M13 e M15" consumo: integral ao desenhar automação; focal em falha ou mudança de alcance --- # Execução por evento e agenda Automação faz o trabalho começar por evento, condição ou agenda sem uma pessoa conduzindo naquele momento. O julgamento necessário não desaparece: precisa ser delimitado antes, realizado pelo mecanismo ou pela inteligência competente e acompanhado depois. O Couto-IAS desenha essa composição quando ela serve ao trabalho, sem tornar agendamento uma obrigação de todo agente. ## Julgar quando cabe automatizar Procure necessidade observável, critério delimitável, efeito compatível com a ausência da pessoa e forma de acompanhar o resultado. Se o evento apenas representa oportunidade de trabalho, refine o filtro; não acione um fluxo amplo para descobrir depois que nada era necessário. Uma regra literal pode decidir comparação, presença de campo ou destino. Julgamento contextual pode continuar com IA, desde que critério e alcance estejam definidos e o efeito permitido caiba neles. Se uma escolha humana indispensável permanece aberta, a automação pode preparar rascunho, aviso ou fila suficiente, sem realizar o efeito dependente. Uma tarefa recorrente não assume sozinha responsabilidade persistente. Quando a execução precisa comparar a condição anterior, julgar o novo e responder por um território, a composição pode envolver agente, persistência e acionador. Aumentar o texto da tarefa não substitui essa continuidade. ## Desenhar o contrato da execução Defina necessidade, evento/filtro ou agenda com horário e fuso, dados de entrada e identidade do caso. Descreva o contexto recuperado, a regra literal, a inteligência chamada, a saída e quem a utiliza. Cada etapa recebe explicitamente os dados e critérios necessários; não suponha memória compartilhada entre execuções. Delimite em nome de quem a execução age, quais sistemas e operações recebe e que efeitos a ordem permanente cobre: objeto, alcance e condição. Um mecanismo de confirmação preenchido pelo próprio modelo não equivale a decisão humana. Texto “não envie” também não demonstra bloqueio técnico se a operação continua ao alcance. Reduza dados antes de repetir por item. Estime volume e custo quando mudarem a escolha de mecanismo. Uma contagem produzida pelo sistema pode substituir leitura de todos os objetos; o ganho deve preservar o significado e a cobertura do indicador. Não converta uma recomendação de engenharia em alegação de economia medida. Desenhe o caminho de entrada vazia, caso fora do escopo, dado inconsistente, acesso ausente, duplicata e falha parcial. Uma sequência que termina sem erro pode não ter produzido a entrega. A próxima etapa precisa reconhecer essas condições pela saída. ## Proteger e acompanhar o efeito Use as capacidades suficientes à execução e restrinja o que o mecanismo permitir. Uma ordem permanente suficiente cobre as execuções dentro do alcance; mudanças materiais de alvo ou efeito voltam à autoridade competente. Quando a plataforma não permitir a restrição necessária, delimite a realização possível e o que depende de outra forma. Comece pelo efeito reversível quando isso permitir aprender sem consequência indevida: rascunho, destino controlado ou aviso à pessoa. A passagem para um efeito diferente depende de evidência e decisão correspondentes, não do número de execuções por si. Defina quem lê resultado e ausência de execução, por qual condição ou cadência, o que confere e o que exige interrupção ou aviso. A leitura precisa ocorrer em tempo compatível com a consequência. Nomear um leitor sem condição de acompanhamento não garante essa capacidade. A evidência deve chegar junto do resultado: objeto e período, cobertura, itens processados, verificação pertinente e lacunas. Ela permite conferir sem refazer tudo. Um status de conclusão informa término; o efeito se verifica no destino. A inscrição numa agenda não prova que a execução aconteceu quando deveria. ## Testar, retomar e manter Trate ações de teste conforme seus efeitos reais. Use insumos e destinos controlados quando uma execução puder enviar, criar ou alterar. Exercite a variedade material do trabalho e confronte a saída com o critério recebido. Não amplie efeitos externos apenas para demonstrar capacidade. Se a execução for parcial, recupere o concluído antes de retomar. Após efeito indeterminado, consulte o destino antes de repetir. Critério, tom e método compartilhados permanecem em fonte ou Skill competente; a automação leva o caso e encaminha o resultado. Mudança de regra, fonte, conta, caminho ou mecanismo pode afetar a execução. Revise consumidores pertinentes e a prova correspondente. Falha transitória pode pertencer à condição atual; comportamento técnico reproduzível pertence ao saber de implementação; evidência de uma execução pertence ao objeto ou registro competente. ## Exemplo de aplicação Exemplo ilustrativo: uma pessoa quer receber um resumo de alterações em documentos de referência. O desenho resolve quais documentos, o que conta como mudança material, onde recuperar a edição anterior e quem recebe o resumo. Sem edição anterior, a execução pode informar a limitação; não inventa uma diferença. A leitura das fontes e a redação do resumo são contribuições diferentes. Enviar a terceiros é outro efeito, que exige alcance próprio. O acompanhamento confere tanto a qualidade das diferenças quanto se a tarefa ocorreu no momento previsto. Uma automação que apenas dispara um prompt longo não substitui esse desenho. ## Separar fila, agenda e evento | Recurso | O que resolve | O que não demonstra | |---|---|---| | Fila | Conserva demanda, destinatário, condição e resultado | Que alguém iniciou a execução | | Agenda | Faz a consulta no horário/fuso ou cadência definidos | Que o item foi processado ou que houve entrega | | Evento | Inicia por ocorrência e filtro concretos | Que a ocorrência só chegará uma vez ou em ordem | Desenhe primeiro uma execução manual suficiente; depois confira o disparo pelo mecanismo escolhido. As provas são separadas. Um botão de executar agora pode conferir a transformação, mas não prova o horário recorrente. Sem ativação coberta, entregue nome, instrução integral, cadência proposta, fuso, alvos, acompanhamento, critérios e dependências prontos para aplicar. ## Retomar sem duplicar nem disputar o mesmo item Reconheça a identidade lógica pela combinação pertinente de pedido, revisão e etapa; identifique também cada tentativa. Uma nova tentativa não é uma nova demanda. Antes de agir, recupere o retorno e o destino: resultado confirmado permite reutilização; efeito indeterminado exige reconciliação; erro confirmado sem efeito permite tentar apenas a parte faltante. Um recibo ausente não prova ausência do efeito. Se houver execução anterior em curso, não processe simultaneamente o mesmo item. Use exclusão/atualização condicional quando disponível; sem garantia técnica, restrinja a um consumidor serial e registre o limite. Expiração de prazo de uma reserva indica necessidade de verificar, não licença automática para duplicar. Confirme que a tentativa anterior parou e confira seu destino antes de liberar retomada. Não prometa efeito único com escrita comum de arquivos ou consulta sem trava. | Condição | Comportamento esperado | |---|---| | Consulta válida sem item elegível | Registrar execução vazia e cobertura; não criar demanda artificial | | Item novo | Conferir alcance, registrar recebimento, produzir e reler retorno | | Mesma revisão já concluída | Reutilizar retorno confirmado; não repetir efeito | | Revisão nova | Conferir diferenças e efeitos anteriores antes de processar | | Sobreposição | Adiar item ocupado; conservar identidade da tentativa em andamento | | Falha de acesso | Informar etapa/alvo indisponível e consequência; não registrar fila vazia | | Falha parcial/tempo excedido | Preservar o confirmado e reconciliar o indeterminado antes de retomar | Acompanhamento inclui ausência de execução: conserve horário esperado, última tentativa, último sucesso e resultado/erro em lugares recuperáveis. Defina pessoa ou função que confere, janela de atraso e meio efetivamente acessível para perceber falha. A própria tarefa pode registrar erro quando consegue rodar; não consegue atestar sua ausência se nunca iniciou. O [apoio Cowork](../Plugin-Couto-IAS/skills/instalar-gestao-de-agentes/references/cowork-rotinas.md) contém preparação e verificação por perfil de execução. Características de plataforma são datadas e precisam de conferência no ambiente da pessoa.