Como Automatizar Tarefas com o Hermes Agent Usando Cron

O Hermes Agent pode executar tarefas automaticamente para você em horários específicos. Isso significa que você pode pedir para o agente fazer algo todos os dias, toda segunda-feira, a cada quatro horas ou até uma única vez no futuro, sem precisar abrir o Hermes e repetir o mesmo pedido manualmente.

Para isso, o Hermes possui um recurso chamado cron. Apesar do nome parecer técnico, a ideia é simples: pense no cron como o despertador do Hermes Agent. Você informa quando a tarefa deve acontecer e escreve, em linguagem normal, o que o agente deve fazer quando aquele horário chegar.

Por exemplo, você pode pedir para o Hermes pesquisar notícias sobre Inteligência Artificial todas as manhãs, gerar um resumo das vendas toda segunda-feira, verificar informações de um projeto a cada quatro horas ou preparar um relatório toda sexta-feira.

O QUE É O CRON DO HERMES AGENT

O cron é o sistema de agendamentos do Hermes Agent. Ele permite cadastrar uma instrução agora e deixar que o Hermes execute essa instrução automaticamente depois.

Imagine que todos os dias às 8h você queira receber um resumo das principais notícias de Inteligência Artificial. Em vez de abrir o Hermes todas as manhãs e escrever o mesmo pedido, você pode criar uma tarefa dizendo:

Todos os dias às 8h, pesquise as principais notícias de Inteligência Artificial e prepare um resumo com as 5 mais importantes.

Depois de criar o agendamento, o Hermes registra essa tarefa e passa a executá-la no horário definido.

O mais importante para quem está começando é entender que você não precisa saber programação para criar esses agendamentos. O Hermes aceita horários escritos de maneira simples, como every 2h, e também aceita o formato tradicional do cron, como 0 8 * * *.

VOCÊ PODE AGENDAR DE 3 FORMAS

Existem três maneiras principais de criar tarefas agendadas no Hermes Agent. Para iniciantes, a primeira é normalmente a mais fácil.

FORMA 1: PEDIR DIRETAMENTE AO HERMES

A maneira mais simples é simplesmente conversar com o Hermes e dizer o que você quer.

Por exemplo:

Todos os dias às 9h, pesquise as principais notícias sobre Inteligência Artificial e faça um resumo com as 5 mais importantes.

O Hermes pode interpretar o pedido e criar o agendamento usando sua ferramenta interna de cron.

Outro exemplo:

Toda segunda-feira às 9h, analise as informações de vendas da última semana e produza um resumo do que aumentou e do que diminuiu.

Para quem nunca usou terminal, essa é a forma mais simples de começar.

FORMA 2: USAR /CRON DENTRO DO HERMES

Também é possível criar o agendamento diretamente na conversa usando o comando /cron.

Por exemplo:

/cron add "every 2h" "Verifique as informações mais recentes e produza um resumo curto"

Vamos separar esse comando em partes para ficar fácil de entender:

/cron: informa ao Hermes que você quer trabalhar com tarefas agendadas.
add: significa adicionar uma nova tarefa.
"every 2h": significa executar a tarefa a cada duas horas.
"Verifique as informações...": é o prompt, ou seja, a instrução que o Hermes deverá executar.

Portanto, você não precisa decorar o comando inteiro. Pense sempre nesta estrutura:

/cron add "QUANDO EXECUTAR" "O QUE O HERMES DEVE FAZER"

FORMA 3: USAR O TERMINAL

Se você instalou o Hermes Agent no computador, também pode administrar os agendamentos pelo terminal.

O terminal é simplesmente uma janela onde você escreve comandos para o computador. No macOS, por exemplo, existe o aplicativo Terminal. No Windows você pode usar ambientes compatíveis com a instalação utilizada pelo Hermes.

No Hermes Agent, o comando começa com:

hermes

Isso é importante porque você poderá encontrar tutoriais usando exemplos como [COMANDO_DO_AGENTE]. No caso do Hermes Agent, não é necessário substituir esse texto por alguma coisa misteriosa. O comando real utilizado no terminal é simplesmente:

hermes

Para trabalhar com agendamentos, acrescentamos cron:

hermes cron

E para criar uma nova tarefa acrescentamos create:

hermes cron create

A estrutura completa fica assim:

hermes cron create "QUANDO EXECUTAR" "O QUE O HERMES DEVE FAZER"

Por exemplo:

hermes cron create "every 2h" "Verifique as principais notícias sobre Inteligência Artificial e faça um resumo"

Traduzindo esse comando para português:

hermes: execute o Hermes Agent.
cron: acesse o sistema de tarefas agendadas.
create: crie uma nova tarefa.
"every 2h": execute a cada duas horas.
O último texto entre aspas é o que o agente deverá fazer.

