Anthropic Conversation

The Anthropic integrationsIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] adds a conversation agent powered by Anthropic, such as Claude 3.5 Sonnet, in Home Assistant.

Controlling Home Assistant is done by providing the AI access to the Assist API of Home Assistant. You can control what devices and entities it can access from the exposed entities page. The AI can provide you information about your devices and control them.

Legal note: Anthropic currently limits the API usage to organizations only, more info here: Can I use the Claude API for individual use?

This integration does not integrate with sentence triggers.

Prerequisites

Generating an API Key

The Anthropic API key is used to authenticate requests to the Anthropic API. To generate an API key, take the following steps:

  1. Log in to the Anthropic portal or sign up for an account.
  2. Enable billing with a valid credit card on the plans page.
  3. Visit the API Keys page to retrieve the API key you’ll use to configure the integration.

Configuration

To add the Anthropic Conversation service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Anthropic Conversation.

  • Follow the instructions on screen to complete the setup.

Options

Options for Anthropic Conversation can be set via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.
  • Go to Settings > Devices & Services.
  • If multiple instances of Anthropic Conversation are configured, choose the instance you want to configure.
  • Select the integration, then select Configure.
Instructions

Instructions for the AI on how it should respond to your requests. It is written using Home Assistant Templating.

Control Home Assistant

If the model is allowed to interact with Home Assistant. It can only control or provide information about entities that are exposed to it.

Recommended settings

If enabled, the recommended model and settings are chosen.

If you choose not to use the recommended settings, you can configure the following options:

Model

The model that will complete your prompt. See models for additional details and options.

Maximum Tokens to Return in Response

The maximum number of tokens to generate before stopping. Note that our models may stop before reaching this maximum. This parameter only specifies the absolute maximum number of tokens to generate. Different models have different maximum values for this parameter. See models for details.

Temperature

Amount of randomness injected into the response. Use temperature closer to 0.0 for analytical / multiple choice, and closer to 1.0 for creative and generative tasks. Note that even with temperature of 0.0, the results will not be fully deterministic.