// Creates and manages scheduled tasks, cron jobs, recurring reminders, and timers via the Task HTTP API. Use when the user asks to schedule something, set a recurring reminder, run a periodic check, or manage existing scheduled tasks.
Research analyst in a multi-bot group chat — synthesizes background information, fact-checks claims, identifies knowledge gaps, and suggests next steps. Use when the conversation needs context, a factual claim needs verification, someone asks for background research, or a discussion lacks supporting evidence.
Code specialist in a multi-bot group chat — writes, reviews, debugs, and explains code. Use when someone asks to write a function, fix a bug, review a pull request, explain a code snippet, or solve a programming problem.
Escalate unresolvable or sensitive requests to a human agent by recording an escalation entry. Use when the user asks to speak to a human, the bot cannot answer confidently, the request involves financial, legal, or security concerns, a safety issue is detected, or the user is frustrated after repeated failures.
Handle everyday conversation, answer questions, manage files, take notes, run scripts, and maintain persistent memory across sessions. Use when the user asks a general question, requests file operations, wants to brainstorm ideas, needs to-do tracking, asks you to remember something, or requests skill search and installation.
Format responses for instant messaging platforms such as Lark, DingTalk, WeCom, Slack, and Telegram. Controls response length, Markdown formatting, tone, group chat behavior, and the [PASS] protocol. Use when replying through an IM channel, composing a group chat message, or adapting output for a chat-based interface.
Search, read, create, and update knowledge base entries via MCP-connected KB tools. Use when the user asks to look up documentation, find existing articles, check if docs exist on a topic, create a new KB entry, update an existing document, or when domain questions should be answered from the knowledge base first.
| name | task-manager |
| description | Creates and manages scheduled tasks, cron jobs, recurring reminders, and timers via the Task HTTP API. Use when the user asks to schedule something, set a recurring reminder, run a periodic check, or manage existing scheduled tasks. |
You can create and manage scheduled tasks for the user. When the user asks you to do something periodically (e.g. "every morning at 9am, summarize my emails"), create a scheduled task via the Task HTTP API.
Watch for phrases like:
Use the Task HTTP API (running on the gateway's port):
curl -X POST http://localhost:$PORT/api/tasks \
-H "Content-Type: application/json" \
-d '{
"name": "daily-summary",
"schedule": "0 9 * * *",
"prompt": "Summarize the key updates from today",
"enabled": true,
"target": {
"channel": "feishu",
"chatId": "oc_xxxx"
}
}'
Before creating a task, verify:
schedule field is a valid 5-field cron expressionprompt is non-empty and specific enough to produce useful output when run unattendedtarget is provided, channel is required; chatId is optional (if omitted, the result is sent to all known chats on that channel)If the API returns an error (non-2xx status), report the failure to the user with the error message rather than assuming success.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | yes | Human-readable task name |
schedule | string | yes | Cron expression (see below) |
prompt | string | yes | The prompt sent to the agent when the task fires |
enabled | boolean | no | Default: true |
target | object | no | Where to deliver the result |
target.channel | string | yes* | Channel name: feishu, dingtalk, wecom, slack, telegram, discord, weixin |
target.chatId | string | no | Chat/conversation ID. If omitted, sends to all known chats on the channel |
| Expression | Meaning |
|---|---|
0 9 * * * | Every day at 9:00 AM |
0 9 * * 1-5 | Weekdays at 9:00 AM |
*/30 * * * * | Every 30 minutes |
0 */2 * * * | Every 2 hours |
0 9 * * 1 | Every Monday at 9:00 AM |
0 0 1 * * | First day of each month at midnight |
GET /api/tasks — list all tasksPATCH /api/tasks/:id — update a task (partial update)DELETE /api/tasks/:id — remove a taskPOST /api/tasks/:id/run — execute a task immediately