Scheduled Message Task Management
Manage scheduled message tasks through scripts, supporting create, list, get, update, and delete operations.
Core Capabilities
- Create one-time or recurring scheduled message tasks
- Query and filter existing scheduled task lists
- Get task details
- Update task configuration (name, time, enabled status, etc.)
- Delete tasks
Quick Start
Typical Workflow
1. Create task (create.py)
↓ Get returned schedule_id
2. Query list (list.py) - Optional
↓ Confirm task was created
3. Get details (get.py) - Optional
↓ View complete task info
4. Update task (update.py) - As needed
5. Delete task (delete.py) - As neededAvailable Scripts
create.py - Create Scheduled Task
Create a new scheduled message task.
SYNOPSIS
python scripts/create.py --task-name <name> --message-content <content> --type <type> --time <HH:MM> [OPTIONS]DESCRIPTION
Create a scheduled message task, supporting one-time execution and daily/weekly/monthly repeat modes.
When to pass --specify-topic 1: Pass 1 only when both hold: (1) the task is recurring (daily_repeat / weekly_repeat / monthly_repeat), and (2) the user intent implies that the next run time or trigger depends on the current or previous run's result (e.g. "run again 3 days after each completion", "next time based on last result"). For one-time tasks or fixed-schedule tasks that do not depend on previous results, omit this option or pass 0.
OPTIONS
| Option | Type | Required | Description | |
|---|---|---|---|---|
--task-name <name> | string | Yes | Task name | |
--message-content <content> | string | Yes | Message content (same as detail message_content/task_describe) | |
--type <type> | string | Yes | Schedule type, see table below | |
--time <HH:MM> | string | Yes | Execution time | |
--day <value> | string | Conditional | Depends on schedule type, see table below | |
--deadline <YYYY-MM-DD HH:MM:SS> | string | No | Expiry datetime; format YYYY-MM-DD HH:MM:SS. If only date or unclear format is given, the system will interpret and complete (e.g. to 00:00:00 that day) | |
| `--specify-topic <0\ | 1>` | integer | No | Whether to specify topic; 0=no, 1=yes; default 0. Pass 1 only when the user intent is a recurring task whose next run depends on the previous run's result; otherwise use default 0 |
Schedule type --type and --day mapping:
--type | Description | --day |
|---|---|---|
no_repeat | No repeat, one-time execution | Execution date YYYY-MM-DD (required) |
daily_repeat | Repeat daily | Not needed |
weekly_repeat | Repeat weekly | Day of week 0-6, 0=Sunday (required) |
monthly_repeat | Repeat monthly | Day of month 1-31 (required) |
OUTPUT
On success: {"id": "<schedule_id>"}
EXAMPLES
python scripts/create.py \
--task-name "每日早报" \
--message-content "请生成今日早报" \
--type daily_repeat \
--time "9:00"list.py - Query Task List
Query the scheduled task list with optional filtering.
SYNOPSIS
python scripts/list.py [OPTIONS]DESCRIPTION
Query all scheduled tasks or filter by conditions, with pagination support. Results are scoped to the current project; project_id is taken from the current session and must not be passed.
OPTIONS
| Option | Type | Required | Description | |
|---|---|---|---|---|
--task-name <name> | string | No | Fuzzy search by task name | |
| `--enabled <0\ | 1>` | integer | No | 1=enabled 0=disabled |
| `--completed <0\ | 1>` | integer | No | 1=completed 0=not completed |
--page <n> | integer | No | Page number, default 1 | |
--page-size <n> | integer | No | Items per page, default 50 |
OUTPUT
On success: {"total": N, "schedules": [{"id": "...", "task_name": "...", "task_describe": "...", "status": "...", "enabled": 0|1, "time_config": {...}, "deadline":...}]}. Each item includes: id, task_name, task_describe, status, enabled, time_config, deadline.
EXAMPLES
# 查询全部
python scripts/list.py
# 按条件过滤
python scripts/list.py --task-name "早报" --enabled 1 --completed 0get.py - Get Task Details
Get the complete details of a specific scheduled task.
SYNOPSIS
python scripts/get.py --id <schedule_id>DESCRIPTION
Query complete task information by task ID.
OPTIONS
| Option | Type | Required | Description |
|---|---|---|---|
--id <schedule_id> | string | Yes | Task ID |
OUTPUT
On success: Returns complete task info including id, task_name, task_describe, message_content, time_config, status, enabled, deadline.
EXAMPLES
python scripts/get.py --id "<schedule_id>"update.py - Update Task
Update the configuration of a specific scheduled task; only pass fields to be modified.
SYNOPSIS
python scripts/update.py --id <schedule_id> [OPTIONS]DESCRIPTION
Update scheduled task configuration. Only pass fields to be modified; unspecified fields remain unchanged. --type and --time must be provided together.
OPTIONS
| Option | Type | Required | Description | |
|---|---|---|---|---|
--id <schedule_id> | string | Yes | Task ID | |
--task-name <name> | string | No | New task name | |
--message-content <content> | string | No | Message content (same as detail message_content/task_describe) | |
--type <type> | string | No | Schedule type (must be provided with --time) | |
--time <HH:MM> | string | No | Execution time (must be provided with --type) | |
--day <value> | string | No | Date/weekday/day-of-month, depends on --type | |
--deadline <YYYY-MM-DD HH:MM:SS> | string | No | Expiry datetime; format YYYY-MM-DD HH:MM:SS, auto-completed if only date or unclear | |
| `--enabled <0\ | 1>` | integer | No | 1=enable 0=disable |
OUTPUT
On success: {"id": "<schedule_id>"}
EXAMPLES
# 修改任务名称
python scripts/update.py --id "<schedule_id>" --task-name "新名称"
# 修改任务详情
python scripts/update.py --id "<schedule_id>" --message-content "新的任务详情内容"
# 修改调度时间
python scripts/update.py --id "<schedule_id>" --type daily_repeat --time "10:00"
# 修改截止日期
python scripts/update.py --id "<schedule_id>" --deadline "2026-12-31 23:59:59"
# 禁用任务
python scripts/update.py --id "<schedule_id>" --enabled 0
# 重新启用任务
python scripts/update.py --id "<schedule_id>" --enabled 1delete.py - Delete Task
Delete a specific scheduled task.
SYNOPSIS
python scripts/delete.py --id <schedule_id>DESCRIPTION
Permanently delete a scheduled task by task ID.
OPTIONS
| Option | Type | Required | Description |
|---|---|---|---|
--id <schedule_id> | string | Yes | Task ID |
OUTPUT
On success: {"id": "<schedule_id>"}
EXAMPLES
python scripts/delete.py --id "<schedule_id>"Usage Examples
In Agent environment, use shell_exec tool to execute scripts:
# 创建任务
shell_exec(
command='python scripts/create.py --task-name "每日早报" --message-content "请生成今日早报" --type daily_repeat --time "9:00"'
)
# 查询任务列表
shell_exec(
command="python scripts/list.py"
)
# 获取任务详情
shell_exec(
command='python scripts/get.py --id "<schedule_id>"'
)
# 更新任务
shell_exec(
command='python scripts/update.py --id "<schedule_id>" --enabled 0'
)
# 删除任务
shell_exec(
command='python scripts/delete.py --id "<schedule_id>"'
)