azure openai ha

适用于家庭助理的 Azure OpenAI 对话自定义集成

这是什么

此自定义集成在 Home Assistant 中添加了由 Azure OpenAI 支持的对话代理，它基于 Home Assistant 的原始 OpenAI Conversation 集成。

它的作用

该对话代理无法控制您的房子。它只能查询Home Assistant已经提供的信息。为了能够回答有关您房屋的问题，Home Assistant 需要向 OpenAI 提供您房屋的详细信息，其中包括区域、设备及其状态。

局限性

• 支持的 Azure OpenAI API 版本：

  • 2023-06-01-预览
  • 2023-05-15
  • 2023-03-15-预览
  • 2022-12-01

• 支持的Home Assistant 版本：由于 Home Assistant Core 为自定义助理引入了重大更改，Azure OpenAI Conversation 集成与以下 Home Assistant 版本兼容：

Azure OpenAI 对话版本	家庭助理版
0.xy	2023.4.x
1.xy	2023.5+

支持的AI模型：

• GPT-35-涡轮
• GPT-4
• gpt-4-32k

安装与配置

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版本：2023-03-15-预览
  

家庭助理 2023.5+ 用户

需要从“设置”->“语音助手”添加自定义助手。添加后，您可以选择自定义助手作为默认使用的收藏夹：

选项

可以通过用户界面设置 Azure OpenAI 对话的选项，步骤如下：

1. 浏览到您的 Home Assistant 实例。
2. 在侧栏中单击“设置”->“设备和服务”。
3. 如果配置了多个 OpenAI Conversation 实例，请选择要修改的实例，然后单击“配置”。

可用选项：

• 提示模板： AI语言模型生成新文本的起始文本。此文本可以包含有关您的 Home Assistant 实例、设备和区域的信息，并使用 Home Assistant 模板编写。

• 完成模型：为文本生成部署的 GPT 语言模型的名称（即my-gpt35-model ）。您可以在 Azure OpenAI 文档中找到有关可用模型的更多详细信息。

• 响应中返回的最大令牌 AI 模型在完成提示时应生成的最大单词或“令牌”数量。有关详细信息，请参阅 Azure OpenAI 完成文档。

• 温度：决定模型在生成文本时应使用的创造力和冒险水平的值。较高的温度意味着模型更有可能产生意外的结果，而较低的温度会产生更具确定性的结果。有关详细信息，请参阅 Azure OpenAI 完成文档。

• Top P： top_p 是温度的替代方案，它确定模型在生成文本时应考虑的最可能单词选择的比例。较高的 top_p 意味着模型将仅考虑最可能的单词，而较低的 top_p 意味着将考虑更广泛的单词，包括不太可能的单词。有关详细信息，请参阅 Azure OpenAI 完成文档。

变更日志

请参考发布历史。

如何提供帮助

虽然拥有更多开发人员固然很好，但您可以在不知道如何编码的情况下做出贡献。您可以提交错误/功能请求，也可以帮助完成其他任务，例如 UI 翻译和更新自述文件。

用户界面翻译

可以在这里添加更多语言，欢迎贡献:)

可用语言：

• 英语
• 西班牙语
• 荷兰语（来源：@jobvk）
• 法语（来源：@jobvk）
• 德语（来源：@jobvk）
• 葡萄牙语（来源：@ViPeR5000）
• 中文（来源：@weiting-tw）

文档

自述文件将用于文档，如果将来通过自动化或其他调整对其进行扩展，我们可以考虑在 wiki 上实现此目的。

免责声明：不用担心犯错误，因为我们可以使用历史记录来恢复？。

资金

GitHub	给我买杯咖啡

执照

麻省理工学院 - 通过提供贡献，您同意该贡献已获得麻省理工学院的许可。