azure openai ha

Пользовательская интеграция Azure OpenAI Conversation для Home Assistant

Что это такое

Эта пользовательская интеграция добавляет в Home Assistant агент диалога на базе Azure OpenAI. Он основан на исходной интеграции OpenAI Conversation для Home Assistant.

Что он делает

Этот агент разговора не может контролировать ваш дом. Он может запрашивать только информацию, предоставленную Home Assistant. Чтобы иметь возможность отвечать на вопросы о вашем доме, Home Assistant должен будет предоставить OpenAI подробную информацию о вашем доме, включая районы, устройства и их состояния.

Ограничения

• Поддерживаемые версии API Azure OpenAI:

  • 2023-06-01-превью
  • 15 мая 2023 г.
  • 2023-03-15-превью
  • 01.12.2022

• Поддерживаемые версии Home Assistant : из-за критических изменений, внесенных Home Assistant Core для пользовательских помощников, интеграция Azure OpenAI Conversation совместима со следующими версиями Home Assistant:

Версия разговора Azure OpenAI	Версия домашнего помощника
0.xy	2023.4.х
1.xy	2023.5+

Поддерживаемые модели AI:

• gpt-35-турбо
• гпт-4
• гпт-4-32к

Установка и настройка

1. Убедитесь, что интеграция разговоров включена, она позволяет вам общаться с Home Assistant, добавьте строку ниже в свой configuration.yaml :

 conversation :

2. Загрузите и установите интеграцию из HACS: Azure OpenAI Conversation.
3. Перезапустите экземпляр Home Assistant.
4. Перейдите в «Настройки» -> «Устройства и службы» -> «Добавить интеграцию» -> «Разговор Azure OpenAI».
5. Введите API Key , API Base и API Version используемые в соответствии с примером ниже, и нажмите «Отправить»:

• Ключ API: 1234567890abcdef1234567890abcdef
  
• База API: https://iotlabopenai.openai.azure.com/
  
• Версия API: 15 марта 2023 г., предварительный просмотр.
  

Домашний помощник 2023.5+ пользователей

Пользовательского помощника необходимо добавить в «Настройки» -> «Голосовые помощники». После добавления вы можете выбрать пользовательского помощника в качестве избранного, который будет использоваться по умолчанию:

Параметры

Параметры беседы Azure OpenAI можно настроить через пользовательский интерфейс, выполнив следующие действия:

1. Перейдите к своему экземпляру Home Assistant.
2. На боковой панели нажмите «Настройки» -> «Устройства и службы».
3. Если настроено несколько экземпляров OpenAI Conversation, выберите экземпляр, который вы хотите изменить, и нажмите «Настроить».

Доступные варианты:

• Шаблон подсказки: начальный текст языковой модели ИИ, на основе которого будет генерироваться новый текст. Этот текст может включать информацию об экземпляре вашего Home Assistant, устройствах и областях и написан с использованием шаблонов Home Assistant.

• Модель завершения: имя языковой модели GPT, используемой для генерации текста (т. е. my-gpt35-model ). Более подробную информацию о доступных моделях можно найти в документации Azure OpenAI.

• Максимальное количество токенов для возврата в ответ Максимальное количество слов или «токенов», которые модель ИИ должна сгенерировать при завершении запроса. Дополнительные сведения см. в документации по завершению Azure OpenAI.

• Температура: значение, определяющее уровень креативности и риска, который модель должна использовать при создании текста. Более высокая температура означает, что модель с большей вероятностью даст неожиданные результаты, тогда как более низкая температура приводит к более детерминированным результатам. Дополнительные сведения см. в документации по завершению Azure OpenAI.

• Top P: альтернатива температуре, top_p определяет долю наиболее вероятных вариантов слов, которые модель должна учитывать при создании текста. Более высокое значение top_p означает, что модель будет учитывать только наиболее вероятные слова, а более низкое значение top_p означает, что будет учитываться более широкий диапазон слов, включая менее вероятные. Дополнительные сведения см. в документации по завершению Azure OpenAI.

Журнал изменений

Пожалуйста, ознакомьтесь с историей выпусков.

Как помочь

Хотя было бы неплохо иметь больше разработчиков, вы можете внести свой вклад, не умея программировать. Вы можете отправлять сообщения об ошибках/запросах на новые функции или помогать с другими задачами, такими как перевод пользовательского интерфейса и обновление README.

Переводы пользовательского интерфейса

Здесь можно добавить больше языков, вклад приветствуется :)

Доступные языки:

• Английский
• испанский
• Голландский (благодарность: @jobvk)
• Французский (благодарность: @jobvk)
• Немецкий (благодарность: @jobvk)
• Португальский (благодарность: @ViPeR5000)
• Китайский (благодарность: @weiting-tw)

Документация

Файл README будет использоваться для документации. Если в будущем он будет расширен за счет автоматизации или других настроек, мы можем подумать о вики для этой цели.

Отказ от ответственности: не беспокойтесь об ошибках, поскольку мы можем вернуться, используя историю?.

Финансирование

GitHub	Купи мне кофе

Лицензия

MIT. Предоставляя свой вклад, вы соглашаетесь, что этот вклад лицензируется под лицензией MIT.