Agendamentos

Um agendamento faz um agente trabalhar sozinho, de tempos em tempos, sem ninguém pedir. Relatório toda segunda de manhã, conferência de estoque a cada hora, resumo do dia às 18h.

#Como criar

Em Agendamentos → Novo, você informa:

• Qual agente executa.
• O que ele deve fazer — escrito em português, como você pediria numa conversa.
• Quando — a frequência.

O agendamento é criado no seu servidor, no runtime que roda os agentes. Ele executa lá, com o horário da própria máquina.

#O fuso horário é o do servidor

Isto é a fonte de confusão mais comum: um agendamento das 9h roda às 9h no fuso do servidor, não no seu. Se a sua VPS está em UTC e você está em São Paulo, "9h" acontece às 6h para você.

A página mostra o horário da próxima execução para você conferir antes de confiar.

#Ver uma tarefa por inteiro

A tabela mostra o resumo. Para ver a tarefa completa, clique na linha — ou no ícone de olho, Visualizar — e um painel lateral abre com tudo: qual agente executa, em qual servidor, a frequência, a próxima e a última execução, por onde a resposta é entregue e o texto da tarefa como o agente a recebe. É ali que você confere se o pedido ficou do jeito que você queria, principalmente nos agendamentos que o próprio agente criou.

A última falha, quando existe, também aparece nesse painel. Na tabela ela vem oculta por padrão, para não roubar espaço das colunas do dia a dia — você pode ligá-la pelo seletor de colunas.

#Os agentes também agendam

Um agente pode criar o próprio agendamento quando a tarefa pede — você diz "me manda um resumo toda sexta" numa conversa e ele agenda. Esses agendamentos aparecem nesta mesma página, ao lado dos que você criou, e você pode editar ou remover qualquer um.

Essa é a razão da página existir: sem ela, trabalho recorrente ficaria invisível dentro do servidor.

#O espelho e o atraso

A lista é um espelho do que existe no servidor. A página diz quando foi a última atualização.

O servidor avisa a Bia assim que um agendamento aparece ou some, então um cron novo costuma chegar à lista em segundos, e no pior caso em cerca de um minuto. Ainda assim, se algo que você acabou de criar não apareceu, espere a próxima sincronização antes de criar de novo — senão você acaba com dois.

#Quando algo falha

Se uma execução falhar, o erro aparece na linha do agendamento, com a data da última falha. Causas comuns: o agente foi removido, o servidor estava offline no horário, ou a instrução depende de algo que não existe mais.

#Um agendamento não acorda um servidor offline

O agendamento roda no servidor. Se a máquina está desligada na hora marcada, aquela execução simplesmente não acontece — não fica em fila para depois.

#Próximos passos

• Tarefas e colaboração — trabalho delegado entre agentes.
• Habilidades — procedimentos para o agendamento executar.