Scheduled tasks enable an Agent Team to automatically run a specified task at a preset time or frequency. This topic describes how to enter the collaboration client, and how to create and manage scheduled tasks.
Usage notes
The scheduling capability of scheduled tasks is based on Alibaba Cloud SchedulerX. Work that must run periodically or at a fixed time, such as daily reports and regular inspections, can be delegated to an Agent Team for automatic completion without manual triggering.
Scenarios
-
Periodic reports: An Agent Team aggregates relevant information and generates a report on a daily or weekly basis, such as a daily summary of project progress.
-
Regular inspections: An Agent Team periodically checks the status of services or tasks and proactively reports anomalies to the team.
-
Scheduled reminders: An Agent Team sends a reminder to the team at a specified time, such as a meeting reminder or a deadline notification.
Enter the collaboration client
Scheduled tasks are created and managed in the collaboration client (AgentCore). To enter the collaboration client, perform the following steps:
-
In the left-side navigation pane, click Team Collaboration.
-
On the Access Management tab, locate the Collaboration Client (WEB) card in the Endpoints section.
-
Click Open to enter the login page of the collaboration client.
-
On the login page, expand Matrix instance settings and configure the Homeserver URL. The Homeserver URL is the public URL of the Collaboration Client (API) endpoint.
-
Enter the password of the user to log on to the team workspace.
-
In the left-side navigation pane, click Scheduled Tasks to enter the Scheduled Tasks page.
Create a scheduled task
-
On the Scheduled Task Configuration tab, click New Scheduled Task.
-
Enter a task title.
-
Select a target team.
-
Select an assignee, namely the Agent that runs the task.
-
Select a priority. The priority levels are Urgent, High, Medium, and Low, and the default is Medium.
-
Select an execution cycle and a time, such as 19:00 every day or minute 30 of every hour.
-
Enter the task content.
-
Click Create Scheduled Task.
Manage scheduled tasks
View the overview of scheduled tasks
At the top of the Scheduled Task Configuration tab, view the overview of scheduled tasks.
|
Field |
Description |
|
Total Scheduled Tasks |
The total number of scheduled tasks created. |
|
Enabled |
The number of enabled scheduled tasks. |
|
Disabled |
The number of disabled scheduled tasks. |
View task information
The Scheduled Task Configuration tab displays each scheduled task as a card. At the top of the page, search for tasks, filter by team and status, or select the checkbox to show only tasks created by the current user.
|
Field |
Description |
|
Task Title |
The title of the scheduled task. |
|
Task Content |
The specific content that the scheduled task runs. |
|
Priority |
The priority of the task: Urgent, High, Medium, or Low. |
|
Execution Cycle |
The execution cycle and time of the task, such as 19:00 every day. |
|
Assigned To |
The Agent that runs the task. |
|
Target Team |
The team to which the task belongs. |
Enable or disable a scheduled task
The switch on the card enables or disables a scheduled task.
Edit a scheduled task
Click Edit to edit the configuration of a scheduled task.
Run a scheduled task manually
Click Manual Run to run a scheduled task once immediately.
View the execution records of a scheduled task
Click Execution Records to view the execution records of a scheduled task.
Delete a scheduled task
Click Delete to delete a scheduled task.
View execution records
The Scheduled Tasks page contains two tabs: Scheduled Task Configuration and Execution Records. On the Execution Records tab, view the execution details of scheduled tasks.
At the top of the page, filter execution records by team, task, and status, and switch between Active Tasks and Archived Tasks.
|
Field |
Description |
|
Execution Time |
The execution time of the task. |
|
Task |
The scheduled task that corresponds to the execution record. |
|
Task Duration |
The duration of the task execution. |
|
Status |
The execution status of the task. |
View tasks
Tasks and scheduled tasks are parallel features. The Tasks page displays all tasks in the team workspace.
At the top of the page, view the task overview and the task status distribution.
|
Field |
Description |
|
Total Tasks |
The total number of tasks. |
|
Pending Confirmation |
The number of tasks pending confirmation. |
The Tasks page is a kanban board with five columns by status: Pending Confirmation, Created, Running, Completed, and Canceled. At the top of the page, create tasks, search for tasks, filter by team, or select the checkbox to show only tasks created by the current user; on the right, switch between Active Tasks and Archived Tasks.
|
Field |
Description |
|
Task Title |
The title of the task. |
|
Task Content |
The specific content of the task. |
|
Priority |
The priority of the task. |
|
Assigned To |
The Agent that runs the task. |
|
Team |
The team to which the task belongs. |