Home Assistant умеет использовать LLM как разговорного агента: вы пишете или говорите команду, а модель отвечает и управляет устройствами. Встроенная интеграция OpenAI работает только с официальным эндпоинтом OpenAI и не позволяет поменять адрес API, поэтому для Heli нужна сторонняя интеграция с полем Base URL. Ниже — настройка через Extended OpenAI Conversation.
Установка через HACS
- Откройте HACS → Integrations → Explore & Download Repositories, найдите Extended OpenAI Conversation и нажмите Download.
- Перезапустите Home Assistant.
- Откройте Settings → Devices & services → Add Integration и выберите Extended OpenAI Conversation.
- API Provider: OpenAI. Base URL: https://getheli.ru/v1 (с /v1 в конце). API Key: ключ sk-heli- из вкладки «Ключи» кабинета Heli. Skip Authentication оставьте выключенным — Heli проверяет ключ.
- В параметрах интеграции укажите модель, например openai/gpt-5.4-mini.
Включение агента
- Settings → Voice assistants → откройте ассистента (по умолчанию «Home Assistant») и в поле Conversation agent выберите Extended OpenAI Conversation.
- На вкладке Expose отметьте устройства, которыми модель может управлять. Без открытых сущностей ассистент не знает, какие устройства есть.
- Проверьте настройку простым вопросом: «Какие лампы есть в доме?»
Какая модель нужна
Управление устройствами идёт через вызов функций: модель должна вернуть tool call, а интеграция выполнит сервис Home Assistant. Поэтому выбирайте модели с надёжным tool calling. Если ассистент отвечает словами, но ничего не включает, модель не вызвала функцию — попробуйте другую модель или уточните системный промпт.
Список открытых устройств передаётся модели в промпте каждого запроса. Чем больше сущностей открыто, тем длиннее промпт и дороже каждая команда, поэтому открывайте только то, чем действительно нужно управлять голосом.
GPT-5.4 mini — быстрый и надёжный tool calling.
Gemini 3.5 Flash — быстрые ответы.
Claude Sonnet 5 — сложные сценарии и автоматизации.
Альтернативы и ограничения
- Custom OpenAI API Conversation — форк встроенной интеграции OpenAI с полем base URL; устанавливается вручную в custom_components.
- Сторонние интеграции не поддерживаются командой Home Assistant: после обновления HA проверьте, что интеграция совместима с вашей версией.
- Задайте бюджет на отдельный ключ для Home Assistant во вкладке «Лимиты», чтобы ошибка в автоматизации не израсходовала баланс.
Попробуйте Heli
Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.