Home Assistant 연동
기준일: 2026-07-26
난이도: 중급
공식 기준: Home Assistant
개요
Hermes를 Home Assistant와 연결하면 Assist/conversation 경로 또는 알림 파이프로 스마트홈 맥락에서 에이전트를 호출할 수 있습니다. 로컬 네트워크 자동화와 LLM 에이전트를 잇는 어댑터입니다.
핵심 개념
| 항목 | 내용 |
|---|---|
| 연결 | HA URL + Long-Lived Access Token |
| 방향 | HA 이벤트/대화 → Hermes, 응답 → HA notify/conversation |
| 보안 | 토큰 최소 권한, 내부망·TLS, allowlist |
| 용도 | 음성 Assist 보조, 알림 요약, 홈 자동화 설명·스크립트 |
상세
사전 준비
- Home Assistant 인스턴스 (URL 접근 가능)
- 프로필 → Long-Lived Access Tokens 발급
- (선택) Notify / conversation 통합
설정
hermes gateway setup # Home Assistant 선택
HOMEASSISTANT_URL=http://homeassistant.local:8123
HOMEASSISTANT_TOKEN=eyJ...
# HOMEASSISTANT_ALLOWED_USERS=...
# HOMEASSISTANT_HOME_CHANNEL=...
원문 키 이름·추가 옵션(웹훅 경로, 이벤트 필터)은 배포 버전의 공식 페이지 표를 그대로 따르세요.
hermes gateway
동작 패턴
- Assist에서 일반 질의 → Hermes 추론 → 텍스트 응답
- 자동화에서 웹훅/이벤트로 프롬프트 전달 → cron과 유사 delivery
- 장치 제어는 HA 쪽이 source of truth — 에이전트는 설명·제안·스크립트 생성에 강점
보안
- 토큰을 git/채팅에 올리지 않기
- 공개 인터넷 노출 시 reverse proxy + 인증
- 터미널 툴과 결합 시 홈 네트워크 명령을 allowlist
트러블슈팅
연결 실패 → URL·토큰·방화벽. 응답 지연 → 모델·툴셋 축소. 중복 응답 → 이벤트 구독 중복 확인.
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스