Automatizar tarefas repetitivas com Python e Hermes Agent

Ler ficheiros CSV, fazer scraping de dados na Web ou formatar relatórios semanais são apenas alguns exemplos de tarefas repetitivas que consomem horas do teu dia. A boa notícia é que podes automatizar todo esse trabalho manual combinando a flexibilidade da linguagem Python com o poder de orquestração do Hermes Agent.

Porquê combinar Python com o Hermes Agent?

O Python é a linguagem de eleição para manipulação de dados, web scraping e automação de sistemas. No entanto, criar lógica condicional complexa para interpretar textos não estruturados ou gerar resumos executivos em código puro pode ser extremamente moroso. É aqui que entra o Hermes Agent.

Ao integrar scripts Python com o Hermes Agent, obténs o melhor de dois mundos:

• Precisão técnica do Python: Processamento rápido de ficheiros locais, parsing de JSON/CSV e chamadas a APIs externas.
• Raciocínio da IA do Hermes Agent: Análise contextual, geração de resumos em linguagem natural e tomada de decisão autónoma através de skills.

Tutorial Prático: Criar um Fluxo de Automação Completo

Neste tutorial, vamos construir uma automação que lê um ficheiro CSV com dados de vendas através de Python, envia os dados processados para o Hermes Agent e gera automaticamente um relatório executivo em Markdown.

Passo 1: Criar o script Python para processamento de dados

Primeiro, criamos um script simples em Python chamado processar_vendas.py. Este script lê o ficheiro CSV, calcula o total de vendas e resume os produtos mais vendidos em formato JSON.

import csv
import json
import sys

def analisar_vendas(caminho_ficheiro):
    total_vendas = 0.0
    produtos = {}

    with open(caminho_ficheiro, mode='r', encoding='utf-8') as f:
        leitor = csv.DictReader(f)
        for linha in leitor:
            valor = float(linha.get('valor', 0))
            produto = linha.get('produto', 'Desconhecido')
            total_vendas += valor
            produtos[produto] = produtos.get(produto, 0) + valor

    resultado = {
        "total_faturado": round(total_vendas, 2),
        "resumo_produtos": produtos
    }
    return json.dumps(resultado, ensure_ascii=False)

if __name__ == "__main__":
    if len(sys.argv) > 1:
        ficheiro = sys.argv[1]
        print(analisar_vendas(ficheiro))

O que o código faz: O script abre o ficheiro CSV indicado no terminal, percorre cada linha acumulando o valor das vendas e agrupando por produto. Por fim, devolve uma string JSON estruturada no terminal, ideal para ser lida por agentes de IA.

Passo 2: Definir a Skill no Hermes Agent em YAML

Agora, vamos criar uma skill personalizada no Hermes Agent. Guarda o seguinte ficheiro em ~/.hermes/skills/gerar_relatorio.yaml.

name: gerar_relatorio
description: Processa dados de vendas com Python e gera um relatório executivo analítico.
author: MarcTechJA
version: "1.0"
inputs:
  caminho_csv: { type: string, description: "Caminho para o ficheiro CSV de vendas", required: true }
steps:
  - name: executar_script
    action: tools.shell.run
    params:
      command: "python3 processar_vendas.py { inputs.caminho_csv }"
  - name: gerar_analise_ia
    action: llm.generate
    params:
      prompt: "Com base nos seguintes dados processados de vendas em JSON: { steps.executar_script.output }, cria um relatório executivo sucinto em português. Destaca o produto com maior faturação e fornece 2 recomendações estratégicas."
  - name: guardar_relatorio
    action: tools.file.write
    params:
      path: "relatorio_final.md"
      content: "{ steps.gerar_analise_ia.output }"
outputs:
  relatorio: "{ steps.gerar_analise_ia.output }"

O que a skill faz: A skill recebe como parâmetro o caminho do CSV, executa o script Python através do tools.shell.run, passa o resultado numérico diretamente para o modelo de linguagem no passo llm.generate para análise estratégica e grava o documento final num ficheiro relatorio_final.md.

Passo 3: Executar a automação no terminal

Com a skill configurada, basta executar um único comando no teu terminal para correr todo o fluxo de trabalho automatizado:

hermes run gerar_relatorio --caminho_csv vendas_agosto.csv

Em poucos segundos, o Hermes Agent executa o script Python em segundo plano, analisa os números recolhidos e gera um relatório executivo completo pronto a ser partilhado com a tua equipa.

Boas Práticas para Automações de Alto Impacto

• Valida sempre os dados de entrada: Garante que os teus scripts Python tratam exceções e devolvem mensagens claras em caso de ficheiro em falta ou dados inválidos.
• Aproveita os modelos locais: Para tarefas mais simples e privadas, podes configurar o Hermes Agent com modelos locais via Ollama (como Llama 3.1 ou Phi-4-mini), mantendo os teus dados 100% no teu computador.
• Cria automações modulares: Divide grandes processos em pequenas skills especializadas que podem ser reutilizadas em diferentes fluxos de trabalho.

Conclusão

Unir a robustez de scripts Python à capacidade analítica e de orquestração do Hermes Agent permite transformar tarefas manuais demoradas em fluxos de trabalho totalmente automatizados e inteligentes. Em vez de passares horas a copiar dados e criar documentos repetitivos, podes focar a tua energia no que realmente importa: a tomada de decisões estratégicas.