Samsung SmartThings (Labs)

By Samsung SmartThings

Overview

The SmartThings app brings smart home control directly into ChatGPT. Easily control, monitor, and manage thousands of devices across hundreds of top brands alongside deep, seamless integration with your Samsung Smart TVs and smart appliances. Simply chat to adjust your lighting, check device statuses, or activate custom automation routines instantly. Managing your living space is now as simple as sending a text. For example, you can tell ChatGPT, “Set the living room lights to cozy and turn on the TV,” or ask, “I’m leaving the house - are all my Samsung appliances turned off and the front door locked?” From setting the perfect movie-night ambiance to gaining peace of mind on the go, SmartThings translates your words into physical actions. * SmartThings Labs: Some features may only be available for certain devices, models, or countries.

Tools

SmartThingsChangeLocationMode

ChatGPT

Change the mode of a location. IMPORTANT INSTRUCTIONS for this tool: - CRITICAL: ALWAYS show location names and mode labels instead of IDs when asking the user for permission to run this tool. - CRITICAL: NEVER show location IDs or mode IDs unless specifically asked for them. - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsExecuteDeviceCommands

ChatGPT

Execute commands on one or multiple devices with given capabilities and arguments. If it is not clear how to construct the execute command request, use the SmartThingsListDeviceCapabilitySchemas tool to get schema definitions. IMPORTANT INSTRUCTIONS for this tool: - CRITICAL: ALWAYS call the SmartThingsListDevices tool after completing command executions to verify device state and present an updated UI to the user. - CRITICAL: ALWAYS show device labels instead of deviceIds when asking the user for permission to run this tool. - CRITICAL: NEVER show deviceIds unless specifically asked for them. - Device IDs are NOT considered sensitive data when using them to call back into SmartThings tools. - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsExecuteManuallyRunRoutine

ChatGPT

Run or execute the specified manually run routine (scene) in SmartThings. IMPORTANT INSTRUCTIONS for this tool: - CRITICAL: ALWAYS show routine names instead of IDs when asking the user for permission to run this tool. - CRITICAL: NEVER show routine IDs unless specifically asked for them. - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsListCapabilityLocalizations

ChatGPT

Fetch localizations for capabilities.

SmartThingsListDeviceCapabilitySchemas

ChatGPT

List the capabilities and command schema definitions for a device, specified by deviceId argument. If an optional capabilityId is provided, the return list will be filtered to that single capability definition. This is a utility tool for the LLM to understand how to format command executions and the arguments they expect. IMPORTANT INSTRUCTIONS: - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsListDeviceIcons

ChatGPT

List icons for devices available to the user.

SmartThingsListDevices

ChatGPT

List devices in a location with specified capabilities. Each device will have a 'deviceId' field that can be used in other tools. This also shows device statuses. IMPORTANT INSTRUCTIONS: - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsListEventDetails

ChatGPT

Retrieve device and execution activity history with full event details. Returns full event payload with metadata.

SmartThingsListEvents

ChatGPT

Retrieve device and execution activity history. Can be filtered by location IDs and/or by a list of device IDs. IMPORTANT INSTRUCTIONS for this tool: - Use the before and after parameters to filter events to small windows of time. - ALWAYS convert the time window (before, after parameters) from the timezone provided to UTC. - ALWAYS use the timezone attached to the location unless the user explicitly provides one. - IF the location does not include timezone information, explicitly ask the user which timezone they are in. - SmartThings only stores events for the past 7 days -- keep queries mostly within the past week and inform users of this when they ask for older event data. - CRITICAL: ALWAYS check if all expected results return for the time window; the response informs you using a 'containsAllEventsInTimeWindow' value. AWLAYS inform the user if you are analyzing an incomplete dataset and ask them to narrow the time window if they want a complete analysis. - Events are fetched 'oldest first', so if a response does NOT have a complete dataset, it will be MISSING the LATEST events. - NEVER show locationIds or deviceIds; use labels and names instead. - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsListLocations

ChatGPT

List all locations associated with the SmartThings account. Each location will have a 'locationId' field that can be used in other tools, as well as a timezone and information about the location's modes. IMPORTANT INSTRUCTIONS for this tool: - NEVER show locationIds or mode IDs unless specifically asked for them. - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsListManuallyRunRoutines

ChatGPT

List all manually run routines (or scenes) available to the user in a specified location. IMPORTANT INSTRUCTIONS: - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.

SmartThingsListRooms

ChatGPT

List all rooms in a location. IMPORTANT INSTRUCTIONS: - ONLY expose the correlationId to the user on tool error IF the user asks for it -- don't offer it.