定时任务

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

在控制台创建

进入控制台「部署」页，点击「创建」，在弹窗中配置：

名称：任务名称。
描述（可选）：用途说明。
智能体：选择要运行的智能体。
环境（可选）：选择运行环境。
环境变量（可选）：注入会话运行时。
密钥（可选）：绑定密钥库，供 MCP 服务和技能引用。
初始消息：每次触发时作为初始用户消息发送给智能体，1 到 50 条。
文件（可选）：挂载到任务运行的会话中。
元数据（可选）：自定义 key-value。
触发器：手动触发或定时调度。

配置定时调度时，控制台实时预览未来 5 次运行时间：

配置项	说明
频率	每小时、每天、工作日、每周、每月，或自定义 Cron
Cron 表达式	标准五位（分时日月周）；`` 任意，`/5` 每 5 个单位，`1-5` 范围
时区	表达式对应的执行时区，例如 `(GMT+08:00) Asia/Shanghai`

触发与运行记录

手动任务在列表或详情页点击「运行」触发；定时任务按表达式自动触发。每次触发产生一条运行记录，进入任务详情页的运行历史查看：

运行 ID：单次执行的标识，drun_ 前缀。
触发来源：manual 或 scheduled。
状态：running、succeeded、failed。
会话：本次运行创建的会话 ID，可按会话方式查询事件历史与输出。
开始 / 结束时间。

暂停与归档

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

通过 API 与 CLI 管理

创建一个工作日 9 点（Asia/Shanghai）定时执行的任务。完整参数与响应字段见创建 Deployment API：

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.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 可清除定时触发，改回手动。常用命令：

操作	API	CLI
触发一次运行	触发 Deployment Run	`bl managed-agent deployment run`
暂停 / 恢复	暂停、恢复	`bl managed-agent deployment pause` / `unpause`
查看运行记录	列出 Deployment Runs	`bl managed-agent deployment runs list`

在控制台创建

触发与运行记录

暂停与归档

通过 API 与 CLI 管理

下一步

Deployment API

Webhook 事件订阅

​在控制台创建

​触发与运行记录

​暂停与归档

​通过 API 与 CLI 管理

​下一步

Deployment API

Webhook 事件订阅

在控制台创建

触发与运行记录

暂停与归档

通过 API 与 CLI 管理

下一步