Google Chat — Google Workspace의 AI | Easy Understand Hermes Agent

Google Chat — Google Workspace에서 만나는 AI

이제 당신의 AI 어시스턴트가 마침내 사무실 책상에 자리를 잡았습니다. 바로 팀이 하루 종일 대화하는 Google Chat 안에 말이죠.

Hermes Agent가 정확히 그걸 실현해 줍니다. 공개 웹 서버를 설정하거나, 터널을 뚫거나, TLS 인증서와 씨름할 필요 없이, 헤드폰을 꽂듯이 그냥 연결하면 됩니다. Hermes는 비공개 구독을 통해 메시지를 듣고, 누군가 봇에게 메시지를 보내면 Chat REST API를 통해 응답합니다. 열린 포트도, 방화벽 규칙도, 한밤중의 “왜 내 URL이 죽었지?” 같은 패닉도 없습니다.

준비물

Google Cloud 프로젝트 (무료 티어로 충분)
Google Workspace 계정 (개인 또는 업무용, 관리자 권한 포함)
약 15분의 시간

1단계: Google Cloud 프로젝트 만들기

console.cloud.google.com에 접속해서 프로젝트를 만드세요. 프로젝트 ID를 메모해 두세요. 모든 곳에서 사용하게 됩니다. 봇의 집 주소라고 생각하면 됩니다.

2단계: 두 개의 API 활성화

API 및 서비스 → 라이브러리에서 다음을 활성화하세요:

Google Chat API
Cloud Pub/Sub API

둘 다 개인 봇 트래픽에는 무료입니다. 클릭하고, 활성화하고, 끝.

3단계: 서비스 계정 만들기 (봇의 출입증)

IAM 및 관리자 → 서비스 계정 → 서비스 계정 만들기로 이동하세요. 이름은 hermes-chat-bot으로 지정합니다. 프로젝트 수준 권한은 건너뛰어도 됩니다. 필요 없습니다.

그런 다음 JSON 키를 생성하고 다운로드하세요. 안전한 곳에 보관합니다:

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

흔한 실수: “Chat Bot Caller” IAM 역할을 찾는 것입니다. 그런 건 존재하지 않습니다. 봇의 권한은 IAM 역할이 아니라 스페이스에 추가됨으로써 생깁니다. 너무 깊게 생각하지 마세요.

4단계: Pub/Sub 주제 및 구독 만들기

Pub/Sub → 주제 → 주제 만들기에서 주제 ID를 hermes-chat-events로 지정하세요. 그런 다음 풀 구독을 만듭니다:

구독 ID: hermes-chat-events-sub
전송 유형: Pull
메시지 보존 기간: 7일

이 구독은 Google Chat이 들어오는 메시지를 놓아두는 곳입니다. Hermes는 우편함을 확인하듯 여기서 메시지를 가져옵니다.

5단계: Hermes Agent 연결하기

이제 마법의 순간입니다. 실행하세요:

hermes gateway setup

Google Chat을 선택하면 마법사가 나머지 과정을 안내합니다. 프로젝트 ID, 구독 이름, 서비스 계정 JSON 경로를 묻습니다. 그게 전부입니다.

결과

이제 Google Chat 안에 AI 봇이 생겼습니다. 팀원들은 채팅 창을 벗어나지 않고도 봇을 @멘션하고, 질문하고, 자동화를 실행하거나, 작업을 위임할 수 있습니다. 터널도, 공개 IP도, 인증서 갱신도 없습니다.

요약 및 실용적인 팁

Hermes Agent는 Google Chat을 AI 워크플로우의 컨트롤 센터로 바꿔 줍니다. 설정은 의도적으로 단순합니다: 신원 확인용 서비스 계정, 수신용 구독, 응답용 REST API.

실용적인 팁: 설정을 마친 후, 그룹 스페이스에 추가하기 전에 먼저 봇에게 직접 메시지 하나를 보내 테스트해 보세요. 응답이 오면 성공입니다. 응답이 없다면, 서비스 계정에 구독에 대한 roles/pubsub.subscriber 역할이 있는지 확인하세요. 침묵의 가장 큰 원인입니다.

이제 팀에 실제로 회의에 참석하는 AI 동료를 소개해 주세요.