Appearance
自动化
自动化解决的核心问题是"什么时候自动开始做"。通过配置触发条件和执行动作，您可以让任务在满足条件时自动运行，无需手动干预。
核心概念
触发方式
自动化支持两种触发方式：
| 触发类型 | 说明 | 典型场景 |
|---|---|---|
| 定时触发 | 按固定时间周期执行 | 每日数据整理、周报生成、定期巡检、数据采集 |
| 通知驱动 | 收到外部消息时执行 | 消息处理、事件响应、审批通知 |
执行动作
触发后可以执行三种动作：
- 执行工作流：运行预先设计好的工作流
- 单 Agent 处理：由一个 Agent 独立完成任务
- 多 Agent 协作：由多个 Agent 协同处理复杂任务
TIP
如果任务步骤已经固化，优先选择"执行工作流"。如果任务需要灵活判断，选择 Agent 处理更合适。
创建自动化
进入自动化管理页面，点击「新建自动化」，按以下步骤配置。
1. 基本信息
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | 文本 | 是 | 自动化规则名称，用于在列表中识别 |
| description | 文本 | 否 | 规则用途描述 |
| enabled | 开关 | 否 | 是否启用，默认 true |
2. 触发配置
选择 trigger_type 触发类型：scheduled（定时触发）或 notification（通知驱动）。
定时触发参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| schedule_mode | 下拉选择 | 是 | 执行模式：repeat（重复执行）、once（单次执行） |
| schedule_repeat_frequency | 下拉选择 | 是 | 重复频率：daily（每天）、weekly（每周）、monthly（每月）、yearly（每年）。repeat 模式下必填 |
| schedule_repeat_times | 时间列表 | 是 | 每次执行的时间点列表，如 09:00、18:00。repeat 模式下必填 |
| schedule_repeat_weekdays | 多选 | 否 | 星期选择：MON 至 SUN。频率为 weekly 时可用 |
| schedule_repeat_month_days | 多选 | 否 | 日期选择：1-31。频率为 monthly 时可用 |
| schedule_once_at | 日期时间 | 是 | 单次执行的具体时间。once 模式下必填 |
通知驱动参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| notification_sources | 多选 | 是 | 消息来源：webhook、wecom（企业微信）、wechat（微信）、system（系统通知） |
| keywords | 文本 | 否 | 包含关键词过滤，多个关键词用逗号分隔，匹配任一关键词即触发 |
| exclude_keywords | 文本 | 否 | 排除关键词，包含这些关键词的消息不会触发 |
| senders | 文本 | 否 | 发送人过滤，只接受指定发送人的消息 |
3. 动作配置
选择 action_type 动作类型，不同类型对应不同的参数。
执行工作流（action_type = workflow）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| workflow_id | 下拉选择 | 是 | 要执行的工作流，从已有工作流列表中选择 |
| workflow_input_values | 键值对 | 否 | 工作流输入参数，按工作流定义的输入变量填写 |
单 Agent 处理（action_type = agent_session）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| agent_id | 下拉选择 | 是 | 执行任务的 Agent |
| message | 文本 | 是 | 发送给 Agent 的初始指令，告诉 Agent 要做什么 |
多 Agent 协作（action_type = multi_agent_session）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| owner_agent_id | 下拉选择 | 是 | 主控 Agent，负责协调任务分配 |
| participants | 多选 | 是 | 参与协作的 Agent 列表 |
| group_mode | 下拉选择 | 是 | 协作模式：delegate（委派模式，主控分配任务）、graph（图模式，按预定义流程协作）、bus（总线模式，所有 Agent 平等协作） |
4. 高级参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cooldown_seconds | 数字 | 否 | 冷却时间（秒），两次触发之间的最小间隔，防止频繁触发 |
| dedup_window_seconds | 数字 | 否 | 去重窗口（秒），默认 300。在窗口期内相同内容的消息只触发一次 |
运行记录
每次自动化执行都会生成运行记录，包含以下信息：
| 字段 | 说明 |
|---|---|
| 触发状态 | 是否成功触发 |
| 触发来源 | 定时还是通知驱动 |
| 执行结果 | 成功、失败或部分完成 |
| 错误信息 | 失败时的具体原因 |
WARNING
如果自动化规则连续失败，请先检查运行记录中的错误信息，确认是触发配置问题还是动作执行问题。
适用场景
| 场景 | 触发方式 | 动作类型 |
|---|---|---|
| 每日数据汇总 | 定时触发 | 执行工作流 |
| 收到客户消息自动回复 | 通知驱动 | 单 Agent 处理 |
| 定期巡检并生成报告 | 定时触发 | 执行工作流 |
| 多渠道消息统一处理 | 通知驱动 | 多 Agent 协作 |