Discord — IA no Seu Servidor

Discord — IA no Seu Servidor

Então você quer colocar o Hermes Agent no seu servidor do Discord? Ótima escolha. Este guia mostra tudo o que você precisa saber — desde como o Hermes se comporta depois de convidado, até o processo completo de configuração, incluindo alguns recursos importantes de verificação de saúde.

Vamos começar pela parte divertida: como é realmente conversar com o Hermes no Discord.

Como o Hermes se Comporta no Seu Servidor

O Hermes não é só um bot burro que responde a tudo. Ele é inteligente sobre quando e onde fala. Veja a tabela:

Contexto	Comportamento
Mensagens diretas	O Hermes responde a toda mensagem. Sem necessidade de @mention. Cada DM tem sua própria sessão privada.
Canais do servidor	Por padrão, o Hermes só responde quando você o marca com @mention. Caso contrário, ele fica quieto.
Canais de resposta livre	Quer um canal onde as pessoas possam conversar sem marcar ninguém? Adicione-o em DISCORD_FREE_RESPONSE_CHANNELS e o Hermes responderá a cada mensagem inline.
Threads	O Hermes responde na mesma thread. As regras de menção continuam valendo, a menos que a thread ou o canal pai seja de resposta livre.
Canais compartilhados	Por padrão, o Hermes mantém o histórico de conversa de cada usuário separado — mesmo no mesmo canal. Alice e Bob conversando em #pesquisa têm duas sessões independentes.
Mensagens mencionando outros	Se alguém marcar outro usuário, mas não o Hermes, o bot fica em silêncio por padrão. Ele não entra em conversas que não são direcionadas a ele.

Dica de profissional: Quer um canal dedicado de ajuda do bot onde as pessoas possam simplesmente digitar e obter respostas? Adicione esse canal a DISCORD_FREE_RESPONSE_CHANNELS e pronto.

O Modelo de Gateway: Mais que um Simples Webhook

Aqui vai algo importante: o Hermes no Discord não é um webhook simples que dispara uma resposta pronta. Cada mensagem passa por um pipeline completo:

1. Verificação de autorização (DISCORD_ALLOWED_USERS)
2. Verificações de menção / resposta livre
3. Busca de sessão
4. Carregamento do histórico da sessão
5. Execução completa do agente — ferramentas, memória, comandos de barra
6. Envio da resposta de volta ao Discord

Isso significa que cada resposta é alimentada pela inteligência completa do Hermes, não apenas uma resposta programada.

Sessões: Quem Compartilha o Quê?

Por padrão, o Hermes isola as conversas:

• Cada DM recebe sua própria sessão
• Cada thread recebe seu próprio namespace de sessão
• Cada usuário em um canal compartilhado recebe sua própria sessão

Isso é controlado no config.yaml:

group_sessions_per_user: true

Se você quiser uma conversa compartilhada para uma sala inteira (útil para espaços colaborativos), defina como false:

group_sessions_per_user: false

Mas cuidado: sessões compartilhadas significam contexto compartilhado e custos de tokens compartilhados. Uma tarefa longa e pesada de ferramentas de uma pessoa pode inflar o contexto de todos. E se alguém interromper no meio da execução, pode atrapalhar a sala inteira.

Interrupções e Concorrência

Com sessões por usuário (o padrão), a Alice pode interromper a própria solicitação sem afetar a conversa do Bob no mesmo canal. O Bob mantém o histórico dele, a Alice mantém o dela, e ninguém pisa no pé de ninguém.

Com sessões compartilhadas, a sala inteira compartilha um único “slot de agente em execução”. Mensagens de acompanhamento de pessoas diferentes podem interromper ou ficar na fila umas das outras. Divertido para colaboração, mas potencialmente caótico.

Novo: Verificações de Saúde do Gateway WebSocket

Aqui vai uma melhoria recente que vale a pena conhecer. O Discord tem dois transportes separados: REST e o Gateway WebSocket. Uma chamada REST bem-sucedida não prova que o bot ainda consegue receber eventos em tempo real.

O Hermes agora monitora a saúde do gateway verificando:

• Estado de prontidão
• Estado de fechamento do cliente/socket
• Abertura do socket
• Idade do ACK do heartbeat
• Latência do heartbeat

Após um número configurado de amostras não saudáveis, o adaptador emite um evento fatal com possibilidade de nova tentativa e reconecta de forma limpa. Sem loops infinitos de reconexão.

Configure os limites no config.yaml:

discord:
  websocket_liveness_interval_seconds: 15
  websocket_liveness_failure_threshold: 2
  websocket_heartbeat_ack_max_age_seconds: 60
  websocket_max_latency_seconds: 30

Observação: os nomes antigos liveness_interval_seconds e liveness_failure_threshold ainda funcionam como aliases de compatibilidade, mas não significam mais sondagem REST.

Passo 1: Criar um Aplicativo no Discord

1. Acesse o Portal de Desenvolvedores do Discord e faça login.
2. Clique em New Application no canto superior direito.
3. Dê um nome ao seu aplicativo (ex.: “Hermes Agent”) e aceite os Termos de Serviço para Desenvolvedores.
4. Clique em Create.

Você vai parar na página General Information. Anote seu Application ID — você vai precisar dele para montar a URL de convite.

Passo 2: Criar o Bot

1. Na barra lateral esquerda, clique em Bot.
2. O Discord cria automaticamente um usuário bot para o seu aplicativo. Personalize o nome de usuário se quiser.
3. Em Authorization Flow, defina Public Bot como ON — necessário para o link de convite fornecido pelo Discord.

Essa é a base. A partir daqui, você vai pegar o token do bot, definir suas variáveis de ambiente e convidar o Hermes para o seu servidor. Antes que você perceba, seu assistente de IA estará bem ali no Discord — pronto para conversar, usar ferramentas e lembrar do contexto, tudo em tempo real.