Voltar ao Blog
AI AgentsHome AssistantSmart Home

Agente de IA + Home Assistant: uma integração realista

Como juntar o Home Assistant a um agente de IA de verdade em 2026: o que o agente embutido faz bem, onde o MCP entra e quando o Hermes ajuda.

Por Hermify Team||9 min de leitura
Painel de controle escuro com o logo azul do Home Assistant à esquerda e um grafo verde de ferramentas MCP à direita, ligados por uma linha verde fina e brilhante

O cenário do Home Assistant em 2026

O Home Assistant já traz os próprios agentes de conversação. Desde a release de setembro de 2025 "AI in Home Assistant", você pode plugar OpenAI, Anthropic, Google ou um servidor Ollama local direto no pipeline do Assist e fazer com que ele controle seus dispositivos, escreva automações e responda perguntas sobre a sua casa. Se acompanhou o assunto neste ano, a grande mudança é que modelos pequenos com function-calling como o Qwen3 8B agora resolvem essas chamadas de ferramenta com confiabilidade em um mini PC, então todo o loop pode ficar local.

Isso cobre boa parte do que as pessoas procuram quando digitam "ai agent home assistant integration". Mas não cobre tudo. O que o Home Assistant não te dá pronto de fábrica é um agente persistente, orientado por mensagens, que vive fora da casa, lembra de coisas entre estações, faz checagens agendadas e te alcança no celular quando ninguém está de frente para um painel de parede. É onde um agente externo, conectado por MCP, ganha o seu espaço.

O que os agentes embutidos fazem bem

Antes de adicionar qualquer coisa, entenda o que você já tem. O pipeline Assist do Home Assistant é a camada de roteamento: entra microfone, sai ação. Você conecta um agente de conversação a ele, e esse agente decide como um comando falado vira uma chamada de serviço.

Os caminhos suportados hoje:

  • Integrações de conversação de OpenAI, Anthropic e Google - modelo na nuvem, rápido, bom tool-calling. Sua voz e seu texto saem para o fornecedor.
  • Integração com Ollama - aponta para um servidor Ollama local. Em 2026 isso é viável em produção para casas com um mini PC ou NUC. O Qwen3 8B é o ponto de equilíbrio atual para latência de tool-calling.
  • Local LLM Conversation - um cliente genérico compatível com OpenAI. Útil se você auto-hospeda algo diferente de Ollama (llama.cpp, vLLM, LM Studio).

Qualquer um dos três já resolve o caso base: "apague as luzes da cozinha", "coloque o termostato em 20", "a porta da garagem está aberta?" Você não precisa do Hermes para isso. Se o seu objetivo é um assistente de voz privado dentro de casa que conversa com os seus dispositivos, escolha o caminho Ollama e pare de ler aqui.

Onde os agentes embutidos deixam a desejar

Os agentes embutidos são, por design, muito restritos: eles respondem, agem e depois esperam a próxima fala. Esse modelo quebra em três frentes.

  • Sem contexto persistente ao longo do tempo. Pergunte ao Assist "quanto gastamos de luz no mês passado" e ele vai olhar apenas o que o contexto atual permite. Ele não lembra que no mês passado você pediu para reduzir o consumo em standby, ou que trocou a geladeira em abril. Cada sessão começa do zero.
  • Sem agenda proativa. O pipeline Assist é reativo. Você pode montar automações clássicas por gatilhos, e escrever automações redigidas por LLM com o botão Suggest, mas não dá para pedir facilmente ao agente que "todo domingo de manhã, olhe os dados de energia da semana, me diga quais dispositivos ficaram mais tempo ligados e sinalize qualquer coisa fora do padrão". Isso é trabalho de agente, não de automação.
  • Sem superfície conversacional fora da casa. O Assist vive no app e no hardware Voice. Se você quer checar a caldeira no escritório, ou pedir ao agente um resumo semanal por chat, sai completamente da superfície do Home Assistant.

Essas lacunas não são bugs. São o que acontece quando um agente de conversação é desenhado para ser uma camada de controle, não um copiloto.

A ponte MCP que mudou o quadro

A integração do Model Context Protocol que o Home Assistant lançou em 2025 é a peça que faltava. O Home Assistant agora roda um servidor MCP embutido que expõe seus dispositivos, estados, áreas e intents do Assist como ferramentas MCP. Qualquer agente compatível com MCP consegue se conectar a esse servidor e controlar a sua casa com as mesmas primitivas que o Assist usa.

Esse é o detalhe que destrava um agente externo de verdade. Em vez de escrever uma integração dedicada com o Home Assistant para cada produto de IA, você aponta um agente MCP para a URL do seu Home Assistant, entrega um token de acesso de longa duração e ele herda todo o toolset do Assist. O servidor MCP do Home Assistant já expõe da ordem de 95+ ferramentas, cobrindo luzes, clima, segurança, mídia, sensores e cenas.

Se você já usou o Hermes Agent com MCP para GitHub ou Slack, o modelo mental é idêntico aqui. A casa é só mais um servidor MCP.

Onde um agente externo como o Hermes se encaixa

Um agente externo não substitui o Home Assistant. O Home Assistant continua no comando dos dispositivos, do estado e do hardware físico; é nisso que ele é bom. O agente externo se senta em cima e cuida das partes para as quais o Assist não foi desenhado: memória entre sessões, raciocínio agendado e uma superfície de chat que te acompanha para fora da casa.

