전용 Hermes Agent를
안전하게 신청하고 준비하세요.
이메일과 담당자에게 받은 초대 코드를 입력하면, 입력한 주소로 1회용 보안 초대 링크가 발송됩니다. Telegram 사용자 ID·Bot Token·Gemini API Key는 이메일이 아니라 그 링크에서만 입력합니다.
- 1Telegram 숫자 사용자 IDnumeric
- 2Telegram Bot Token123456789:AA…
- 3Gemini API KeyAIza…
전체 진행 순서
이메일을 제출하면 서버가 1회용 보안 링크를 발송합니다. 민감한 키는 이메일로 전달되지 않습니다.
- 1
초대 링크 요청
상단 폼에 이메일과 초대 코드를 입력하면, 입력한 이메일로 1회용 보안 초대 링크가 발송됩니다.
- 2
3가지 필수 정보 준비
Telegram 사용자 ID, Telegram Bot Token, Gemini API Key를 준비합니다. 아래 안내를 순서대로 따르면 됩니다.
- 3
보안 링크에서 제출
초대 링크를 열어 개인정보 처리·국외이전 동의 후 3가지 정보를 입력합니다. 링크는 1회용이며 제출 후 만료됩니다.
- 4
전용 Agent 배포 확인
담당자가 Hermes Agent를 배포한 뒤, Telegram에서 봇이 응답하는지 확인합니다.
Telegram 사용자 ID 확인
사용자 ID는 계정의 숫자 식별자입니다. @username과 다르며, 입력란에는 숫자만 넣습니다.
- 1
Telegram 앱 열기
모바일 또는 데스크톱 Telegram을 엽니다. Hermes Agent를 실제로 사용할 본인 계정으로 진행하세요.
- 2
ID 확인 봇 검색
검색창에서
@userinfobot또는@RawDataBot을 찾아 대화를 시작합니다. - 3
숫자 ID 복사
봇이 보여주는
1234567890Id(User ID) 값을 복사합니다. 보통 9~10자리이며, 숫자만 입력합니다.
@username·전화번호·프로필 이름은 사용자 ID가 아닙니다. Hermes Agent가 대화할 사용자를 제한하기 위해 숫자 ID가 필요합니다.
Telegram Bot Token 발급
Bot Token은 새 봇을 제어하는 비밀 키입니다. 이메일·일반 채팅으로 보내지 말고 보안 초대 링크에만 입력하세요.
- 1
공식 BotFather 열기
Telegram에서
@BotFather를 검색해 대화를 시작합니다. 봇 등록과 인증 토큰 발급은 BotFather에서 이뤄집니다. - 2
새 봇 생성
/newbot을 입력하면 표시 이름과 사용자 이름을 차례로 묻습니다.- 표시 이름: 고객이 볼 이름 — 예:
ACME Hermes Agent - 사용자 이름: 반드시
bot으로 끝남 — 예:acme_hermes_agent_bot
- 표시 이름: 고객이 볼 이름 — 예:
- 3
HTTP API Token 복사
생성이 끝나면 긴 토큰이 나옵니다. 콜론을 포함해 전체 문자열을 복사합니다.
1234567890:AAExampleTokenString… - 4
토큰 동작 확인
아래 주소로 확인할 수 있습니다. 응답에
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe"ok":true가 보이면 유효합니다. 확인 후 주소창에 남은 토큰을 노출하지 마세요.
Gemini API Key 발급
Hermes Agent가 Google Gemini 모델을 호출하는 데 사용합니다. 기본 모델은 gemini-3.5-flash입니다.
- 1
Google AI Studio 접속
Google AI Studio · API Keys 페이지에 접속해 Google 계정으로 로그인합니다.
- 2
API Key 생성
Create API key를 선택합니다. 신규 사용자는 기본 프로젝트와 키가 자동 생성될 수 있고, 기존 프로젝트가 있으면 해당 프로젝트를 선택합니다. - 3
키 복사 및 보관
생성된 키를 복사합니다. Gemini API 키는 비밀번호처럼 취급하고 공개 저장소·클라이언트 코드에 노출하지 마세요.
AIzaSy… - 4
권한 문제가 있을 때
Create API key가 비활성화면 Cloud 프로젝트 권한이 부족할 수 있습니다. 조직 계정이면 관리자에게 요청하거나 별도 프로젝트에서 새 키를 만드세요.
초대 링크에 입력할 값
초대 링크를 받으면 아래 3가지만 입력합니다. 시크릿은 이메일에 쓰지 않습니다.
- Telegram Bot TokenBotFather가 발급한 전체 HTTP API Token. 콜론 앞뒤 문자열을 모두 포함합니다.
- Telegram 사용자 ID본인 계정의 숫자 ID.
@username이나 전화번호가 아닙니다. - Gemini API KeyGoogle AI Studio에서 발급한 키. Hermes Agent가 Gemini 모델 호출에 사용합니다.