2025.3.4
首页 ▸ Integrations ▸

Google 生成式 AI

Google 生成式 AI 集成在 Home Assistant 中添加了一个由 Google 生成式 AI 驱动的对话代理。它可以选择性地允许控制 Home Assistant。

控制 Home Assistant 通过提供 AI 对 Home Assistant 的 Assist API 的访问权来实现。您可以控制它可以从 暴露实体页面 访问哪些设备和实体。AI 能够为您提供有关设备的信息并控制它们。

此集成不与 句子触发器 集成。

此集成需要一个 API 密钥才能使用，您可以在这里生成，并且必须位于 可用区域 之一。

配置

要将 Google 生成式 AI 服务 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在右下角，选择 Add Integration 按钮。

  • 从列表中选择 Google 生成式 AI。

  • 按照屏幕上的说明完成设置。

生成一个 API 密钥

Google 生成式 AI API 密钥用于验证对 Google 生成式 AI API 的请求。要生成 API 密钥，执行以下步骤：

在同一页面上，您可以查看您的计划：如果相关的 Google Cloud 项目没有计费，则为 免费；如果相关的 Google Cloud 项目启用了计费，则为 按需付费。 计划的比较可以在 此定价页面 上查看。主要区别包括：免费计划有限制，免费的提示/响应用于产品改进。

选项

Google 生成式 AI 的选项可以通过用户界面设置，具体步骤如下：

  • 浏览到您的 Home Assistant 实例。
  • 转到 设置 > 设备与服务。
  • 如果配置了多个 Google 生成式 AI 实例，请选择您想配置的实例。
  • 选择集成，然后选择 配置。
说明

AI 如何响应您的请求的说明。它是使用 Home Assistant 模板 编写的。

控制 Home Assistant

如果允许模型与 Home Assistant 交互。它只能控制或提供有关 暴露 的实体的信息。

推荐设置

如果启用，将选择推荐的模型和设置。

如果您选择不使用推荐设置，您可以配置以下选项：

模型

用于生成响应的模型。

温度

响应中允许的创造力。更高的值会生成更随机和多样的响应。温度为零将是确定性的。

Top P

顶级 p 采样的概率阈值。

Top K

生成期间考虑的最高得分的令牌数量。

返回响应的最大令牌数

AI 模型应该生成的最大单词或“令牌”数。

安全设置

不同 有害类别 的阈值。

与超级马里奥对话

您可以使用此集成来 与超级马里奥对话，并在需要时让他控制您家中的设备。

本教程使用 OpenAI，但这也可以通过 Google 生成式 AI 集成来完成。

行动

生成内容

Tip

此动作与任何集成条目无关，因此它不会使用模型、提示或您选项中的其他设置。如果您只想传递文本，则应使用 conversation.process 动作。

允许您请求 Gemini Pro 或 Gemini Pro Vision 从包含文本和可选附件（图像、PDF 等）的提示生成内容。 此操作将生成的内容填充到 响应数据 中。

数据属性 可选 描述 示例
prompt 否 生成内容的提示。 描述这张图片
filenames 是 附件的文件名，以包含在提示中。 /tmp/image.jpg 
action: google_generative_ai_conversation.generate_content
data:
  prompt: >-
    简要描述我门铃摄像头中看到的图像中所见的内容。
    您的消息需要简短，以适合手机通知。不要描述静止的物体或建筑物。
  filenames: /tmp/doorbell_snapshot.jpg
response_variable: generated_content

响应数据字段 text 将包含生成的内容。

另一个多图像示例：

action: google_generative_ai_conversation.generate_content
data:
  prompt: >-
    简要描述以下一系列图像中发生的事情
    来自我车道摄像头的图像。
  filenames:
    - /tmp/driveway_snapshot1.jpg
    - /tmp/driveway_snapshot2.jpg
    - /tmp/driveway_snapshot3.jpg
    - /tmp/driveway_snapshot4.jpg
response_variable: generated_content

视频教程

本视频教程解释了如何设置 Google 生成式 AI，如何在您到达家时将 AI 生成的消息发送到您的智能音箱，以及如何在有人按门铃时立即分析从门铃摄像头拍摄的图像。

故障排除

  • 为了帮助诊断问题，可以通过将这些内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中来增加详细日志记录：
logger:
  logs:
    homeassistant.components.conversation: debug
    homeassistant.components.google_generative_ai_conversation: debug

相关主题

相关链接