ITSpecialist111/ai_automation_suggester

AI Automation Suggester – Home Assistant 통합

정의 – 공식 스타일의 Home Assistant 사용자 정의 통합으로, 대규모 언어 모델(LLM)을 호출하여 현재 Home Assistant 구성(엔티티, 기기, 영역, 기존 자동화)을 확인하고 붙여넣기 가능한 YAML 자동화 스니펫을 반환합니다. OpenAI 호환 제공업체(OpenAI, Anthropic, Google Gemini, Groq, Ollama, LocalAI 등)와 함께 작동하며 제안을 영구 알림, 센서 속성 또는 번들된 Lovelace 카드로 표시합니다.

필요한 이유

• 대규모 Home Assistant 설정은 빠르게 이해하기 어려워지며 유용한 자동화를 놓칠 수 있습니다.
• 복잡한 YAML을 수동으로 작성하는 것은 특히 초보자에게 지루할 수 있습니다.
• 이 통합은 보유한 정확한 기기에 맞춰진 컨텍스트 인식 아이디어(에너지 절약, 보안, 편안함)를 제공하여 시간을 절약하고 새로운 자동화를 고무합니다.

작동 방식(단계별)

1. 스냅샷 – 요청 시(또는 Home Assistant 자동화를 통해) 통합은 엔티티, 기기, 영역 및 기존 자동화의 스냅샷을 수집합니다. 도메인별로 필터링하거나 엔티티 수를 제한하거나 특정 항목을 제외할 수 있습니다.
2. 프롬프트 구축 – 스냅샷은 시스템 프롬프트에 삽입됩니다. 출력을 안내하기 위해 사용자 정의 프롬프트를 추가할 수 있습니다(예: "재실 조명에 초점").
3. 제공업체 호출 – 프롬프트는 선택한 AI 제공업체(OpenAI, Anthropic, Gemini, Groq, Ollama 등)로 전송됩니다. 온도, 모델, 토큰 제한 및 엔드포인트는 구성 가능합니다.
4. 파싱 – 통합은 모델에 구조화된 JSON을 요청합니다. 실패하면 펜스된 YAML 파싱으로 대체하고 YAML을 검증하며 잘림 경고를 기록합니다.
5. 표시 – 결과 제안은 Home Assistant 영구 알림, 센서 속성으로 나타나며 번들된 대시보드 카드가 읽을 수 있는 기록 로그에 저장됩니다.

주요 기능

• 모델 비종속 – 100개 이상의 백엔드(클라우드 및 로컬)에서 작동합니다. 온도, 최대 토큰 수 및 사용자 정의 엔드포인트는 구성 가능합니다.
• 사용자 정의 프롬프트 및 필터 – 도메인 제한, 엔티티/영역 제외, 엔티티 제한 설정 또는 일회성 사용자 정의 지시 추가가 가능합니다.
• 영구 제안 기록 – 각 제안은 사용된 모델, 토큰 사용량, 경고 및 검토 상태(수락/거부/무시)를 저장합니다.
• 대시보드 준비 출력 – 센서 속성에는 사람이 읽을 수 있는 설명과 원시 YAML 블록이 포함되어 Lovelace 카드 구축이 쉽습니다.
• 무작위 엔티티 선택 – 동일한 아이디어가 반복적으로 나타나는 것을 방지합니다.
• 서비스 기반 트리거 – ai_automation_suggester.generate_suggestions를 선택적 매개변수와 함께 호출하여 요청 시 또는 자동화(주간 검토, 새 엔티티 감지, 시작 등)에서 실행할 수 있습니다.

설치

1. HACS(Home Assistant Community Store)를 아직 설치하지 않았다면 설치합니다.
2. HACS → 통합에서 + 버튼을 클릭하고 AI Automation Suggester를 검색하여 설치합니다.
3. Home Assistant를 다시 시작합니다.
4. 설정 → 기기 및 서비스 → 통합 추가 → AI Automation Suggester를 통해 통합을 추가합니다.
   • (또는 custom_components/ai_automation_suggester 폴더를 custom_components 디렉토리에 복사하고 다시 시작합니다.)

구성

• 드롭다운에서 AI 제공업체를 선택합니다.
• 필요한 API 키 또는 로컬 엔드포인트 URL을 입력합니다.
• 모델을 선택하고 온도(0.0-2.0, 기본값 0.7)를 설정하며 최대 입력/출력 토큰을 정의합니다.
• 선택적으로 모델에 특정 성격이나 초점을 부여하기 위해 사용자 정의 시스템 프롬프트를 제공합니다.
• 모든 옵션은 통합의 옵션 페이지에서 나중에 편집할 수 있습니다.

일반적인 사용법

• 수동 – 개발자 도구 → 서비스를 열고 ai_automation_suggester.generate_suggestions를 호출합니다(all_entities: true, entity_limit: 50, custom_prompt: "야간 조명 자동화 제안"과 같은 매개변수를 전달할 수 있습니다).
• 자동 – 일정(예: 주간) 또는 새 엔티티 추가와 같은 이벤트에서 동일한 서비스를 호출하는 Home Assistant 자동화를 만듭니다.
• 알림 또는 센서 카드에서 제안을 검토하고 YAML을 automations.yaml에 복사한 후 활성화합니다.

사전 요구 사항

• Home Assistant 2024.1 이상.
• LLM 제공업체에 대한 액세스(클라우드 API 키 또는 Ollama/LocalAI와 같은 실행 중인 로컬 서버).

안전 참고 사항 – 이 통합은 자동으로 자동화를 작성하지 않습니다. YAML을 직접 검토하고 적용해야 하므로 의도하지 않은 변경의 위험이 없습니다.

---

이 요약은 저장소의 README에만 기반합니다.