Uma instalação Home Assistant torna-se mais difícil de manter quando salas, dispositivos e entidades são nomeados de forma inconsistente. Um sensor pode ser listado por modelo de fábrica, uma luz pode usar uma abreviatura que apenas uma pessoa entende e duas salas podem conter nomes de dispositivos semelhantes.
LinknLink App pode conectar dispositivos Home Assistant com cenas e fluxos de trabalho Agent+ de linguagem natural. Nomes consistentes ajudam o usuário a confirmar a sala e o dispositivo corretos antes que uma rotina seja preparada ou executada. Este guia cobre organização e revisão, não uma instrução para renomear todas as entidades de uma só vez
Por que nomeia Matter em automações Home Assistant
Torne os alvos legíveis
Use nomes que identifiquem a sala, a função do dispositivo e o tipo de medição ou controle.
Reduza a ambiguidade
Mantenha dispositivos semelhantes distinguíveis quando uma cena contém várias salas.
Mantenha a automação revisável
Torne as propostas do Agent+ e as chamadas de serviço Home Assistant mais fáceis de verificar.
Nomes claros fornecem a LinknLink App e Home Assistant uma camada estável legível por humanos. Eles facilitam a revisão dos alvos da cena, reduzem a ambiguidade nas solicitações do Agent+ e ajudam a diagnosticar uma rotina sem alterar o dispositivo ou a integração subjacente.
Antes de começar
- Exporte ou faça backup da configuração Home Assistant antes de alterar os IDs da entidade.
- Liste as salas, áreas, dispositivos e entidades que são efetivamente utilizadas pelas automações.
- Escolha palavras em minúsculas, um separador estável e uma ordem para termos de ambiente e dispositivo.
- Registre integrações ou scripts que possam referenciar valores de entidade_id diretamente.
- Teste uma automação não crítica antes de aplicar um padrão de nomenclatura a um andar inteiro.
Planeje, renomeie, teste e mantenha seu mapa de entidades
1. Defina o vocabulário da sala
Escolha uma grafia para ambientes como sala, quarto, cozinha e entrada. Evite alternar entre abreviações e nomes completos.
2. Dê um nome à função do dispositivo
Use uma função consistente, como luz de teto, luminária de mesa, ar condicionado, TV, cortina ou sensor de presença.
3. Adicione o tipo de medição ou controle
Para sensores, adicione termos como presença, temperatura, umidade ou iluminância quando a entidade representar um valor específico.
4. Separe dispositivos semelhantes
Adicione um termo de localização, zona ou posição quando uma sala tiver dois sensores ou várias luzes com a mesma função.
5. Verifique os IDs das entidades geradas
Revise o entidade_id resultante e confirme se scripts, painéis e automações ainda fazem referência ao destino pretendido.
6. Teste de LinknLink App
Use uma solicitação restrita ou uma visualização de cena, confirme a sala e o dispositivo e verifique o estado Home Assistant após a aprovação.
7. Documente o padrão
Salve a convenção de nomenclatura ao lado do backup Home Assistant para que dispositivos futuros sigam a mesma estrutura.
Exemplos de solicitações e o que revisar
| Caso de uso | Solicitação de exemplo | Revise antes da ação |
|---|---|---|
| Sensor de presença | Use presença na sala de estar em vez do nome do modelo de fábrica. | O espaço e a medida são explícitos; use a mesma grafia da sala em todos os lugares. |
| Sensor climático | Use a temperatura e a umidade do quarto como entidades separadas. | Não misture abreviações com nomes completos de medidas na mesma área. |
| Dispositivo IR | Use living-room-ac para o alvo do dispositivo em uma cena IR. | A função do dispositivo é clara para uma cena IR ou uma chamada de serviço Home Assistant. |
| Dispositivo RF | Use porch-rf-light quando o local e RF controlados funcionam ambos matter. | A localização, a função do protocolo e a função do dispositivo são fáceis de distinguir. |
| Duas lâmpadas | Use office-desk-lamp em vez de desk-lamp-1 quando a localização for conhecida. | Prefira um local significativo a números que perdem o contexto posteriormente. |
Use as etapas de leitura, preparação, aprovação e execução
| Palco | Tarefa do agente | Controle de usuário |
|---|---|---|
| Leia | Inspecione apenas a fonte permitida. | Escolha o aplicativo, intervalo de datas, sala, pasta ou conta. |
| Prepare-se | Extraia entidades e construa um rascunho ou plano proposto. | Verifique suposições, informações faltantes e recursos afetados. |
| Aprovar | Apresente a ação e o destino. | Confirme ou revise antes da execução. |
| Executar | Execute a ação suportada após a aprovação. | Verifique o resultado e mantenha um caminho de reversão quando possível. |
Lista de verificação de revisão
- O nome identifica um cômodo ou área sem depender de taquigrafia particular?
- Outro membro da família pode dizer se é um sensor, luz, aparelho ou cena?
- As entidades de presença, temperatura e umidade são distinguíveis umas das outras?
- As automações, painéis e scripts existentes ainda têm como alvo o entidade_id correto?
- Uma proposta LinknLink App ou Agent+ pode ser revisada apenas pelo nome?
Privacidade, permissões e padrões mais seguros
As tarefas entre aplicativos podem abranger comunicações pessoais, calendários, arquivos, fotos, locais e dispositivos domésticos. Conceda a menor permissão útil, mantenha dados não relacionados fora do escopo e evite compartilhar credenciais, senhas, códigos únicos ou detalhes de contas privadas.
Use rascunhos para mensagens e anexos. Use visualizações de cena para alterações em casa inteligente. Mantenha compras, controle de acesso, dispositivos de segurança e ações destrutivas de arquivos por trás de confirmação humana explícita.
Solução de problemas
Uma automação foi interrompida após uma renomeação
Pesquise automações, scripts, painéis e modelos para o antigo entidade_id e, em seguida, restaure ou atualize as referências, uma de cada vez.
Agent+ seleciona o dispositivo errado
Adicione a função da sala e do dispositivo à solicitação, remova nomes duplicados e solicite uma visualização antes da execução.
Temperatura e umidade não são claras
Use termos de medição separados e documente se o valor vem de um cabo, um sensor Bluetooth ou outra integração.
O ID da entidade não é igual ao nome de exibição
Trate o entidade_id gerado como o identificador técnico e mantenha uma pequena tabela de mapeamento após qualquer alteração.
Um dispositivo aparece duas vezes
Verifique duplicatas de integração, atribuição de área e entidades desabilitadas antes de criar outra automação.
Produtos LinknLink relacionados
- HomeClaw: um Home Assistant local e um caminho de gateway AI.
- eMotion Ultra: Presença de 60 GHz, contexto climático através do cabo do sensor e IR integrado.
- eMotion Pro: Presença na sala de 24 GHz e sinais de automação suportados.
- eRemote HA: controle local IR para dispositivos compatíveis em Home Assistant.
- eHome HA: Controle IR/RF e fluxos de trabalho Home Assistant.
Guias LinknLink App e Home Assistant relacionados
- LinknLink App Guia de recursos
- LinknLink Guia de primeira ação do agente móvel
- LinknLink App Guia de automação
- LinknLink App Guia de diagnóstico do agente +
- Home Assistant Acesso remoto gratuito com o LinknLink App
Perguntas frequentes
Por que a entidade Home Assistant nomeia a entidade matter?
Nomes consistentes facilitam a leitura, revisão e manutenção de automações, painéis e metas de serviço.
Qual padrão de nomenclatura funciona para sensores de presença?
Um padrão de função de ambiente, como presença na sala de estar ou presença no quarto, é claro, desde que o mesmo vocabulário de ambiente e função seja usado de forma consistente.
Devo renomear os IDs das entidades imediatamente?
Faça backup primeiro, identifique referências e teste uma automação não crítica antes de fazer alterações mais amplas.
Limpar nomes pode ajudar nas solicitações LinknLink App Agent+?
Sim. Os nomes das funções da sala e do dispositivo fornecem um contexto mais claro quando o aplicativo prepara uma cena ou ação Home Assistant para revisão.
Como as entidades de temperatura e umidade devem ser rotuladas?
Use termos explícitos, como temperatura e umidade do quarto, e documente o dispositivo de origem ou a conexão do sensor.
Comece com um quarto
Escolha uma sala, anote o padrão de nomenclatura pretendido, teste uma automação reversível e expanda somente depois que os alvos da entidade forem fáceis de verificar.