1. ESCOLHA UMA TAREFA SIMPLES

Se esta é sua primeira automação com o Hermes Agent, não comece tentando automatizar dez etapas de um negócio inteiro.

Escolha uma tarefa repetitiva, fácil de entender e cujo resultado você consiga conferir.

Alguns exemplos:

Pesquisar notícias todos os dias.
Gerar um resumo de informações toda manhã.
Verificar um arquivo regularmente.
Preparar um relatório semanal.
Verificar novidades de determinado assunto.
Resumir informações de uma fonte conectada.

Por exemplo:

Pesquise as principais notícias sobre agentes de IA publicadas nas últimas 24 horas e apresente as 5 mais importantes.

Depois que essa tarefa funcionar corretamente, você pode avançar para automações que consultam arquivos, sistemas, APIs e outras ferramentas conectadas ao Hermes.

2. DEFINA QUANDO A TAREFA DEVE ACONTECER

O Hermes aceita maneiras diferentes de informar o horário.

Para iniciantes, uma das formas mais fáceis é utilizar expressões simples.

Por exemplo:

30m: executar uma vez daqui a 30 minutos.
2h: executar uma vez daqui a 2 horas.
every 30m: executar a cada 30 minutos.
every 2h: executar a cada 2 horas.
every 1d at 09:00: executar todos os dias às 9h.

Por exemplo:

hermes cron create "every 1d at 09:00" "Pesquise as principais notícias de Inteligência Artificial e faça um resumo"

Essa forma costuma ser mais fácil para iniciantes do que decorar números e asteriscos.

3. ENTENDA A EXPRESSÃO CRON

Você também pode encontrar horários escritos desta maneira:

0 9 * * 1

Isso é chamado de expressão cron.

Ela possui cinco posições:

MINUTO HORA DIA-DO-MÊS MÊS DIA-DA-SEMANA

Por exemplo:

0 9 * * 1

Significa:

0: minuto zero.
9: nove horas.
*: qualquer dia do mês.
*: qualquer mês.
1: segunda-feira.

Portanto:

0 9 * * 1

significa toda segunda-feira às 9h.

Alguns exemplos úteis:

0 8 * * *: todos os dias às 8h.
0 9 * * 1: toda segunda-feira às 9h.
0 */4 * * *: a cada quatro horas.
0 18 * * 1-5: de segunda a sexta às 18h.
0 17 * * 5: toda sexta-feira às 17h.

Você não precisa memorizar isso para começar. O Hermes também aceita formas mais fáceis de escrever o horário e pode interpretar pedidos feitos em linguagem natural.

4. CRIE SEU PRIMEIRO AGENDAMENTO

Vamos criar um exemplo simples: todos os dias às 8h, o Hermes deverá pesquisar notícias de Inteligência Artificial e produzir um pequeno resumo.

No terminal:

hermes cron create "0 8 * * *" "Pesquise as principais notícias de Inteligência Artificial das últimas 24 horas e apresente as 5 mais importantes com título e resumo curto"

Não se assuste com o tamanho do comando. Ele possui somente três partes principais:

hermes cron create

Significa: Hermes, crie uma tarefa agendada.

"0 8 * * *"

Significa: execute todos os dias às 8h.

"Pesquise as principais notícias..."

É simplesmente o prompt que o Hermes receberá quando chegar o horário.

Ou seja, a lógica é sempre:

hermes cron create "HORÁRIO" "PROMPT"

5. CRIE UMA AUTOMAÇÃO SEM PRECISAR ENTENDER CRON

Se você achou 0 8 * * * complicado, existe uma alternativa muito mais amigável.

Você pode escrever:

hermes cron create "every 1d at 08:00" "Pesquise as principais notícias de Inteligência Artificial das últimas 24 horas e apresente as 5 mais importantes"

A ideia é exatamente a mesma, mas o horário fica muito mais fácil de interpretar.

Outro exemplo:

hermes cron create "every 2h" "Verifique se existem novidades importantes sobre agentes de IA e faça um resumo curto"

Nesse caso, o Hermes executará a instrução novamente a cada duas horas.

6. VEJA AS TAREFAS QUE VOCÊ CRIOU

Depois de criar um agendamento, é importante confirmar se ele realmente foi registrado.

Digite:

hermes cron list

Esse comando significa simplesmente:

Hermes, mostre todas as tarefas que estão agendadas.

O Hermes mostrará as tarefas cadastradas e informações que permitem identificá-las.

Cada tarefa possui uma identificação. Você poderá utilizar essa identificação, ou em vários comandos o próprio nome da tarefa, para executar, editar, pausar ou excluir o agendamento posteriormente.

