Hermes Agent Publica Automaticamente

O Hermes Agent pode ser configurado para publicar conteúdo automaticamente no teu blog. Com skills personalizadas e integração com GitHub Actions, todo o processo de geração e publicação de artigos pode ser automatizado.

Como funciona a automação

O sistema usa três componentes principais:

• Skill do Hermes Agent — para gerar conteúdo com IA
• Script de publicação — que cria o HTML, atualiza o arquivo e faz commit
• GitHub Actions — para executar o processo diariamente

Skill YAML para gerar artigos

Podes criar uma skill no Hermes Agent que gera artigos automaticamente. Exemplo de configuração:

name: gerar-artigo
description: Gera um artigo de blog com base num tópico
author: MarcTechJA
version: "1.0"

inputs:
  topico:
    type: string
    description: Tema do artigo a gerar
    required: true

steps:
  - name: gerar_conteudo
    action: llm.generate
    params:
      prompt: |
        Gera um artigo sobre automação com Hermes Agent em português de Portugal.
        Tópico: {{ inputs.topico }}
  - name: guardar_html
    action: tools.file.write
    params:
      path: artigo.html
      content: "{{ steps.gerar_conteudo.output }}"
  - name: publicar
    action: tools.shell.run
    params:
      command: bash scripts/post.sh "Título do Artigo" "Categoria" "Autor" artigo.html

outputs:
  status: "Artigo publicado com sucesso"

Publicação diária automática

Com o GitHub Actions, podes agendar a publicação para correr todos os dias. O workflow:

1. Faz checkout do repositório
2. Executa o script de geração de conteúdo
3. O script cria o HTML, atualiza o blog archive e a homepage
4. Faz commit e push automáticos
5. O GitHub Pages deploys as alterações

Vantagens desta automação

• Consistência: publica todos os dias sem falhar
• SEO: cada artigo tem meta tags, Open Graph e slugs corretos
• Escalável: funciona para 1 ou 100 artigos por dia
• Grátis: GitHub Actions tem minutos gratuitos para repos públicos

Com o Hermes Agent a gerar o conteúdo e o GitHub Actions a publicar, o teu blog mantém-se atualizado sem intervenção manual.

Workflow completo no GitHub Actions

Para executar este processo diariamente, cria o ficheiro .github/workflows/publicar.yml no repositório do blog:

name: Publicação Automática
on:
  schedule:
    - cron: '0 9 * * *'
  workflow_dispatch:

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - name: Instalar dependências
        run: pip install -r requirements.txt
      - name: Gerar e publicar artigo
        run: |
          python scripts/generate-post.py
      - name: Commit e push
        run: |
          git config user.name "Hermes Agent"
          git config user.email "marctechja@gmail.com"
          git add .
          git diff --cached --quiet || git commit -m "artigo: publicação automática"
          git push
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}

Porque é que esta automação funciona

O segredo está na separação de responsabilidades:

• O Hermes Agent trata da parte criativa — escolher o tema, escrever o conteúdo e garantir a qualidade.
• O script de publicação trata da parte técnica — criar o HTML com o template, gerar as meta tags, atualizar o arquivo do blog e a homepage.
• O GitHub Actions trata da parte de operação — agendar, executar e fazer o deploy automático via GitHub Pages.

Assim, se uma peça falhar (por exemplo, a API do modelo estar temporariamente indisponível), a falha fica isolada e é visível no histórico de runs do GitHub, sem afetar as restantes peças.

Validação de qualidade antes de publicar

Publicar todos os dias não basta — o conteúdo tem de ser válido. O script de geração deve validar antes do commit:

• Conteúdo truncado — rejeitar artigos cortados a meio (por exemplo, tags ou blocos de código sem fecho).
• Comentários HTML — remover ou rejeitar comentários <!-- --> no corpo, que podem partir o layout.
• Meta descriptions completas — sem cortes a meio da frase e sem aspas não escapadas.
• Estrutura — sem <h1> no corpo e sem repetição do título no primeiro heading.

Se a validação falhar, o script regenera o artigo e tenta novamente; só avança para o commit quando o conteúdo passa nos testes.

Monitorização e recuperação

Uma automação sem monitorização é uma automação cega. Recomenda-se:

1. Correr um health check diário que valide o HTTP 200 das páginas e a presença do artigo esperado.
2. Configurar uma notificação (email ou mensagem) quando uma run falhar.
3. Manter o histórico de runs visível — o GitHub Actions já mostra a listagem de execuções com o respetivo estado.

Com estes passos, o problema é detetado no próprio dia e corrigido antes de se acumular.

Perguntas Frequentes

O GitHub Actions gratuito chega?

Sim. Em repositórios públicos, os minutos de execução são gratuitos, e a geração de um artigo por dia usa apenas uma fração do limite mensal.

E se um dia falhar a publicação?

A falha fica registada na run correspondente. No dia seguinte, basta corrigir a causa e correr o workflow manualmente — ou deixar que o agendamento continue normalmente.

Posso publicar mais do que um artigo por dia?

Sim. O mesmo mecanismo funciona para N artigos: basta chamar o script de geração várias vezes, cada uma com um tópico diferente da lista de rotação.

Conclusão

Com o Hermes Agent a gerar o conteúdo e o GitHub Actions a publicar, o teu blog mantém-se atualizado sem intervenção manual. É um sistema que combina criatividade, automatização e consistência — e que este próprio site usa para publicar um artigo novo todos os dias.