AWS Bedrock 연결 | Easy Understand Hermes Agent

Amazon Bedrock을 거대한 AI 모델 자판기이라고 생각해보세요. 과자 대신 Anthropic, Meta 등에서 만든 강력한 언어 모델을 제공하고, 결제 수단은 딱 하나, 바로 여러분의 AWS 계정입니다.

준비물

시작하기 전에 다음이 준비되어 있는지 확인하세요:

AWS 계정 (프리 티어로 충분합니다)
AWS 자격 증명 — 일종의 신분증이라고 생각하면 됩니다. 다음 중 하나를 사용할 수 있어요:
- EC2/ECS/Lambda를 사용 중이라면 IAM 역할 (설정 제로!)
- AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY 환경 변수
- SSO나 명명된 프로필을 위한 AWS_PROFILE
- 로컬 개발이라면 그냥 aws configure 실행

1단계: Bedrock 지원이 포함된 Hermes 설치

터미널을 열고 다음을 실행하세요:

cd ~/.hermes/hermes-agent
uv pip install -e ".[bedrock]"

이렇게 하면 Hermes 설치에 Bedrock “플러그인”이 추가됩니다. 스마트폰에 언어 팩을 설치하는 것과 비슷하다고 생각하면 됩니다.

2단계: Hermes가 Bedrock을 사용하도록 설정

다음 명령어로 제공자를 선택하세요:

hermes model

프롬프트가 나타나면:

“More providers…” 를 선택하세요.
“AWS Bedrock” 을 선택하세요.
리전을 선택하세요 (예: us-east-2)
모델을 선택하세요 (예: Claude Sonnet 4)

Hermes가 자동으로 설정을 저장합니다. ~/.hermes/config.yaml 파일은 다음과 비슷하게 보일 거예요:

model:
  default: us.anthropic.claude-sonnet-4-6
  provider: bedrock
  base_url: https://bedrock-runtime.us-east-2.amazonaws.com
bedrock:
  region: us-east-2

3단계: 채팅 시작하기

hermes chat

끝입니다! 이제 AWS Bedrock을 통해 모델과 대화하고 있는 겁니다.

리전 설정하기

AWS 리전은 세 가지 방법으로 설정할 수 있습니다 (우선순위가 높은 순서):

설정 파일의 bedrock: 아래에 region 추가
AWS_REGION 환경 변수 설정
AWS_DEFAULT_REGION 환경 변수 설정

설정하지 않으면 Hermes는 기본값으로 us-east-1을 사용합니다.

추가 기능: Guardrails (안전 필터)

콘텐츠 필터를 추가하고 싶으신가요? 설정 파일에 다음을 추가하세요:

bedrock:
  region: us-east-2
  guardrail:
    guardrail_identifier: "abc123def456"  # Bedrock 콘솔에서 가져옴
    guardrail_version: "1"                # 또는 "DRAFT"
    stream_processing_mode: "async"       # "sync" 또는 "async"
    trace: "disabled"                     # "enabled", "disabled", "enabled_full"

모델 탐색

Hermes는 해당 리전에서 사용 가능한 모델을 자동으로 찾습니다. 표시할 모델을 직접 지정할 수도 있어요:

bedrock:
  discovery:
    enabled: true
    provider_filter: ["anthropic", "meta"]

요약

AWS Bedrock을 Hermes에 연결하는 건 TV에 새 게임 콘솔을 꽂는 것과 같습니다. 드라이버를 설치하고, 게임을 고르고, 플레이하면 됩니다. AWS의 보안과 안정성 위에서 최고 수준의 모델을 사용할 수 있게 되는 거죠.

실용적인 팁: EC2나 Lambda에서 실행 중이라면 API 키는 완전히 건너뛰세요. AmazonBedrockFullAccess 권한이 있는 IAM 역할만 연결하면 Hermes가 자동으로 감지합니다. 설정도, 번거로움도 없이 순수한 AI 성능만 누리면 됩니다.