Como instalar o Hermes Agent na Saplo (agente de IA em mensageiros)

Antes de começares, uma coisa logo de início: o Hermes Agent não tem um painel web. Não tem ecrã de login, não tem dashboard com gráficos, não tem nada que se mostre no navegador depois de acederes ao domínio. Toda a configuração, desde a chave do modelo de linguagem até à ligação do bot ao Telegram, é feita no terminal. Se procuras um chatbot pronto com uma interface clicável, esta não é a aplicação ideal, no catálogo da Saplo encontrarás outras ferramentas mais adequadas. O Hermes Agent é para outra pessoa: para um programador ou agência que queira ter o seu próprio agente de IA ligado a comunicadores, sem ter de escrever integrações com a API do modelo do zero e sem pagar uma subscrição mensal por uma plataforma SaaS que, no fundo, faz a mesma coisa. Se isto descreve a tua situação, abaixo tens o passo a passo de como instalar o Hermes Agent na Saplo.

Para quem é o Hermes Agent

Antes de instalares, verifica se esta ferramenta se adequa realmente ao que queres fazer:

• estás a criar um bot para responder por ti no Telegram, Discord ou Slack - o Hermes Agent conecta-se ao serviço de mensagens escolhido e conversa com os utilizadores em teu nome, usando o modelo de linguagem que tu indicares,
• não queres escrever a tua própria integração com a API do modelo - o suporte para webhooks, filas de mensagens e a manutenção da conexão com o serviço de mensagens já estão na imagem Docker, tu só precisas de fornecer as chaves,
• preferes pagar uma vez pela Box do que mensalmente por uma plataforma SaaS - o Hermes Agent é open source, não tem uma subscrição separada, pagas apenas pela Box onde está alojado,
• não te importas com a configuração via terminal - se esperas um assistente no navegador, esta aplicação vai desiludir-te, aqui tudo acontece no SSH.

Se procuras um chatbot pronto para suporte ao cliente com um painel de administração, verifica outras opções no catálogo de aplicações, lá encontrarás ferramentas com interface web.

Requisitos

Para instalares o Hermes Agent no Saplo, precisas de:

• Uma Box no plano L ou superior, porque a primeira configuração requer acesso SSH através do Terminal Online, e os planos inferiores não o têm.
• Mínimo de 1,5 GB de RAM livre e 8 GB de espaço em disco.
• Um domínio ou subdomínio *.saploapp.pl incluído em cada plano, sob o qual será alojada a página de informações (o Hermes é headless, por isso, no domínio, verás apenas as instruções, não o painel).
• Uma chave API para o modelo de linguagem, que fornecerás durante a configuração no terminal, e um token de bot para o comunicador ao qual o Hermes se irá conectar.
• NÃO precisas de uma base de dados separada, toda a configuração e o histórico de conversas são armazenados num volume Docker nomeado.

Instalação passo a passo

1. No Painel Saplo, acede ao Catálogo de aplicações e seleciona Hermes Agent (categoria "Aplicações AI").
2. Indica um Box do plano L ou superior com um mínimo de 1,5 GB de RAM livre e o domínio ou subdomínio onde será alojada a página informativa.
3. Confirma a instalação. O motor instala o Docker CE, se ainda não estiver no Box, descarrega a imagem oficial nousresearch/hermes-agent (cerca de 900 MB) e executa o contentor sem porta HTTP exposta, todo o tráfego permanece dentro do contentor.
4. Após o arranque, o motor verifica se o contentor está realmente a funcionar e se não entrou num ciclo de reinícios, em vez de parar apenas em docker compose up sem verificação.
5. Uma página estática com instruções de configuração aparece no domínio especificado, uma vez que o Hermes não expõe a sua própria interface web.

Primeira configuração

1. No Painel Saplo, acede ao Terminal Online da Box onde está o Hermes (requer um plano L ou superior).
2. Executa o assistente de configuração com o comando docker exec -it hermes-<slug> hermes setup, onde <slug> é o nome da tua instalação visível no painel.
3. No assistente interativo, introduz a chave API para o modelo de linguagem e o token do bot para o comunicador escolhido (Telegram, Discord ou Slack).
4. Após concluíres o assistente, o agente conecta-se automaticamente ao comunicador, sem necessidade de reiniciar o contentor.
5. Podes ver o estado do agente em tempo real com o comando docker logs -f hermes-<slug> no mesmo Terminal Online.

Hermes Agent na Saplo vs. alternativas

Perguntas Frequentes

O Hermes Agent tem um painel web? Não, a aplicação é headless. No domínio que indicares durante a instalação, apenas verás uma página estática com instruções de configuração; o agente em si corre num contentor Docker e não expõe qualquer interface no navegador.

Porque é que a instalação requer o plano Box L e não um inferior? Porque a primeira configuração é feita via Terminal Online, ou seja, acesso SSH ao contentor, e este só está disponível a partir do plano Box L. Em planos inferiores, podes ter o contentor, mas não consegues configurar o agente.

Que modelo de linguagem pode o Hermes Agent usar? Forneces a tua própria chave API durante a configuração no assistente hermes setup, então a escolha do modelo depende do provedor a que tens acesso. O Saplo não impõe um provedor específico nem cobra taxas por consultas ao modelo.

Onde é guardado o histórico de conversas do agente? Num volume Docker nomeado no teu Box. Esse mesmo volume sobrevive à limpeza do catálogo de aplicações, então a configuração e o histórico não desaparecem durante as operações normais no Box.

Posso conectar o Hermes Agent a mais de um comunicador ao mesmo tempo? O assistente hermes setup guia-te pela configuração do comunicador passo a passo, então se quiseres suportar mais de um canal, executa o assistente novamente e adiciona outra conexão no mesmo contentor.

Se queres ter o teu próprio agente de IA no Telegram, Discord ou Slack sem escrever integrações do zero e sem uma subscrição SaaS, e se o terminal não te assusta, podes configurar o Hermes Agent no Saplo em poucos minutos. Contacta-nos se precisares de ajuda com a primeira configuração.