Hermes AI를 Slack에 통합하는 방법: 단계별 가이드

Hermes를 Slack에 통합하면 귀하의 AI 에이전트를 24/7 커맨드 센터(command center)로 변환하여, 워크스페이스에서 직접 메시지를 보내고, 워크플로(workflows)를 자동화하며, 알림을 받을 수 있습니다.

설정을 위해 다음 단계들을 따르세요:

1단계: Slack 앱 매니페스트(App Manifest) 생성

Slack UI에서 권한 범위(Scopes)와 소켓 모드(Socket Mode)를 수동으로 구성하는 대신, Hermes가 귀하를 위해 앱 매니페스트(App Manifest)를 생성하도록 할 수 있습니다.

1. 터미널을 열고 다음 명령어를 실행하여 매니페스트 파일을 생성합니다:

hermes slack manifest --write

1. 이렇게 하면 Hermes에 최적화된 모든 필수 권한, 이벤트 구독(event subscriptions), 소켓 모드(Socket Mode) 설정이 포함된 파일이 생성됩니다. 이 파일의 내용을 열어서 복사하세요.

2단계: Slack 앱 생성

1. Slack API Apps Dashboard로 이동하여 Create New App을 클릭합니다.
2. From an app manifest를 선택합니다.
3. 대상 워크스페이스를 선택하고, 생성된 매니페스트 코드를 붙여넣은 후 Create를 클릭합니다.

3단계: 설치 및 토큰(Tokens) 가져오기

1. 왼쪽 사이드바의 OAuth & Permissions 페이지로 이동하여 Install to Workspace를 클릭합니다. 앱을 승인합니다.
2. 설치가 완료되면 Bot User OAuth Token(xoxb-로 시작)을 복사합니다.
3. Basic Information 탭으로 이동하여 Signing Secret을 복사합니다.
4. Socket Mode 탭으로 이동하여 앱 수준 토큰(App-Level Token, xapp-로 시작)을 생성하고 복사합니다.

4단계: Hermes 구성

1. Hermes 설정 파일을 엽니다:

nano ~/.hermes/config.yaml

1. config.yaml 파일에 Slack 토큰을 추가합니다:

slack:
  botToken: "xoxb-YOUR_BOT_TOKEN_HERE"
  appToken: "xapp-YOUR_APP_TOKEN_HERE"
...

5단계: 게이트웨이(Gateway) 시작

1. 터미널에서 설정 마법사(setup wizard)를 실행합니다:

hermes gateway setup

1. Slack을 선택합니다 (스페이스바를 사용하여 선택하고 엔터를 눌러 확인합니다).
2. 요청받은 토큰들을 프롬프트가 나타나면 붙여넣습니다.
3. 다음 명령어를 실행하여 게이트웨이를 시작합니다:

hermes gateway run

6단계: Slack 사용자 ID(User ID) 승인

Hermes는 보안을 위해 기본적으로 액세스를 제한합니다.

1. Slack에서 새로 생성한 봇에게 메시지를 보냅니다 (예: @Hermes hello라고 입력).
2. 아직 권한이 부여되지 않았기 때문에, 터미널 로그에 gateway run unauthorized user라는 에러 메시지와 함께 귀하의 특정 Slack 사용자 ID (User ID)가 출력될 것입니다.
3. 로그에서 해당 사용자 ID를 복사한 후, 다음 명령어를 실행하여 Hermes에서 귀하를 승인합니다:

hermes config set Slack allowed_users [YOUR_USER_ID]

7단계: 봇 테스트

Hermes 게이트웨이 (gateway)를 재시작합니다. 이제 Slack에서 Hermes AI 에이전트와 직접 대화할 수 있습니다!