7. DÊ UM NOME PARA A TAREFA

Dar um nome ao agendamento pode facilitar bastante quando você tiver várias automações.

Por exemplo:

hermes cron create "every 1d at 08:00" "Pesquise as principais notícias de IA das últimas 24 horas e faça um resumo" --name "Noticias IA"

A parte:

--name "Noticias IA"

serve apenas para dar um nome fácil de reconhecer para essa automação.

Assim, em vez de tentar lembrar uma sequência de identificação, fica muito mais fácil entender qual tarefa você está administrando.

8. TESTE A TAREFA SEM ESPERAR O HORÁRIO

Você não precisa criar uma tarefa para amanhã às 8h e esperar até amanhã para descobrir se ela funciona.

Primeiro veja seus agendamentos:

hermes cron list

Localize a identificação ou o nome da tarefa.

Depois peça para o Hermes executá-la:

hermes cron run "Noticias IA"

Se você estiver usando a identificação da tarefa, poderia ser algo como:

hermes cron run abc123

O abc123 acima é apenas um exemplo. Você deve usar a identificação mostrada pelo seu próprio Hermes.

Esse detalhe é importante: não copie literalmente uma identificação encontrada em um tutorial. Cada tarefa criada possui sua própria identificação.

9. EDITE UMA TAREFA

Você criou a automação, testou e percebeu que gostaria de melhorar o prompt.

Não precisa apagar tudo e começar novamente.

Você pode editar a tarefa.

Por exemplo:

hermes cron edit "Noticias IA" --prompt "Pesquise notícias de Inteligência Artificial publicadas nas últimas 24 horas e apresente somente as 5 mais importantes, explicando em até 3 frases por que cada uma importa"

Também é possível modificar somente o horário:

hermes cron edit "Noticias IA" --schedule "every 1d at 09:00"

Nesse exemplo, a tarefa passa a executar diariamente às 9h.

10. PAUSE UMA AUTOMAÇÃO

Imagine que você queira interromper temporariamente uma tarefa, mas não queira excluí-la.

Use:

hermes cron pause "Noticias IA"

Isso equivale a desligar temporariamente o despertador.

Quando quiser ativá-lo novamente:

hermes cron resume "Noticias IA"

11. EXCLUA UMA AUTOMAÇÃO

Quando não precisar mais da tarefa, você pode removê-la:

hermes cron remove "Noticias IA"

A diferença é simples:

pause: interrompe temporariamente.
resume: ativa novamente.
remove: exclui a tarefa.

12. CONFIRA SE O AGENDADOR ESTÁ FUNCIONANDO

Existe um detalhe importante: não basta cadastrar uma tarefa. O sistema responsável por verificar os horários também precisa estar funcionando.

Você pode conferir o status com:

hermes cron status

O Hermes utiliza seu Gateway para verificar periodicamente quais tarefas chegaram ao horário de execução.

Para uso contínuo, o Gateway precisa permanecer ativo no ambiente onde o Hermes está instalado.

Você pode encontrar comandos como:

hermes gateway

para executar o Gateway diretamente.

Também existe a possibilidade de instalá-lo como um serviço do sistema:

hermes gateway install

Isso é especialmente importante se sua intenção é deixar automações funcionando sem precisar abrir manualmente o Hermes antes de cada execução.

UM EXEMPLO COMPLETO PARA INICIANTES

Imagine que você queira transformar o Hermes em um pequeno radar diário de Inteligência Artificial.

Primeiro, crie a tarefa:

hermes cron create "every 1d at 08:00" "Pesquise as principais notícias de Inteligência Artificial publicadas nas últimas 24 horas. Selecione as 5 mais importantes. Para cada uma, apresente título, resumo curto e explique por que ela é relevante." --name "Radar Diario IA"

Depois confira se ela foi criada:

hermes cron list

Teste imediatamente:

hermes cron run "Radar Diario IA"

Se o resultado estiver bom, não precisa fazer mais nada com o prompt.

Se estiver ruim, edite:

hermes cron edit "Radar Diario IA" --prompt "Pesquise apenas notícias de Inteligência Artificial publicadas nas últimas 24 horas em fontes confiáveis. Escolha as 5 mais relevantes para profissionais que trabalham com IA. Para cada notícia, apresente título, resumo em até 3 frases e por que ela importa."

Essa sequência resume praticamente todo o processo:

CRIAR → LISTAR → TESTAR → REVISAR → EDITAR → DEIXAR EXECUTAR AUTOMATICAMENTE

PROMPTS QUE FUNCIONAM MELHOR

O cron define quando alguma coisa acontecerá. O prompt define o que o Hermes fará.

