自动化

​

核心概念

​

操作类型

​

触发源

​

创建自动化

​

在 自动化 页面中

1. 在侧边栏中打开 自动化
2. 点击 Create automation，然后选择 Create 打开一个空白编辑器 (如果你还没有任何自动化，请改为在引导页上点击 Create manually) 。该菜单还提供 Template (打开模板库) 和 Generate with Devin (启动一个会话，与你一起构建自动化)
3. 配置触发器、条件和 action
4. 点击 Create automation

​

从模板开始

1. 在侧边栏中前往 自动化
2. 点击 Create automation > Template (如果你还没有任何自动化，请改为点击首页上的 Create from template) ，或直接前往 /automations/templates
3. 浏览模板库——每个模板都是针对常见工作流程预先配置的自动化
4. 点击某个模板，即可用其触发器、action 和建议值预填充编辑器
5. 自定义配置 (例如选择你的 Slack 频道或代码仓库) 并点击 Create automation

​

使用自然语言

​

配置触发器

​

Slack 触发器

• Slack 消息：在有新消息时触发。默认会添加一个频道条件；你可以移除它以匹配跨频道的消息，但此时每个条件组都需要至少一个其他过滤器 (例如消息文本或发送者类型——仅有 Include thread replies 是不够的) 。
• 用户组被提及：当有人提及某个 Slack 用户组 (例如 @oncall) 时触发。选择该用户组或输入其 Slack ID (以 S 开头) ，还可以将其限定在特定频道内。
• Slack 表情回应：当消息被添加特定的 emoji 表情回应时触发 (例如，用于事件的 🚨) 。你可以按表情回应名称和频道进行筛选。

​

GitHub 触发器

• Issue：在 issue 事件 (如打开、关闭、重新打开、编辑、添加标签) 发生时触发。
• Issue comment：当有人在 GitHub issue 中发表评论时触发。通常会搭配 starts_with "/devin" 条件使用，这样用户就可以在任意 issue 中输入 /devin 来触发 Devin。
• Pull request：在 PR 事件 (如打开、同步等) 发生时触发。
• Pull request review：当有人在 PR 上提交评审时触发。
• Pull request review comment：在单条评审评论产生时触发。
• Check run (CI)：当 CI 检查完成时触发。可按 conclusion = failure 筛选，以自动修复失败的构建。
• Push：当代码被推送到某个分支时触发。

​

GitLab 触发器

• Merge request：在 MR 操作时触发 (opened、closed、merged、reopened、approved、updated) 。
• MR comment：当有人在 merge request 上发表评论 (note) 时触发，包括 diff 审查会话线程。
• Issue：在 issue 操作时触发 (opened、closed、reopened、updated) 。
• Issue comment：当有人在 issue 上发表评论时触发。
• Push：向分支推送提交时触发。
• Pipeline：当 pipeline 达到指定状态时触发 —— 可按状态过滤 (例如 failed) ，以自动修复失败的 pipeline。

​

Linear 触发器

• 问题已创建：在所选团队中创建新问题时触发。
• 标签已添加：当某个标签被添加到问题时触发 (例如 bug、devin) 。
• 状态已更改：当问题的状态发生变化时触发 (例如移至“进行中”) 。
• 优先级已更改：当问题的优先级发生变化时触发。
• 已分配：当问题被分配给某人时触发。
• 问题已移动：当问题被移动到其他团队时触发——触发器的团队过滤器匹配的是目标团队。

​

Jira 触发器

• 问题已创建：创建新 issue 时触发。
• 问题已更新：issue 字段发生变化时触发。
• 已添加标签：为 issue 添加标签时触发。
• 状态已更改：issue 状态发生变化时触发。
• 已分配：issue 被分配给某人时触发。
• 评论已创建或已编辑：在 issue 上添加或编辑评论时触发。

​

计划触发器

• Recurring：设置频率 (每小时、每天、每周) 和时间。底层使用 iCalendar RRULE 格式。选择 Custom schedule 可创建自定义重复规则 (每 N 分钟/小时/天/周/月重复一次) ，也可以直接输入原始 RRULE 字符串 (例如 FREQ=WEEKLY;BYDAY=MO;BYHOUR=9;BYMINUTE=0) ，以支持更复杂的执行周期。
• Run once：在未来某个指定日期和时间触发一次，随后会自动禁用。适合一次性的延迟任务，例如“12 小时后唤醒 Devin 去运行一个任务”。选择日期和时间 (默认为从现在起一小时后) ；该时间必须晚于当前时间。

​

Webhook 触发器

1. 创建一个使用 Webhook 触发器的自动化
2. 复制触发器配置中显示的 webhook URL 和 secrets
3. 配置你的外部系统 (PagerDuty、Datadog、Sentry 或任何自定义工具) ，使其向该 URL 发送 HTTP POST 请求
4. 可选添加 负载 过滤器——即一个正则表达式模式；只有当请求正文匹配该模式时，自动化才会触发

