extended_openai_conversation

用自然语言对话控制家里的智能设备

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 276 🐛 待处理 134 👀 关注 31

GitHub ↗

GitHub 星标 ★ 1460

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源免费，需自备OpenAI API密钥

项目数据

分类对话助手

开发团队jekalmin

GitHubhttps://github.com/jekalmin/extended_openai_conversation

定价模式🏷️完全免费

价格说明开源免费，需自备OpenAI API密钥

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型conversation,custom-component,homeassistant

GitHub 星标★ 1460

上线时间2023-10-05 00:00:00

代码更新2026-10-11

仓库体积1.3 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-11-09

浏览次数0

项目介绍

这是一个 Home Assistant 自定义集成，把 OpenAI 对话模型接入智能家居，让用户用自然语言控制设备。它提供自定义对话代理，可注册函数调用（function calling）来读写实体状态、执行服务、查询历史数据，并支持模板化提示词与上下文管理。相比内置对话代理，它允许用户精细定义可调用的函数、调整模型参数与上下文长度，还能通过脚本扩展能力。项目以 Python 编写，安装后通过 HACS 或手动放入 custom_components 目录，在配置界面填写 API Key 即可使用。适合希望用大模型统一管理家中设备、又需要可控函数边界的进阶用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-09 · 当前星标 ★ 1460

技术标签

conversation homeassistant

使用教程

难度：进阶约 15 分钟部署方式：本地安装 7 步

环境要求

已安装并可正常运行的 Home Assistant 实例
HACS（可选，用于自定义仓库安装）或对 Home Assistant 配置目录的访问权限
OpenAI API Key，或 OpenAI 兼容服务（如 Azure OpenAI、LocalAI）的地址与密钥
能访问所选模型服务的网络环境

安装与启动步骤

1通过 HACS 安装

在 HACS 中把该仓库注册为自定义仓库，类型选集成，然后搜索并下载；也可改用下一步的手动复制方式。
2手动复制组件目录

不使用 HACS 时，把仓库中的 extended_openai_conversation 文件夹整体放到 Home Assistant 配置目录的 custom_components 下。
```
cp -r extended_openai_conversation /your/path/config/custom_components/
```
3重启 Home Assistant

组件放入目录或下载完成后必须重启 Home Assistant，集成才会被加载。
4添加集成

进入设置 > 设备与服务，点击右下角“添加集成”，搜索 Extended OpenAI Conversation 并按提示完成设置。
5填写 API Key

设置过程中必须填入 API Key；若使用 Azure OpenAI、LocalAI 等兼容服务，同时填写 Base Url，否则保持默认。
6切换对话代理

进入设置 > 语音助手，编辑默认名为 Home Assistant 的助手，在“对话代理”标签中选择 Extended OpenAI Conversation。
7配置函数与实体

在集成配置的 Functions 中粘贴自定义 YAML 函数配置，并在语音助手中暴露需要控制的实体，模型才能调用对应服务。

关键配置

配置项	必填	说明	示例
`API Key`	是	调用 OpenAI 或兼容服务的密钥，添加集成时必填。	`sk-xxxxxxxxxxxxxxxxxxxx`
`Base Url`	否	使用 Azure OpenAI、LocalAI 等兼容服务时填写的接口地址，官方服务留空。	`https://your-resource.openai.azure.com/`
`Functions`	否	自定义函数调用的 YAML 配置，用于让模型执行服务调用、查询历史等操作。	`- spec: {}`