← Mari

OpenBot · Agents · Mari

skill-rotinas-openbot-com-intervalo.md

Skill própria: rotina a cada 3 minutos com vigia curta para responder rápido.

No OpenBot: Agents/agent-…/.agents/skills/rotinas-openbot-com-intervalo/SKILL.md

Texto como está no OpenBot em 16/11/2026. Trechos com ref de banco, conta, id interno ou caminho local foram tirados e aparecem [entre colchetes].

name
Rotinas OpenBot com intervalo
description
Cria ou ajusta rotinas recorrentes no OpenBot, com intervalo mínimo de 3 minutos e vigilância curta a cada ~20 segundos para respostas rápidas. Use ao agendar tarefas periódicas, como monitorar uma fila e responder clientes.

Objetivo

Criar rotinas no OpenBot que rodam em intervalo fixo e, quando há trabalho, reagem em segundos por uma janela curta.

Procedimento

  1. Confirme o intervalo antes de criar.
    • Use no mínimo 3 minutos, ou agenda diária, semanal ou cron.
    • Intervalos menores são recusados na criação, então não tente criar com 2 minutos ou menos.
    • Se o usuário pedir um intervalo menor, use 3 minutos e avise que foi ajustado, explicando o motivo.
  1. Para reação rápida, use vigilância dentro do script, não intervalo menor.
    • Faça o script consultar a fila a cada ~20 segundos durante uma janela limitada (ex.: 5 minutos).
    • Quando houver item, processe e reinicie a janela.
    • Ao fim da janela sem nada, encerre o script. Assim o intervalo normal de 3 minutos volta a valer.
    • Motivo: o agendador não aceita intervalo curto, mas o script pode ficar ativo dentro de uma execução.
  1. Teste o script antes de criar a rotina.
    • Rode-o com a ferramenta de shell do projeto, passando o caminho do script como argumento.
    • Esperado: saída vazia e código de saída 0 quando a fila está vazia.
    • Motivo: confirma que a chave e a API funcionam antes de a rotina rodar sozinha.
  1. Verifique a chave de acesso sem expô-la.
    • Confirme que a chave está no cofre local antes de criar a rotina.
    • Se a chave faltar ou for recusada, não a exiba nem a grave em arquivo temporário. Peça ao usuário para restaurá-la com o script de instalação da pasta, ou para aplicar o passo no servidor se for necessário.
    • Motivo: uma chave ausente faz cada execução falhar e gerar avisos repetidos.
  1. Crie a rotina com os parâmetros.
    • Use a ferramenta de criação de rotinas do OpenBot com nome, intervalo, fuso horário, limitPolicy: skip e missedPolicy: skip.
    • Instrução: copie o texto do arquivo da instrução exatamente como está, sem o título da seção.
    • Motivo: skip evita acúmulo de execuções atrasadas.
  1. Mantenha o arquivo e a rotina sincronizados.
    • Ao alterar a instrução no arquivo, atualize também a instrução da rotina.
    • Ao alterar o intervalo, atualize o arquivo de documentação para o mesmo valor.
    • Motivo: o arquivo não altera a rotina sozinho, e divergências causam comportamento inesperado.
  1. Informe o resultado ao usuário.
    • Diga o identificador da rotina, o intervalo efetivo e o horário da próxima execução.
    • Diga se o intervalo foi ajustado.

Cuidados

  • Execuções sobrepostas: se uma execução começar enquanto outra ainda está na janela de vigilância, as duas podem ler a mesma fila. Torne o processamento idempotente, por exemplo marcando o item como respondido antes de enviar, para evitar resposta duplicada.
  • Clientes reais: uma rotina que responde clientes passa a agir assim que é criada. Avise o usuário disso antes de ativar.
  • Pausa: se o usuário pedir pausa, desative a rotina em vez de apagá-la. Assim pode ser reativada sem recriar.
  • Falhas silenciosas: o histórico de execuções pode não estar disponível. Sem ele, a primeira execução real com conteúdo na fila é a única prova de que funcionou; informe isso ao usuário.

Como verificar

  • O teste manual do script retorna saída 0.
  • A rotina aparece ativa com o intervalo esperado e o fuso correto.
  • Após a primeira execução com item real na fila, confirme a resposta enviada e o encerramento da janela.
  • Não afirme que a rotina funciona sem essa verificação; diga o que foi testado e o que não foi.