• X-Webhook-Secret: <secret> 标头
• Authorization: Bearer <secret> 标头
• ?secret=<secret> 查询参数

​

Webhook secrets

curl -X POST '<webhook-url>' \
  -H 'Content-Type: application/json' \
  -H 'X-Webhook-Secret: <secret>' \
  -d '{"test": true}'

​

Preflight 检查

​

LLM 过滤器

​

配置并测试 Preflight 脚本

1. 创建一个自动化或编辑现有自动化，并配置其触发器和条件。
2. 点击触发器部分下方的 Add a step before the agent runs，然后在 Before the agent runs 卡片中选择 Run a script。
3. 点击 Edit script，在运行时选择器中选择 Python、Node (JavaScript) 或 Bash，然后编辑初始脚本。
4. 如有需要，可在脚本编辑器中通过 Select secrets 关联组织 secrets。只有选中的 secrets 才会作为环境变量注入。保存或测试关联了 secrets 的脚本时，需要具备管理组织 secrets 的权限。
5. 在卡片中设置 Timeout (seconds)：默认为 60 秒，可设置范围为 1–300 秒。脚本默认使用 Minimal environment；如果可以使用机器快照，你还可以通过 Environment 选择器选择包含所需依赖的组织快照。
6. 在脚本编辑器中，在 Test against 下选择一个事件，然后点击 Run。你可以使用已配置触发器的示例事件来测试未保存的脚本，也可以使用现有自动化的近期事件进行测试。检查结果和日志；如果脚本产出了条目，还可以查看预览，了解其中有多少会运行、多少为重复项、多少会被推迟。
7. 点击 Save script 应用编辑器中的更改，然后点击 Create automation 或保存该自动化，使配置生效。

​

脚本输入与输出

import json
import os

with open(os.environ["EVENT_FILE"]) as f:
    event = json.load(f)

text = event.get("payload", {}).get("text", "")
should_run = "urgent" in text.lower()

with open(os.environ["OUTPUT_FILE"], "w") as f:
    json.dump({"run": should_run, "reason": "Urgency filter"}, f)

​

脚本条目、状态与限制

• 防止重复： 条目的 id 标识的是此自动化中的一个工作单元，而不仅仅是一个实体。{"id": "INC-1"} 只会被处理一次；如需处理该事件的再次发生，请添加 version，例如上游的更新时间戳。如果没有 id，Preflight 会根据条目内容的 hash 来识别条目，因此内容一旦变更，就可能再次触发运行。
• 每次运行的条目上限： 默认情况下，每次运行最多分派 10 个新条目；系统允许的最大上限为 50。超出上限的条目不会被处理，也不会被自动计划。你的脚本必须在下一次运行时重新输出这些条目。不要仅因为被推迟的工作出现在了输出中，就将游标推进到这些工作之后。
• 先前结果： 使用 LAST_RUN_FILE 区分运行中、已成功、已失败或已跳过的工作。运行失败的条目会被释放，之后的脚本运行可以再次输出它。
• 持久化状态： 同一自动化的实时脚本运行会依次执行，每次只运行一个。脚本失败时不会推进已保存的状态，也不会将条目标记为已处理。Clear state 会同时清除已保存的 JSON 状态和已处理条目的历史记录；重置后，之前已处理的条目可以再次运行。
• 大小限制： 脚本源代码和输出各不得超过 256 KiB，已保存的状态不得超过 64 KiB，捕获的日志不得超过 1 MiB。
• 失败： 非零退出码、超时、输出或状态无效，或者基础架构故障，都会使该事件在执行 操作 之前终止。系统不会针对该事件自动重试脚本；之后的触发可以再次运行该脚本。
• 网络访问： 脚本所在的虚拟机遵循该自动化的网络限制及适用的安全 Profile。例如，要轮询外部告警服务，必须先允许访问其主机。附加 secrets 并不会授予网络访问权限。

​

配置 actions

​

启动会话

• 提示：Devin 会遵循的指示。像编写普通的 Devin 提示一样编写即可。
• Playbook (可选) ：在你的提示中使用 @playbook-name，即可包含一个 playbook 来提供额外指示。
• 标签 (可选) ：为此自动化创建的会话添加标签，便于筛选。

​

向会话发送消息

​

分流 Devin (监控)

​

电子邮件通知

• 始终 — 每次触发时
• 失败时 — 仅当会话失败或出错时
• 成功时 — 仅当会话成功完成时

​

限制与防护措施

​

ACU 限制

​

触发次数限制

​

排队

• Concurrent runs：此自动化可同时进行的最大运行数。超出的事件会在队列中等待。一旦某次运行的会话结束并开始等待新的指示，该运行便不再计入此限制。
• Queue depth：队列中最多可等待的事件数。队列已满时到达的事件将被丢弃。

​

网络策略

​

MCP 集成

​

Slack 工具访问权限

​

活动与监控

• 最近的调用及其时间戳
• 每次调用是成功还是被跳过
• 已创建的 Devin 会话链接
• 调用失败时的错误消息

​

启用和禁用

​

模板