Tuya, 클라우드 API로 Meta의 Muse를 스마트홈 기기에 연결

2026년 11월 12일 Tuya Smart는 클라우드 API를 통해 Meta의 Muse AI 에이전트가 사용자의 Tuya 계정에 연결된 기기를 조회하고 제어할 수 있게 해주는 오픈소스 스킬인 Tuya Cloud Devices를 발표했다. 이 스킬은 로컬 기기 키나 공유 로컬 네트워크, 펌웨어 변경 없이 작동한다.

정식 명칭이 gadget-tuya-cloud-devices인 이 스킬은 Tuya의 기존 tuya-smart-control 스킬을 일반 Markdown 파일 형태로 Muse Gadgets 사양에 맞게 조정한 것입니다. Muse는 대화 기능과 에이전트 기능을 제공하고, Tuya는 기기 연결 기능을 제공합니다. Tuya에 따르면 자사 플랫폼은 200개가 넘는 국가와 지역에서 3,000개 이상의 스마트 하드웨어 카테고리를 지원합니다. 다만 이 수치는 플랫폼의 지원 범위를 나타내며, Muse와 함께 작동하는 것으로 검증된 기기의 수를 의미하지는 않습니다.

이 방식은 Meta의 Muse Gadgets 프로젝트를 통해 사용할 수 있는 추가 하드웨어와 다르다. 해당 프로젝트의 오픈소스 SDK는 ESP32 보드와 Raspberry Pi 또는 기타 Linux 시스템을 지원한다. Muse용 기기를 새로 만드는 대신, Tuya 스킬은 사용자의 클라우드 계정에 이미 연결된 조명, 콘센트, 에어컨, 카메라, 센서를 제어한다.

클라우드 접속으로 기기별 설정 대체

요청 인증에는 무료 API 키 하나만 있으면 됩니다. sk- 접두사 뒤에 오는 두 문자는 계정의 데이터 센터를 식별해 7개 지역 엔드포인트 중 하나를 선택하므로, 엔드포인트를 수동으로 설정할 필요가 없습니다. 또한 사용자는 로컬 키를 설정하지 않아도 됩니다. 로컬 키는 기기를 다시 페어링할 때 무효화될 수 있으며, 이 경우 설정 과정을 반복해야 합니다.

명령을 생성하기 전에 스킬은 기기의 Thing Model을 읽습니다. Thing Model은 지원되는 속성, 읽기·쓰기 권한, 값의 범위와 증분 단위를 표준화해 설명한 것입니다. API 문서에서는 명령을 내리기 전에 해당 모델을 읽도록 권장합니다. 따라서 제품 모델마다 별도로 조정하지 않아도 같은 스킬로 다양한 제품 카테고리를 처리할 수 있습니다. 다만 해당 모델에 맞는 스킬이나 로컬 제어 스킬이 이미 있다면 요청은 먼저 그 스킬로 전달됩니다.

명시적인 제한이 있는 자동화

지원되는 기능에는 집, 방, 기기 목록 조회, 기기 이름 변경, 스위치·밝기·온도·모드 변경, 날씨 및 에너지 통계 확인, 카메라 스냅샷 촬영 또는 최대 60초 길이의 동영상 녹화가 포함됩니다. 실시간 구독은 WebSocket 이벤트를 사용해 속성 변경과 온라인·오프라인 상태를 확인합니다.

이러한 구독 기능을 사용하려면 항상 온라인 상태인 Linux 기기가 필요합니다. Tuya는 Muse Gadgets Linux SDK를 통해 연결된 Raspberry Pi를 예로 들며, Muse가 이 기기에 상주 프로그램을 배포해 이벤트를 수신하고 사용자가 확인한 트리거-액션 자동화를 실행할 수 있다고 설명합니다. 이벤트에 따라 전송되는 알림은 SMS, 음성 통화, 이메일 또는 앱 푸시를 통해 사용자에게만 전달할 수 있으며, 알림 간격은 최소 30분입니다.

기기 제어 과정에는 물리적 기기를 위한 안전장치도 마련되어 있습니다. 요청에 여러 기기가 해당하면 스킬은 각 기기가 있는 방을 표시하고 확인을 요청합니다. 오프라인 기기에 명령을 내리거나 읽기 전용 속성에 값을 쓰지는 않습니다. 명령을 내린 뒤 1~2초 후 상태를 다시 읽어 성공 여부를 확인합니다. 도어록 제어, 실시간 영상, 펌웨어 업그레이드, 네트워크 설정, 기기 페어링 또는 제거, 복합 데이터 유형은 지원 대상에서 제외되며 Tuya 앱으로 안내됩니다. API 키는 요청 헤더에만 사용되고 대화에 노출되지 않으며, 사용자 계정에 속한 기기에만 접근할 수 있습니다.

시험 단계 API와 진행 중인 저장소 검토

기반이 되는 Tuya 저장소는 MIT 라이선스로 공개되어 있지만, 현재 제공되는 모든 API 엔드포인트를 시험 단계로 표시하고 있습니다. 해당 엔드포인트에는 호출 빈도 제한, 호출 할당량 및 기타 사용 제한이 적용됩니다. Muse에 맞춘 버전이 있는 디렉터리에는 이 스킬을 Meta의 프로젝트에 풀 리퀘스트 #61로 제출했으며 현재 검토 중이라고 나와 있습니다. 제출 내용이 병합되기 전까지 Muse Gadgets 저장소에는 공식 기준 버전이 없으며, tuya-smart-control은 Tuya 저장소에서 정식 버전으로 유지됩니다.

Muse는 현재 미국과 캐나다에서 사용할 수 있습니다. 사용자는 Tuya의 GitHub 저장소에서 이 버전을 내려받고 무료 API 키를 신청할 수 있으며, 개발자는 SKILL.md 형식을 지원하는 다른 에이전트에서도 기반 스킬을 재사용할 수 있습니다. Tuya는 이러한 이식성을 통해 브랜드가 에이전트마다 별도의 연동 기능을 구축하지 않고도 더 많은 에이전트 생태계에 연결된 기기를 제공할 수 있다고 설명합니다.

이번 출시는 Muse가 에이전트 전용으로 제작된 하드웨어를 넘어 가정에 이미 설치된 기기까지 활용할 가능성을 넓힙니다. 그러나 당장 활용할 수 있는 범위는 시험 단계 API의 제한과 아직 검토 중인 상위 저장소 제출 건으로 한정됩니다.