에이전트와 자동화

최종 업데이트

홈 어시스턴트에 Ollama 대화 에이전트 붙이기: 노출 엔티티와 지침 설계

모델은 문장을 해석하고, 실제 실행은 노출한 엔티티 안에서만 이뤄져요.

홈 어시스턴트의 Ollama 통합은 외부 Ollama 서버를 대화 에이전트로 써요. 말한 문장을 모델이 해석하고, 기기 제어를 켜면 Assist API1로 노출한 엔티티만 조작해요. 모델·지침·노출 목록·별칭을 어떤 순서로 정하는지 담았어요.

실행 조건과 핵심 내용
  • Ollama 통합은 대화 에이전트를 추가하고, 기기 제어는 실험 기능이에요.
  • 제어 권한의 범위는 Assist API에 노출한 엔티티 목록이 정해요.
  • 별칭을 붙이면 같은 기기를 여러 이름과 언어로 불러도 알아들어요.

질문이 모델까지 가는 길

Assist는 웨이크워드로 시작해 말소리를 글로 바꾸고, 그 글을 대화 에이전트에 넘겨요. Ollama 통합을 붙이면 이 자리에 로컬 서버의 모델이 들어가요. 모델은 답을 만들거나, 기기 제어가 켜져 있으면 Assist API를 불러요.

그래서 모델을 바꿔도 실행되는 기기는 그대로예요. 모델은 어떤 기기를 쓸지 고르고 문장을 다듬는 역할이고, 실제 스위치를 누르는 쪽은 홈 어시스턴트예요.

투명한 상자 안의 로봇 옆에 공유기와 보관함, 문서가 놓여 있다
말한 문장은 집 안 서버의 모델이 해석하고, 실행은 홈 어시스턴트가 맡아요.

모델과 지침을 넣는 순서

설정 > 기기 및 서비스에서 Ollama 통합을 추가하고 서버 주소(예: http://192.168.0.20:11434)를 넣어요. API 키는 서버에 인증을 걸었을 때만 필요하고, 모델 이름을 넣으면 설정 과정에서 자동으로 내려받아요.

지침에는 답변 언어와 길이, 하지 말아야 할 일을 적어요. 문장이 길어질수록 모델의 문맥을 차지하니, 기기 이름 규칙과 짧은 답변 정도로 시작하고 필요할 때만 늘리세요.

Ollama 통합에서 정하는 값
항목넣을 값주의
URLOllama 서버 주소와 포트홈 어시스턴트에서 접근되는 주소여야 해요
모델기기 제어 문장을 처리할 크기너무 큰 모델은 응답이 느려져요
지침언어·길이·금지 동작문맥을 차지하니 짧게
기기 제어필요할 때만 켜기

노출 엔티티가 권한의 전부예요

기기 제어를 켜도 모델이 집안 모든 기기를 만질 수 있는 것은 아니에요. 설정 > 음성 비서의 노출 탭에서 고른 엔티티만 Assist API에 보이고, 모델은 그 안에서만 고를 수 있어요.

잠금과 차고문은 처음부터 빼 두세요. 조명·스위치·공조처럼 잘못 실행해도 되돌리기 쉬운 기기부터 넣고, 센서는 읽기만 하므로 값 확인용으로 먼저 붙이면 안전해요.

문서 더미와 검색 시스템을 실행하는 소형 컴퓨터
노출 목록에 없는 기기는 모델이 골라도 실행되지 않아요.

별칭으로 이름을 맞춰요

같은 조명을 '거실 불', '메인 램프'처럼 여러 이름으로 부르면 모델이 헷갈려요. 노출 탭에서 엔티티를 열어 별칭을 추가하면 Assist가 그 이름도 함께 알아들어요.

별칭은 구역과 층에도 붙일 수 있어요. 한국어와 영어를 같이 쓰는 집이라면 두 이름을 모두 별칭으로 넣어 두면 말을 바꿔도 같은 기기를 찾아요.

안 될 때 확인할 것

Ollama 통합은 문장 트리거와 연결되지 않아요. 정해 둔 문장을 정확히 실행하려면 자동화의 문장 트리거를 따로 만들어야 해요. 반대로 열린 질문은 대화 에이전트가 맡아요.

답이 느리면 모델 크기와 서버 위치를 먼저 봐요. 같은 네트워크에 두면 왕복이 줄고, 지침이 길면 첫 응답이 늦어져요. 휴대폰 앱으로 같은 문장을 세 번 말해 결과가 일정한지 확인하세요.

노트북 옆 책상과 선반에 금속 장치 두 대가 놓여 있고 케이블이 앞쪽 스위치 상자에 연결되어 있다
같은 네트워크에 모델 서버를 두면 응답 왕복이 한 번 줄어요.

용어 각주

  1. API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.

    본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?
홈 어시스턴트의 Ollama 통합은 외부 Ollama 서버를 대화 에이전트로 써요. 말한 문장을 모델이 해석하고, 기기 제어를 켜면 Assist API로 노출한 엔티티만 조작해요. 모델·지침·노출 목록·별칭을 어떤 순서로 정하는지 담았어요.