跳转到主要内容
委派任务给 Agent

定时任务

定时任务(Scheduled Task)绑定一个智能体并配置触发方式,支持定时或手动触发运行,适合每日汇总、定期巡检等无人值守任务。

定时任务(Scheduled Task,API 中的资源名为 Deployment)绑定一个智能体并配置触发方式:定时触发按 cron 表达式自动执行,手动触发在点击「运行」时执行。每次触发创建一个会话,向智能体发送创建时固定的初始消息,执行过程与结果记录为一条运行记录(Run)。 控制台侧边栏的「部署」页即定时任务的管理入口。 适合无人值守的周期性任务:每日数据汇总、定期巡检、按小时同步。需要多轮交互的任务请使用会话。

在控制台创建

进入控制台「部署」页,点击「创建部署」,配置绑定的智能体、运行环境、初始消息与触发方式等。触发方式支持手动触发或定时调度;定时调度使用标准 Cron 表达式(分 时 日 月 周)并指定执行时区,例如 (GMT+08:00) Asia/Shanghai。

触发与运行记录

手动任务在列表或详情页点击「运行」触发;定时任务按表达式自动触发。每次触发产生一条运行记录,进入任务详情页的运行历史查看:
  • 运行 ID:单次执行的标识,drun_ 前缀。
  • 触发来源:manual 或 scheduled。
  • 状态:running、succeeded、failed。
  • 会话:本次运行创建的会话 ID,可按会话方式查询事件历史与输出。
  • 开始 / 结束时间。

暂停与归档

  • 暂停:停止定时触发,保留配置;恢复后继续按原表达式执行。
  • 归档:归档后不可触发,操作幂等。

通过 API 管理

创建一个工作日 9 点(Asia/Shanghai)定时执行的任务。完整参数与响应字段见 创建 Deployment API:
curl -X POST "https://maas.qianwenaiapi.com/api/v1/agentstudio/deployments" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "每日订单汇总",
    "agent": {
      "id": "agent_xxx",
      "version": 12
    },
    "environment_id": "env_xxx",
    "schedule": {
      "type": "cron",
      "expression": "0 9 * * 1-5",
      "timezone": "Asia/Shanghai"
    },
    "initial_events": [
      {
        "type": "message",
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "汇总昨日订单数据"
          }
        ]
      }
    ]
  }'
agent.version 锁定智能体版本,不传则使用最新版本。更新任务时 schedule 传 null 可清除定时触发,改回手动。 常用操作:

下一步