Quatro jeitos de falar com o agente

Quatro entradas, um agente

Nenhuma das entradas roda um agente próprio. Desde a v0.22, o gateway do profile é o dono das sessões. O terminal, o Desktop, o dashboard e os bots se conectam a ele. Uma conversa é uma fila só, com um único processo gravando no banco ~/.hermes/state.db.

Duas consequências aparecem no uso. Fechar o terminal no meio de uma tarefa só desconecta a conversa: a tarefa continua no gateway. Você retoma depois por qualquer entrada. Além disso, uma skill instalada pelo terminal já está disponível no bot do Telegram, porque todas leem as mesmas pastas do profile.

No terminal: CLI clássica ou TUI

Conectado à VPS por SSH, com o usuário hermes, você conversa com o agente direto no terminal. Há duas interfaces para isso:

As duas retomam conversas antigas. O hermes --tui -c abre a sessão mais recente, o hermes --tui --resume "nome da sessão" abre uma sessão pelo título. O hermes sessions list mostra as sessões gravadas. Na primeira abertura, a TUI instala as dependências de Node.js dela, uma etapa que não se repete.

Dashboard e Desktop usam o mesmo servidor

O dashboard e o Hermes Desktop ligado à VPS dependem de um servidor web do Hermes rodando no servidor, na porta 9119. O hermes dashboard sobe esse servidor e abre o painel no navegador. O hermes serve sobe o mesmo servidor sem o painel, para o app do Desktop se conectar.

Um servidor atende a máquina inteira. Com o hermes serve rodando, o hermes dashboard recusa subir em outro endereço ou porta e informa qual processo ocupa o lugar. Pare o hermes serve antes, ou use --isolated para o dashboard ter um servidor próprio. O hermes serve também precisa continuar rodando depois que a sessão SSH termina. Para isso, a documentação indica um gerenciador de processos, como o systemd.

O login fica no .env do profile: HERMES_DASHBOARD_BASIC_AUTH_USERNAME, HERMES_DASHBOARD_BASIC_AUTH_PASSWORD e um segredo de sessão em HERMES_DASHBOARD_BASIC_AUTH_SECRET, para as sessões continuarem válidas depois de um reinício. A variável HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH aceita um hash scrypt no lugar da senha em texto.

O que o dashboard mostra

O dashboard é a visão da máquina inteira. Pelo seletor de profile na lateral, ele edita a configuração, as chaves, as skills e o modelo de qualquer profile.

• Statusestado do agente e do gateway
• Chatconversa com o agente pelo navegador
• Sessionssessões de todas as entradas, com a origem de cada uma
• Logsregistros do Hermes e do gateway
• Crontarefas agendadas, com pausa e edição
• Profiles e Skillsprofiles da instalação e skills instaladas em cada um
• Channels e Pairingplataformas do gateway e pareamentos pendentes ou aprovados
• Config e API Keysconfiguração e chaves do .env de cada profile

Na aba Sessions, uma conversa iniciada no Telegram aparece ao lado das sessões do terminal, cada uma com a origem marcada. É o jeito mais rápido de conferir o que o agente fez enquanto você estava longe do servidor.

O Hermes Desktop roda no macOS com Apple Silicon, no Windows e no Linux. No Linux, não há pacote do app nas releases: ele abre pelo comando hermes desktop de uma instalação do Hermes. Instalado sozinho no computador, ele usa um Hermes local. Ligado ao hermes serve, ele mostra as sessões, os profiles e as skills da VPS na mesma janela.