AIdepotHermes Agent
고객 셀프 준비 안내

전용 Hermes Agent를
안전하게 신청하고 준비하세요.

이메일과 담당자에게 받은 초대 코드를 입력하면, 입력한 주소로 1회용 보안 초대 링크가 발송됩니다. Telegram 사용자 ID·Bot Token·Gemini API Key는 이메일이 아니라 그 링크에서만 입력합니다.

  • 1Telegram 숫자 사용자 IDnumeric
  • 2Telegram Bot Token123456789:AA…
  • 3Gemini API KeyAIza…
FLOW

전체 진행 순서

이메일을 제출하면 서버가 1회용 보안 링크를 발송합니다. 민감한 키는 이메일로 전달되지 않습니다.

  1. 1

    초대 링크 요청

    상단 폼에 이메일과 초대 코드를 입력하면, 입력한 이메일로 1회용 보안 초대 링크가 발송됩니다.

  2. 2

    3가지 필수 정보 준비

    Telegram 사용자 ID, Telegram Bot Token, Gemini API Key를 준비합니다. 아래 안내를 순서대로 따르면 됩니다.

  3. 3

    보안 링크에서 제출

    초대 링크를 열어 개인정보 처리·국외이전 동의 후 3가지 정보를 입력합니다. 링크는 1회용이며 제출 후 만료됩니다.

  4. 4

    전용 Agent 배포 확인

    담당자가 Hermes Agent를 배포한 뒤, Telegram에서 봇이 응답하는지 확인합니다.

STEP 1 · TELEGRAM ID

Telegram 사용자 ID 확인

사용자 ID는 계정의 숫자 식별자입니다. @username과 다르며, 입력란에는 숫자만 넣습니다.

  1. 1

    Telegram 앱 열기

    모바일 또는 데스크톱 Telegram을 엽니다. Hermes Agent를 실제로 사용할 본인 계정으로 진행하세요.

  2. 2

    ID 확인 봇 검색

    검색창에서 @userinfobot 또는 @RawDataBot을 찾아 대화를 시작합니다.

  3. 3

    숫자 ID 복사

    봇이 보여주는 Id(User ID) 값을 복사합니다. 보통 9~10자리이며, 숫자만 입력합니다.

    1234567890
주의

@username·전화번호·프로필 이름은 사용자 ID가 아닙니다. Hermes Agent가 대화할 사용자를 제한하기 위해 숫자 ID가 필요합니다.

STEP 2 · BOT TOKEN

Telegram Bot Token 발급

Bot Token은 새 봇을 제어하는 비밀 키입니다. 이메일·일반 채팅으로 보내지 말고 보안 초대 링크에만 입력하세요.

  1. 1

    공식 BotFather 열기

    Telegram에서 @BotFather를 검색해 대화를 시작합니다. 봇 등록과 인증 토큰 발급은 BotFather에서 이뤄집니다.

  2. 2

    새 봇 생성

    /newbot을 입력하면 표시 이름과 사용자 이름을 차례로 묻습니다.

    • 표시 이름: 고객이 볼 이름 — 예: ACME Hermes Agent
    • 사용자 이름: 반드시 bot으로 끝남 — 예: acme_hermes_agent_bot
  3. 3

    HTTP API Token 복사

    생성이 끝나면 긴 토큰이 나옵니다. 콜론을 포함해 전체 문자열을 복사합니다.

    1234567890:AAExampleTokenString…
  4. 4

    토큰 동작 확인

    아래 주소로 확인할 수 있습니다. 응답에 "ok":true가 보이면 유효합니다. 확인 후 주소창에 남은 토큰을 노출하지 마세요.

    https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe
STEP 3 · GEMINI API KEY

Gemini API Key 발급

Hermes Agent가 Google Gemini 모델을 호출하는 데 사용합니다. 기본 모델은 gemini-3.5-flash입니다.

  1. 1

    Google AI Studio 접속

    Google AI Studio · API Keys 페이지에 접속해 Google 계정으로 로그인합니다.

  2. 2

    API Key 생성

    Create API key를 선택합니다. 신규 사용자는 기본 프로젝트와 키가 자동 생성될 수 있고, 기존 프로젝트가 있으면 해당 프로젝트를 선택합니다.

  3. 3

    키 복사 및 보관

    생성된 키를 복사합니다. Gemini API 키는 비밀번호처럼 취급하고 공개 저장소·클라이언트 코드에 노출하지 마세요.

    AIzaSy…
  4. 4

    권한 문제가 있을 때

    Create API key가 비활성화면 Cloud 프로젝트 권한이 부족할 수 있습니다. 조직 계정이면 관리자에게 요청하거나 별도 프로젝트에서 새 키를 만드세요.

ON THE SECURE LINK

초대 링크에 입력할 값

초대 링크를 받으면 아래 3가지만 입력합니다. 시크릿은 이메일에 쓰지 않습니다.

  • Telegram Bot TokenBotFather가 발급한 전체 HTTP API Token. 콜론 앞뒤 문자열을 모두 포함합니다.
  • Telegram 사용자 ID본인 계정의 숫자 ID. @username이나 전화번호가 아닙니다.
  • Gemini API KeyGoogle AI Studio에서 발급한 키. Hermes Agent가 Gemini 모델 호출에 사용합니다.