Edição Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Configure uma tarefa recorrente do Hermes com skill e verifique a primeira execução

> Crie uma tarefa em pausa do Hermes com skill, confirme as definições e o primeiro relatório agendado e depois coloque em pausa ou recupere a mesma tarefa. Guia baseado apenas na documentação.

By BIG CHANGE Editorial

Published: 2026-10-19T15:09:34.848Z
Updated: 2026-10-19T15:09:34.848Z
Canonical: https://bigchange.ai/blog/hermes-skill-recurring-job-first-run

![Conceptual charcoal illustration of a powered desktop computer on an equipment shelf, with a wall clock nearby.](https://bigchange.ai/api/media/file/hermes-recurring-host-clock-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no Hermes interface, installed skill, actual job, output, provider or run result is depicted.

Quem opera o Hermes pode associar uma skill revista a uma tarefa recorrente para que cada execução comece pelo mesmo procedimento. A verificação útil é saber se uma execução agendada lê a entrada permitida, produz um relatório local aceitável e regista o modelo e o anfitrião que realmente a processaram. Este guia destina-se a quem controla o perfil do Hermes, a conta do fornecedor e o anfitrião do gateway. A BIG CHANGE analisou o [manual oficial de cron](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) e a documentação relacionada em 19 de outubro de 2026; não instalámos o Hermes nem executámos uma tarefa.

## A grande mudança

- **O que mudou:** O Hermes pode carregar uma skill revista antes de uma instrução agendada, executá-la num diretório de trabalho escolhido e guardar o resultado localmente. Pode criar a tarefa em pausa, examiná-la e retomar o mesmo ID de tarefa.
- **Por que importa:** Uma tarefa informativa repetível pode usar um único procedimento revisto. Continua a ser necessário verificar uma execução prevista em relação à entrada permitida; um agendamento guardado não comprova a revisão da skill ou o modelo utilizados, nem a exatidão do relatório.
- **O que observar:** A continuidade depende da disponibilidade do anfitrião do gateway e de a primeira execução cumprir os critérios do relatório. Verifique a tentativa, a saída e os indícios disponíveis de fornecedor/modelo antes de deixar a tarefa ativa; examine novamente o seu estado exato após qualquer interrupção.

## Antes de agendar qualquer coisa

Escolha um ficheiro de entrada pequeno e permitido e um diretório de trabalho existente e isolado. Defina o que um relatório curto correto deve conter, onde deve citar a entrada e que dados em falta devem fazê-lo parar. Mantenha a primeira tarefa apenas informativa: sem publicações externas, alterações de registos ou segredos na saída. Obtenha autorização separada para a tornar recorrente. Também precisa de uma instalação configurada do Hermes, de uma ligação utilizável ao modelo/fornecedor e de credenciais, além de um anfitrião do gateway que possa permanecer disponível para as execuções agendadas. Verifique a versão instalada e `hermes cron create --help`, pois o manual público não informa uma versão para cada opção. O [guia de início rápido](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) descreve a configuração; o [guia de fornecedores](https://hermes-agent.nousresearch.com/docs/integrations/providers) explica o percurso de inferência. Uma conversa única e inofensiva pode verificar esse percurso antes da recorrência, mas não comprova o sucesso de uma execução agendada.

Uma *skill* é um procedimento revisto em `SKILL.md`, não um limite de permissões. Coloque `skills/local-input-report/SKILL.md` no `HERMES_HOME` real do perfil responsável; `~/.hermes/skills/local-input-report/SKILL.md` é o exemplo do perfil predefinido. Antes de utilizar este procedimento mínimo, adapte-o à entrada aprovada e aos critérios do relatório:

```markdown
---
name: local-input-report
description: Report checked facts from one approved local input.
---

Read only <absolute-permitted-input-path> in the job workspace. In a short report, name that file, state only facts supported by it, and cite the relevant part. Flag missing data and stop. Do not send messages or change files or external records.
```

Examine o ficheiro real e confirme que o Hermes o encontra com `hermes skills list` nesse mesmo perfil. Se usar uma skill local do projeto, o [manual de skills](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) indica que uma decisão interativa de confiança e análise deve anteceder uma execução não interativa de cron; o cron não concede confiança por si próprio. Reveja separadamente as ferramentas ativadas e o acesso real aos ficheiros. Registe o conteúdo ou a revisão da skill para que o nome não substitua uma análise.

## Crie uma tarefa e depois examine-a

1. Execute todos os comandos no mesmo perfil responsável: os exemplos abaixo usam o perfil predefinido, enquanto um perfil com nome precisa do respetivo seletor, como `hermes -p NAME`, em todos os comandos. Verifique o modelo atual desse perfil com `hermes model` e o estado do gateway e do processo de verificação periódica com `hermes cron status`. Decida se vai fixar explicitamente o fornecedor e o modelo ou fixar o modelo principal atual. Uma definição por tarefa tem precedência sobre `cron.model` e `cron.model_provider`; estas definições gerais têm precedência sobre o modelo principal atual. Uma tarefa sem modelo fixado pode, por isso, mudar de modelo quando a predefinição aplicável mudar. A configuração guardada continua sem comprovar o modelo utilizado numa execução real.
2. Com a recorrência autorizada, adapte este exemplo de CLI para uma shell POSIX à skill revista e a um diretório de trabalho absoluto e existente. Confirme primeiro cada opção na ajuda instalada. As continuações de linha com barra invertida são sintaxe de shell POSIX; noutra plataforma, use a sintaxe da sua shell. A instrução é deliberadamente restrita e a entrega local mantém a primeira saída no perfil responsável:

```sh
   hermes cron create "every 1h" \
     "Use the attached reviewed skill to read only the permitted input. Return a short local report with its source and missing-data note. Do not send or change external records." \
     --skill local-input-report \
     --name "Local input report" \
     --workdir "/absolute/existing/workspace" \
     --pin \
     --paused --paused-reason "Awaiting owner review"
```

   Substitua o caminho do diretório de trabalho, escolha um nome exclusivo para a tarefa e substitua o marcador de entrada no ficheiro da skill antes de executar este comando. A CLI usa entrega local por predefinição. O [manual de cron](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) também documenta `--model` e `--provider` para uma definição explícita. Se escolher esse percurso, use os identificadores reais de fornecedor/modelo da sua instalação. Não coloque credenciais na instrução nem no histórico da shell. `--workdir` permite ao Hermes encontrar as instruções do diretório de trabalho; sem esta opção, o cron executa separado do repositório. Uma tarefa nova em pausa não tem `next_run_at` até ser retomada.

   A entrega local controla onde é guardado o relatório final. A instrução e todo o conteúdo de entrada utilizado na inferência continuam a seguir o percurso de modelo/fornecedor selecionado; aprove esse fluxo de dados antes de retomar.

3. Guarde o **ID da tarefa** retornado. Use `hermes cron list` para consultar a skill, o diretório de trabalho, a entrega e o estado em pausa; use `hermes cron status` para verificar o estado do agendador. O [código-fonte oficial atual da CLI](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/cron.py) não mostra os campos guardados de modelo/fornecedor nas linhas da lista. Examine o ID exato em `cron/jobs.json` **em modo de leitura apenas** no perfil responsável, para verificar a definição fixada, o modelo/fornecedor e as substituições de inferência guardadas, ou use uma vista de detalhes de tarefa realmente suportada pela versão instalada. Não apresente credenciais. Compare as definições guardadas com o ficheiro, os critérios do relatório e o âmbito aprovados. Corrija esta tarefa com `hermes cron edit <job_id> ...` se necessário; não há motivo para criar outra cópia.
4. Quando puder observar uma execução prevista, use `hermes cron resume <job_id>`. Consulte o instante real da próxima execução e a última verificação bem-sucedida do gateway. O gateway verifica aproximadamente uma vez por minuto; um gateway em primeiro plano exige que o anfitrião permaneça ligado. `hermes cron tick` não inicia um gateway para uma tarefa de agente. Um serviço ou processo preparado para reinícios tem requisitos específicos do anfitrião; verifique o anfitrião escolhido em vez de presumir funcionamento com o portátil desligado ou garantias após um reinício.
5. Após um horário agendado, examine `hermes cron runs <job_id> --limit 20` e o ficheiro correspondente em `cron/output/<job_id>/` no perfil responsável. Compare o relatório com a entrada real e os seus critérios de aceitação. Verifique os horários agendado e de reserva da tentativa, o estado final e qualquer transcrição ou telemetria disponível para identificar o fornecedor e o modelo **realmente usados**. Se os registos instalados não revelarem essa identidade, registe-a como desconhecida. Uma verificação do agendador, uma execução admitida ou o estado `completed` não validam o relatório por si sós.
6. Coloque a tarefa exata em pausa com `hermes cron pause <job_id>` e consulte-a em `hermes cron list`. Isto interrompe futuros agendamentos automáticos; não termina uma tentativa em curso. Uma execução manual explícita é uma intervenção do operador, mesmo durante a pausa. Preserve o histórico e a saída local enquanto decide se a tarefa cumpriu os critérios de aceitação.

## Se falhar, recupere a mesma tarefa

Leia primeiro a tentativa exata e a sua saída, depois os campos da tarefa `last_error`, `last_fire_error` e `last_delivery_error` quando disponíveis. `hermes cron status` distingue um processo de verificação parado ou um armazenamento de cron sem permissão de escrita de uma tarefa que executou e falhou. Verifique o perfil responsável e o anfitrião do gateway antes de alterar as definições do fornecedor: uma shell interativa e um serviço podem ler credenciais diferentes. Corrija apenas a definição afetada, verifique novamente o estado e retome o mesmo ID apenas se o âmbito continuar aprovado. Se a entrega for incerta, examine o destino pretendido antes de tentar novamente; o tempo limite pode ocorrer depois de um adaptador aceitar o envio.

A [secção de recuperação de admissões do manual de cron](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron#admission-recovery) indica que uma execução interrompida ou um disparo preparado não encontrado permanece em pausa para análise; a secção de histórico indica que tentativas desconhecidas nunca são executadas novamente de forma automática. Após um reinício, verifique o estado em pausa da tarefa instalada e a identidade exata da tentativa antes de decidir como a recuperar. Nunca acione duas vezes uma tentativa ativa para testar sobreposição. O Hermes tem um bloqueio da verificação do agendador, uma proteção contra nova admissão para a mesma tarefa em curso e um limite configurável de concorrência geral. Estes controlos não garantem efeitos exatamente uma vez num sistema externo.

A utilização do fornecedor e um anfitrião sempre disponível podem ter custos. Comece com uma entrada limitada e verifique a utilização do fornecedor após a execução prevista antes de escolher uma frequência contínua. O tempo limite documentado do **script** anterior à execução não limita uma interação com o modelo orientada por skill nem a respetiva cobrança; os limites de limpeza e inatividade são separados. Um prazo escrito na instrução é uma indicação, não um controlo rígido de despesas. Se não puder tolerar uma interação com o modelo sem limite ou um efeito secundário incerto, mantenha a tarefa em pausa até dispor de controlos adequados. Este guia descreve comportamento documentado, não uma execução medida, um preço, um resultado de fiabilidade ou uma alegação de poupança.

## Sources

- [Tarefas agendadas (Cron)](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) — Referência principal de comandos, modelo, gateway, histórico, pausa, entrega e recuperação; página atual verificada em 19/10/2026, sem versão indicada.
- [Automatize tarefas com Cron](https://hermes-agent.nousresearch.com/docs/guides/automate-with-cron) — Exemplos de automação recorrente e apoiada por skills.
- [Sistema de skills](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) — Arquivo da skill, descoberta, confiança no projeto e inspeção.
- [Início rápido do Hermes Agent](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) — Configuração e ligação inicial ao fornecedor.
- [LLMs e fornecedores de modelos](https://hermes-agent.nousresearch.com/docs/integrations/providers) — Configuração do fornecedor e contexto de credenciais.
- [Interface de linha de comando](https://hermes-agent.nousresearch.com/docs/user-guide/cli) — Contexto geral da CLI; opções específicas de cron verificadas no manual de cron.
- [Configuração do Hermes Agent](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) — Contexto de configuração e definições de ferramentas/modelos.
- [Código-fonte oficial da CLI de cron do Hermes](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/cron.py) — Branch main atual verificada em 19/10/2026: campos das linhas da lista, incluindo skill, diretório de trabalho e entrega, mas não modelo/fornecedor guardados; branch em evolução, versão instalada não observada.
- [Código-fonte oficial dos caminhos de perfil do Hermes](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/profiles.py) — Branch main atual verificada em 19/10/2026: resolução de HERMES_HOME para perfis predefinidos e com nome; versão instalada não observada.