Por isso, um horário perfeito não resolve um prompt mal escrito.

Compare:

Veja minhas vendas.

com:

Analise os dados de vendas dos últimos 7 dias. Compare com os 7 dias anteriores. Identifique os 3 maiores aumentos e as 3 maiores quedas e produza um resumo com no máximo 10 tópicos.

O segundo exemplo informa período, comparação, quantidade e formato da resposta. Isso torna a execução automática muito mais previsível.

Uma estrutura simples para criar bons prompts de automação é:

CONSULTE [FONTE]
ANALISE [INFORMAÇÕES]
CONSIDERE [PERÍODO]
IDENTIFIQUE [O QUE É IMPORTANTE]
ENTREGUE [FORMATO DA RESPOSTA]

Por exemplo:

Consulte as notícias de Inteligência Artificial publicadas nas últimas 24 horas. Identifique as 5 mais relevantes para empreendedores. Ignore notícias repetidas. Entregue título, resumo curto e impacto prático de cada notícia.

O HERMES PRECISA TER ACESSO À INFORMAÇÃO

O cron não concede novas permissões ao Hermes. Ele apenas determina quando uma instrução será executada.

Se você pedir:

Resuma meus emails não lidos.

o Hermes precisará possuir uma ferramenta ou integração que permita acessar esses emails.

Se você pedir:

Analise o arquivo de vendas.

o Hermes precisará conseguir acessar o arquivo correspondente.

Pense desta maneira:

O cron é o despertador. O prompt é a tarefa. As ferramentas são os braços e os olhos que o Hermes poderá usar para realizar essa tarefa.

COMECE COM AUTOMAÇÕES SEGURAS

Para os primeiros testes, prefira tarefas que apenas pesquisam, analisam ou produzem informações.

Por exemplo:

Pesquisar notícias.
Resumir documentos.
Analisar dados.
Preparar relatórios.
Criar rascunhos.
Verificar mudanças.

Tenha mais cuidado com automações que produzem efeitos externos, como enviar mensagens automaticamente, modificar arquivos importantes, alterar registros ou realizar outras ações em sistemas conectados.

Primeiro faça o Hermes gerar o resultado para sua revisão. Quando você entender como a automação se comporta e confiar no prompt, poderá avaliar níveis maiores de autonomia.

ERROS COMUNS

Se a tarefa não executar, primeiro confira se ela realmente existe:

hermes cron list

Depois confira o agendador:

hermes cron status

Também verifique se o Gateway está funcionando e se o computador ou servidor onde o Hermes está instalado permanece disponível no horário programado.

Se a tarefa executar, mas o resultado for ruim, provavelmente o problema não é o cron. Revise o prompt.

Se a tarefa executar, mas não conseguir consultar determinada informação, verifique se o Hermes possui a ferramenta, integração ou permissão necessária.

Outro ponto importante é o horário do sistema. Se o computador ou servidor estiver configurado com outro fuso horário, uma tarefa aparentemente configurada para 8h pode executar em um horário diferente do esperado.

OS COMANDOS QUE VOCÊ PRECISA LEMBRAR

Depois que você entende a lógica, os principais comandos são poucos:

hermes cron create

Cria uma tarefa.

hermes cron list

Mostra suas tarefas.

hermes cron run

Executa uma tarefa para teste.

hermes cron edit

Edita uma tarefa existente.

hermes cron pause

Pausa uma tarefa.

hermes cron resume

Ativa novamente uma tarefa pausada.

hermes cron remove

Exclui uma tarefa.

hermes cron status

Verifica o funcionamento do sistema de agendamento.

COMECE COM UMA ÚNICA TAREFA

Você não precisa dominar cron, terminal ou programação para começar a usar as automações do Hermes Agent.

Escolha uma tarefa que você já repete durante a semana e transforme-a em um primeiro teste.

A lógica é simples:

QUANDO ISSO DEVE ACONTECER?
+
O QUE O HERMES DEVE FAZER?
=
UMA TAREFA AUTOMÁTICA

Você pode começar simplesmente conversando com o Hermes:

Todos os dias às 8h, pesquise as principais novidades sobre Inteligência Artificial e prepare um resumo com as 5 mais importantes.

Ou criar diretamente pelo terminal:

hermes cron create "every 1d at 08:00" "Pesquise as principais novidades sobre Inteligência Artificial e prepare um resumo com as 5 mais importantes"

Depois disso, teste com hermes cron run, confira o resultado e ajuste o prompt. Quando estiver funcionando como esperado, o Hermes Agent assume a repetição para você.

Você não precisa aprender cron para começar. Primeiro entenda o que quer automatizar, diga ao Hermes quando a tarefa deve acontecer e descreva claramente o resultado que espera.