Google Chat — IA no Google Workspace | Easy Understand Hermes Agent

Imagine seu assistente de IA finalmente com um lugar à mesa do escritório — bem dentro do Google Chat, onde seu time já conversa o dia todo.

É exatamente isso que o Hermes Agent entrega. Em vez de configurar um servidor web público, um túnel, ou brigar com certificados TLS, você conecta seu bot ao Google Chat do mesmo jeito que conecta um fone de ouvido: simplesmente funciona. O Hermes escuta em uma assinatura privada e, quando alguém envia uma mensagem para o bot, ele responde pela API REST do Chat. Sem portas expostas, sem regras de firewall, sem pânico às 3 da manhã com “por que minha URL caiu?”.

O Que Você Vai Precisar

Um projeto no Google Cloud (o plano gratuito é suficiente)
Uma conta do Google Workspace (pessoal ou de trabalho, com direitos de administrador)
Cerca de 15 minutos

Passo 1: Criar um Projeto no Google Cloud

Acesse console.cloud.google.com e crie um projeto. Anote o ID do projeto — você vai usá-lo em tudo. Pense nele como o endereço da sua casa do bot.

Passo 2: Ativar Duas APIs

Em APIs & Services → Library, ative:

Google Chat API
Cloud Pub/Sub API

Ambas são gratuitas para tráfego pessoal de bots. Clique, ative, pronto.

Passo 3: Criar uma Conta de Serviço (o Crachá do Bot)

Vá em IAM & Admin → Service Accounts → Create Service Account. Dê o nome de hermes-chat-bot. Pule as permissões de nível de projeto — você não precisa delas.

Depois, crie uma chave JSON e baixe-a. Guarde-a em um lugar seguro:

mkdir -p ~/.hermes
mv ~/Downloads/hermes-chat-bot-key.json ~/.hermes/google-chat-sa.json
chmod 600 ~/.hermes/google-chat-sa.json

Um erro comum: procurar por um papel de IAM chamado “Chat Bot Caller”. Ele não existe. A autoridade do seu bot vem de ser adicionado a um espaço, não de papéis de IAM. Não complique.

Passo 4: Criar o Tópico e a Assinatura do Pub/Sub

Em Pub/Sub → Topics → Create topic, use hermes-chat-events como ID do tópico. Depois, crie uma assinatura pull:

ID da assinatura: hermes-chat-events-sub
Tipo de entrega: Pull
Retenção de mensagens: 7 dias

É nessa assinatura que o Google Chat deixa cair as mensagens recebidas. O Hermes puxa de lá, como quem verifica uma caixa de correio.

Passo 5: Conectar o Hermes Agent

Agora a mágica. Execute:

hermes gateway setup

Escolha Google Chat, e o assistente guia você pelo resto. Ele pede seu ID do projeto, o nome da assinatura e o caminho para o JSON da conta de serviço. Só isso.

O Resultado

Você agora tem um bot de IA dentro do Google Chat. Seu time pode mencioná-lo com @, fazer perguntas, acionar automações ou delegar tarefas — tudo sem sair da janela de chat. Sem túneis, sem IP público, sem renovações de certificado.

Resumo & Dica Prática

O Hermes Agent transforma o Google Chat em um centro de comando para seus fluxos de trabalho com IA. A configuração é propositalmente simples: uma conta de serviço para identidade, uma assinatura para escutar e a API REST para responder.

Dica prática: Depois de terminar a configuração, teste com uma única mensagem direta para o seu bot antes de adicioná-lo a um espaço em grupo. Se ele responder, está tudo certo. Se não, verifique se sua conta de serviço tem o papel roles/pubsub.subscriber na assinatura — essa é a causa nº 1 de silêncio.

Agora vá dar ao seu time um colega de IA que realmente aparece nas reuniões.