Tuya conecta o Muse, da Meta, a dispositivos domésticos inteligentes por meio de APIs na nuvem

Em 12 de novembro de 2026, a Tuya Smart anunciou o Tuya Cloud Devices, uma habilidade de código aberto que permite ao agente de IA Muse, da Meta, consultar e controlar dispositivos na conta Tuya de um usuário por meio de APIs na nuvem, sem chaves locais dos dispositivos, uma rede local compartilhada ou alterações no firmware.

A habilidade, cujo nome oficial é gadget-tuya-cloud-devices, adapta a habilidade tuya-smart-control já existente da Tuya à especificação Muse Gadgets em um arquivo Markdown simples. O Muse fornece recursos de conversação e de agente; a Tuya oferece conectividade com dispositivos. Segundo a Tuya, sua plataforma abrange mais de 3.000 categorias de hardware inteligente em mais de 200 países e regiões, embora esses números se refiram à plataforma, e não a dispositivos cuja compatibilidade com o Muse tenha sido verificada.

Essa abordagem difere do hardware adicional viabilizado pelo projeto Muse Gadgets, da Meta, cujos SDKs de código aberto são compatíveis com placas ESP32 e Raspberry Pi ou outros sistemas Linux. Em vez de criar outro dispositivo para o Muse, a habilidade da Tuya permite controlar luzes, tomadas, aparelhos de ar-condicionado, câmeras e sensores que já estão conectados à conta do usuário na nuvem.

O acesso pela nuvem elimina a configuração de cada dispositivo

Uma única chave de API gratuita autentica as solicitações. Os dois caracteres após o prefixo sk- identificam o centro de dados da conta e selecionam um entre sete endpoints regionais, eliminando a necessidade de configurar o endpoint manualmente. Os usuários também evitam configurar chaves locais, que podem se tornar inválidas quando um dispositivo é pareado novamente, obrigando a repetir o processo de configuração.

Antes de gerar um comando, a habilidade consulta o Thing Model do dispositivo, uma descrição padronizada das propriedades compatíveis, das permissões de leitura e gravação, dos intervalos de valores e dos incrementos. A documentação da API recomenda consultar esse modelo antes de emitir comandos. Assim, a mesma habilidade pode lidar com diferentes categorias de produtos sem exigir uma adaptação específica para cada modelo, enquanto as solicitações são encaminhadas primeiro a uma habilidade específica do modelo ou de controle local, quando já existe uma.

Automação com limites explícitos

As interações compatíveis incluem listar casas, cômodos e dispositivos; renomear dispositivos; alterar interruptores, brilho, temperatura ou modo; consultar o clima e estatísticas de consumo de energia; e capturar imagens ou vídeos de câmeras com até 60 segundos de duração. As assinaturas em tempo real usam eventos WebSocket para informar alterações nas propriedades e o status de conexão ou desconexão.

Essas assinaturas exigem um dispositivo Linux que permaneça sempre conectado. A Tuya descreve uma configuração com um Raspberry Pi conectado por meio do Muse Gadgets Linux SDK, na qual o Muse pode implantar um programa residente que recebe eventos e executa automações de gatilho e ação confirmadas pelo usuário. As notificações acionadas por eventos podem ser enviadas somente ao usuário, por SMS, chamada de voz, e-mail ou notificação push no aplicativo, com pelo menos 30 minutos entre os alertas.

O fluxo de controle também conta com salvaguardas para dispositivos físicos. Quando vários dispositivos correspondem a uma solicitação, a habilidade informa em quais cômodos eles estão e pede confirmação; ela não envia comandos a dispositivos desconectados nem grava em propriedades somente de leitura. Um ou dois segundos após o envio de um comando, consulta novamente o status antes de confirmar que a ação foi concluída. O controle de fechaduras, o vídeo ao vivo, as atualizações de firmware, a configuração de rede, o pareamento ou a remoção de dispositivos e os tipos de dados complexos estão excluídos e devem ser realizados pelo aplicativo da Tuya. A chave de API é usada apenas nos cabeçalhos das solicitações, não é reproduzida nas conversas e só pode acessar dispositivos da conta do usuário.

APIs em fase de teste e análise upstream pendente

O repositório subjacente da Tuya usa a licença MIT, mas classifica todos os endpoints de API atualmente disponíveis como estando em fase de teste, sujeitos a limites de taxa, cotas de chamadas e outras restrições de uso. O diretório de adaptação para Muse informa que a habilidade foi enviada ao projeto da Meta como solicitação de integração nº 61 e continua em análise. Até que essa solicitação seja incorporada, o repositório Muse Gadgets não contém a cópia oficial; tuya-smart-control continua sendo a versão canônica no repositório da Tuya.

Atualmente, o Muse está disponível nos Estados Unidos e no Canadá. Os usuários podem obter a adaptação no repositório da Tuya no GitHub e solicitar uma chave de API gratuita, enquanto os desenvolvedores podem reutilizar a habilidade subjacente com outros agentes compatíveis com o formato SKILL.md. Segundo a Tuya, essa portabilidade pode permitir que as marcas disponibilizem dispositivos conectados em mais ecossistemas de agentes, sem criar uma integração separada para cada agente.

O lançamento amplia o alcance potencial do Muse para além do hardware desenvolvido especificamente para o agente, incluindo dispositivos já instalados nas residências. No entanto, seu alcance prático imediato é limitado pelas restrições das APIs em fase de teste e por uma solicitação ainda em análise no projeto original.