Partnership
Tuya collega Muse di Meta ai dispositivi per la casa intelligente tramite API cloud

Il 12 novembre 2026, Tuya Smart ha annunciato Tuya Cloud Devices, una funzionalità open source che consente all’agente IA Muse di Meta di interrogare e controllare i dispositivi presenti nell’account Tuya di un utente tramite API cloud, senza chiavi locali dei dispositivi, senza una rete locale condivisa e senza modifiche al firmware.
La funzionalità, il cui nome formale è gadget-tuya-cloud-devices, adatta la funzionalità tuya-smart-control già esistente di Tuya alle specifiche di Muse Gadgets, sotto forma di un semplice file Markdown. Muse fornisce capacità conversazionali e agentiche; Tuya offre la connettività dei dispositivi. Tuya dichiara che la sua piattaforma copre oltre 3.000 categorie di dispositivi hardware intelligenti in più di 200 paesi e regioni, anche se questi dati si riferiscono alla piattaforma e non ai dispositivi di cui è stata verificata la compatibilità con Muse.
L’approccio si differenzia dagli accessori hardware abilitati dal progetto Muse Gadgets di Meta, i cui SDK open source supportano le schede ESP32 e Raspberry Pi o altri sistemi Linux. Invece di costruire un altro dispositivo per Muse, la funzionalità di Tuya permette di gestire luci, prese, condizionatori, telecamere e sensori già collegati all’account cloud dell’utente.
L’accesso cloud elimina la configurazione di ogni singolo dispositivo
Per autenticare le richieste basta una sola chiave API gratuita. I due caratteri che seguono il prefisso sk- identificano il centro dati dell’account e selezionano uno dei sette endpoint regionali, eliminando la necessità di configurare manualmente l’endpoint. Gli utenti evitano anche di configurare le chiavi locali, che possono diventare non valide quando si abbina di nuovo un dispositivo, rendendo necessario ripetere la procedura di configurazione.
Prima di generare un comando, la funzionalità legge il Thing Model del dispositivo, una descrizione standardizzata delle proprietà supportate, delle autorizzazioni di lettura e scrittura, degli intervalli dei valori e degli incrementi. La documentazione delle API consiglia di leggere il modello prima di impartire comandi. In questo modo, la stessa funzionalità può gestire diverse categorie di prodotti senza richiedere un adattamento distinto per ogni modello; le richieste vengono invece indirizzate prima a una funzionalità specifica del modello o di controllo locale, se già disponibile.
Automazione con limiti espliciti
Le interazioni supportate includono la visualizzazione di abitazioni, stanze e dispositivi; la ridenominazione dei dispositivi; la modifica di interruttori, luminosità, temperatura o modalità; il controllo delle condizioni meteo e delle statistiche sui consumi energetici; e l’acquisizione di istantanee o video delle telecamere della durata massima di 60 secondi. Le sottoscrizioni in tempo reale utilizzano eventi WebSocket per segnalare le modifiche alle proprietà e lo stato online o offline.
Queste sottoscrizioni richiedono un dispositivo Linux sempre connesso. Tuya descrive una Raspberry Pi collegata tramite Muse Gadgets Linux SDK, sulla quale Muse può installare un programma residente che riceve gli eventi ed esegue automazioni di attivazione e azione confermate dall’utente. Le notifiche attivate dagli eventi possono essere inviate esclusivamente all’utente tramite SMS, chiamata vocale, e-mail o notifica push dell’app, con un intervallo di almeno 30 minuti tra un avviso e l’altro.
Il flusso di controllo prevede inoltre misure di sicurezza per i dispositivi fisici. Se più dispositivi corrispondono a una richiesta, la funzionalità indica le stanze in cui si trovano e chiede conferma; non invia comandi ai dispositivi offline né modifica proprietà di sola lettura. Dopo un comando, legge nuovamente lo stato dopo uno o due secondi prima di confermare l’esito positivo. Il controllo delle serrature, il video in diretta, gli aggiornamenti del firmware, la configurazione della rete, l’abbinamento o la rimozione dei dispositivi e i tipi di dati complessi non sono supportati e vengono rimandati all’app Tuya. La chiave API viene usata solo nelle intestazioni delle richieste, non viene riproposta nelle conversazioni e consente di accedere soltanto ai dispositivi presenti nell’account dell’utente.
API in fase di prova e revisione upstream in corso
Il repository di Tuya alla base del progetto è distribuito con licenza MIT, ma indica che tutti gli endpoint API attualmente disponibili sono in fase di prova e soggetti a limiti di frequenza, quote di chiamate e altre restrizioni d’uso. La cartella dell’adattamento per Muse specifica che la funzionalità è stata sottoposta al progetto di Meta con la pull request n. 61 e che la revisione è ancora in corso. Finché la proposta non verrà integrata, il repository di Muse Gadgets non conterrà la copia ufficiale: tuya-smart-control rimane la versione di riferimento nel repository di Tuya.
Muse è attualmente disponibile negli Stati Uniti e in Canada. Gli utenti possono scaricare l’adattamento dal repository GitHub di Tuya e richiedere una chiave API gratuita; gli sviluppatori possono invece riutilizzare la funzionalità di base con altri agenti che supportano il formato SKILL.md. Tuya afferma che questa portabilità potrebbe consentire ai marchi di rendere accessibili i dispositivi connessi a un maggior numero di ecosistemi di agenti senza dover realizzare un’integrazione distinta per ciascun agente.
Questa versione amplia il potenziale raggio d’azione di Muse, andando oltre l’hardware progettato appositamente per l’agente e includendo dispositivi già installati nelle abitazioni. Tuttavia, le possibilità pratiche immediate restano limitate dalle restrizioni delle API in fase di prova e dal fatto che la proposta è ancora in attesa di revisione upstream.












