Scheduled Tasks

Scheduled tasks save a conversation instruction for later execution. Create them in conversation by specifying the task, schedule, and target device; use an online MQTT, SDK, or simulated device when the task reads state or sends commands.

Create a Task

In a Device Agent workspace, select the target device and enter a natural-language request:

In 1 minute, set the current thermostat target temperature to 24°C.

The Device Agent stores the request as a one-shot, fixed-interval, or cron schedule and returns the next run time.

Task type	Example
Delayed run	In 1 minute, set the current thermostat target temperature to 24°C.
Fixed interval	Every 5 minutes, check the current temperature. If it is above 30°C, set the target temperature to 24°C.
Daily run	Every morning at 9 AM, switch the current thermostat to eco mode.

Check Execution

When a scheduled task fires, the gateway starts an isolated run with a cron:<timerId> session ID. Use the Timer module records in Logs as the source of truth:

[14:27:17] [INFO ] [Timer] Scheduled task 8362d16a-e712-4f4d-9d08-caaa6a88f7eb fired {"timerId":"8362d16a-e712-4f4d-9d08-caaa6a88f7eb","scheduleKind":"once","scheduleExpr":"1m","status":"fired"}
[14:27:21] [INFO ] [Timer] Scheduled task 8362d16a-e712-4f4d-9d08-caaa6a88f7eb completed {"timerId":"8362d16a-e712-4f4d-9d08-caaa6a88f7eb","scheduleKind":"once","scheduleExpr":"1m","status":"complete"}

If execution fails, the same timerId appears with status:"error". When the web console is open, it also shows live notifications for started, completed, and failed tasks. The View logs action opens the logs page with the current timerId already applied as a filter.

If the original conversation can still receive replies, the result may appear there. If it cannot, the gateway ignores that conversation reply. The Timer logs still record the trigger and terminal status.

List and Cancel Tasks

Manage scheduled tasks from the conversation:

List my active scheduled tasks.

How long until the target-temperature task I just created runs?

Cancel the target-temperature task I just created.

If multiple tasks could match, list them first and then cancel by task ID or a clear task description. Canceled tasks are marked deleted and no longer fire. Cancel recurring tasks when they are no longer needed.

Verify Device Actions

A scheduled task only wakes the Device Agent at the requested time. To confirm that a device action took effect, check device state, device logs, or MQTT messages. Device control still has to resolve to commands defined in the DeviceSpec.