Tutorial 14: Perfis — Vários Agentes, Uma Máquina

Então você tem aproveitado o Hermes Agent, mas agora está pensando: “E se eu pudesse rodar um assistente de codificação e um bot de pesquisa na mesma máquina, sem que eles atrapalhassem um ao outro?” É exatamente para isso que servem os perfis.

O Que São Perfis?

Pense em um perfil como uma casa separada para cada agente Hermes. Cada perfil tem seu próprio diretório contendo seu próprio config.yaml, .env, SOUL.md, memórias, sessões, habilidades, tarefas agendadas e banco de dados de estado. Isso significa que você pode rodar um assistente de codificação, um bot pessoal e um agente de pesquisa lado a lado — cada um com suas próprias chaves de API, personalidade e memória — sem que nenhum deles misture as coisas.

Aviso importante: Nunca aponte dois processos de agente para o mesmo perfil. Ambos escrevem memória automaticamente, e cada um carrega as escritas do outro no prompt do sistema no início da sessão. Dois escritores em uma mesma casa vão acumular o estado um do outro até que ele deixe de ser qualquer coisa que você configurou. Os perfis existem exatamente para evitar isso. Se os agentes precisarem de memória compartilhada, use um provedor de memória externo.

Início Rápido

Começar é incrivelmente simples:

hermes profile create coder       # cria o perfil + alias de comando "coder"
coder setup                       # configura chaves de API e modelo
coder chat                        # começa a conversar

Pronto! No momento em que você cria um perfil, ele se torna seu próprio comando. Crie um chamado coder e você imediatamente terá coder chat, coder setup, coder gateway start e assim por diante.

Criando um Perfil

Você tem algumas opções ao criar um perfil:

Perfil em branco — começa do zero com as habilidades integradas:

hermes profile create mybot

Depois execute mybot setup para configurar chaves de API, modelo e tokens do gateway.

Clonar apenas a configuração — copia o config.yaml, .env, SOUL.md e habilidades do seu perfil atual:

hermes profile create work --clone

Mesmas chaves de API e capacidades, mas sessões e memória novas. Edite ~/.hermes/profiles/work/.env para chaves de API diferentes, ou ~/.hermes/profiles/work/SOUL.md para uma personalidade diferente.

Clonar tudo — um snapshot completo e funcional:

hermes profile create backup --clone-all

Isso copia configuração, chaves de API, personalidade, todas as memórias, habilidades, tarefas agendadas e plugins. O histórico específico do perfil é excluído (histórico de sessões, bancos de dados de estado, backups), pois pode chegar a dezenas de gigabytes. Para um backup completo incluindo histórico, use hermes profile export ou hermes backup.

Clonar de um perfil específico:

hermes profile create work --clone-from coder

Combine com --clone-all para uma cópia completa desse perfil de origem.

Dica profissional: Se você planeja usar um perfil como trabalhador kanban, passe --description "<função>" na criação para que o orquestrador saiba no que ele é bom:

hermes profile create researcher --description "Lê código-fonte e documentação externa, escreve descobertas."

Usando Perfis no Dia a Dia

Aliases de comando — todo perfil recebe automaticamente um alias de comando:

coder chat                    # conversa com o agente coder
coder setup                   # configura as definições do coder
coder gateway start           # inicia o gateway do coder
coder doctor                  # verifica a saúde do coder
coder skills list             # lista as habilidades do coder
coder config set model.default anthropic/claude-sonnet-4

A flag -p — você também pode mirar um perfil explicitamente com qualquer comando:

hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "olá"    # funciona em qualquer posição

Padrão fixo — defina um padrão para que comandos simples do hermes mirem esse perfil:

hermes profile use coder
hermes chat                   # agora mira o coder
hermes profile use default    # volta ao padrão

É como kubectl config use-context — simples e eficaz.

Sabendo onde você está — a CLI sempre mostra qual perfil está ativo:

Prompt: coder ❯ em vez de ❯
Banner: Mostra Profile: coder na inicialização
hermes profile: Mostra o nome do perfil atual, caminho, modelo e status do gateway

Perfis vs Workspaces vs Sandboxes

Esses conceitos são frequentemente confundidos, mas são coisas diferentes:

Um perfil dá ao Hermes seu próprio diretório de estado: configuração, memória, sessões, logs, tarefas agendadas e estado do gateway.
Um workspace ou diretório de trabalho é onde os comandos de terminal começam — controlado separadamente por terminal.cwd.
Uma sandbox limita o acesso ao sistema de arquivos. Perfis não colocam o agente em sandbox.

No backend de terminal padrão local, o agente ainda tem o mesmo acesso ao sistema de arquivos que sua conta de usuário. Um perfil não impede que ele acesse pastas fora do diretório do perfil.

Concluindo

Perfis são a maneira mais limpa de rodar múltiplos agentes Hermes independentes em uma máquina. Cada um tem sua própria identidade, memória e configuração — e eles nunca precisam saber que o outro existe. Experimente com hermes profile create e veja como seu fluxo de trabalho multiagente fica mais suave!