Concretamente, um setup que recomendamos:

  • Home Assistant em um Raspberry Pi, NUC ou no seu homelab. Roda o servidor MCP (integração mcp_server) e continua dono das automações e dashboards.
  • Hermes Agent em um VPS de US$ 5, no mesmo host do homelab ou como instância gerenciada pela Hermify. Configurado com o servidor MCP do Home Assistant como uma das suas fontes de ferramentas.
  • Telegram como superfície conversacional. Você fala com o Hermes; o Hermes fala com o Home Assistant.

Com essa forma, três coisas ficam fáceis e antes eram desconfortáveis:

  1. Memória persistente da casa. O Hermes mantém arquivos de memória estilo USER.md com fatos que você contou uma vez: "a geladeira é uma Bosch KGN, trocada em abril de 2026", "no verão o setpoint é 24, no inverno 20", "as crianças vão dormir 20:30 em dia de escola". O Assist esquece isso entre chamadas. O Hermes lembra.
  2. Checagens agendadas com raciocínio de verdade. "Todo domingo às 10, resuma o consumo de energia da semana, diga os três dispositivos com mais horas ligadas e sinalize o que ficou acima da média do mês passado." O Home Assistant dispara a agenda, o Hermes raciocina sobre os dados via chamadas MCP e o resultado cai no Telegram.
  3. Superfície de chat fora da casa. Você está em uma reunião e alguém pergunta se as luzes do escritório continuam acesas. Pergunte ao Hermes. Ele consulta o servidor MCP do Home Assistant, pega o estado e responde. No mesmo fio de Telegram que você já usa no dia a dia.

Quando escolher cada caminho

Escolha um com honestidade. Adicionar um agente externo quando o Assist já basta só multiplica peças móveis.

  • Só controle local por voz dos dispositivos, privado e rápido? Ollama + Assist. Pronto.
  • Controle local por voz mais automações por agenda? Assist + as automações clássicas do Home Assistant, sem agente externo. Use o botão Suggest ao escrever.
  • Controle local por voz, memória persistente, superfície de chat externa e raciocínio agendado? Assist para o loop de wake-word, Hermes por MCP para o resto. É esse o setup deste post.
  • Sem hardware de wake-word, mais chat, mas ainda quer controlar dispositivos? Você pode pular todo o lado do wake-word e mandar tudo pelo Hermes no Telegram. Pediu, executou, respondeu.

Para a decisão mais profunda entre rodar o Hermes você mesmo ou deixar a Hermify gerenciar, já destrinchamos em Hermes Agent auto-hospedado vs gerenciado. Nada da integração com o Home Assistant altera esse trade-off. A configuração MCP é a mesma nos dois casos.

Um esboço da fiação

O setup completo está documentado por componente, mas o formato do config é curto o suficiente para incluir aqui, para você ver o que significa de verdade "conectar o Hermes à sua casa".

Do lado do Home Assistant, habilite a integração do servidor MCP e gere um token de acesso de longa duração. Você fica com um endpoint MCP e um bearer token.

Do lado do Hermes, adicione o servidor MCP do Home Assistant à configuração do agente:

{
  "mcpServers": {
    "home-assistant": {
      "url": "https://ha.seu-dominio.tld/mcp_server/sse",
      "headers": {
        "Authorization": "Bearer <token-de-longa-duracao>"
      }
    }
  }
}

Reinicie o agente. Ele faz introspection no servidor, aprende os nomes dos seus dispositivos e adiciona à sua lista de ferramentas. Na próxima mensagem no Telegram, "desliga a luz da varanda" vira uma chamada de serviço real no Home Assistant, executada com as mesmas permissões que o Assist usa.

A superfície de segurança é a padrão do MCP: o token é poderoso, mantenha fora do controle de versão, coloque a URL do Home Assistant atrás de um proxy reverso ou de Tailscale em vez de expor à internet aberta. Se quer uma versão de ponta a ponta do caminho em rede privada, nosso walkthrough de assistente privado auto-hospedado percorre esse padrão para o Hermes em geral.

O que isso não faz

Os limites honestos, antes de você se comprometer:

  • Não substitui o Home Assistant. Sem dashboards, sem stack ZigBee, sem blueprints embutidos. Tudo isso continua.
  • Não é um pipeline de voz em tempo real dentro do cômodo. A escuta ambiente com wake-word continua sendo do Assist e do seu hardware de voz. O Hermes é chat-first com voz opcional no Telegram, não um substituto de painel de parede.
  • Não elimina a nuvem por completo se você usa um LLM hospedado para o Hermes. As chamadas MCP ficam dentro da sua rede, mas se você aponta o Hermes para OpenRouter ou provedor de modelo similar, o raciocínio acontece fora da casa. Para manter tudo local, rode o Hermes com um provedor de modelo baseado em Ollama e o stack vira totalmente local.

Por onde seguir

Se quer testar o setup de ponta a ponta e pular a manutenção do servidor, comece com a Hermify. Você ganha um Hermes Agent gerenciado no Telegram, conecta o servidor MCP do Home Assistant a ele e o resto é conversa. Se preferir rodar todo o stack, a mesma fiação MCP funciona local; a única decisão é se quer que a Hermify também cuide do VPS.

De qualquer forma, a divisão útil é a mesma: o Home Assistant permanece como fonte da verdade da sua casa, e o agente de IA vive uma camada acima, onde memória, agenda e conversa realmente pertencem.

Fontes

Lance seu próprio agente Hermes

Traga sua chave de API, conecte o Telegram e tenha um agente de IA que evolui sozinho no ar em 60 segundos.

Começar agora