---
title: "触发器"
description: "触发器会按计划、通过 webhook、根据应用事件或通过监控器启动会话。"
---
触发器会在没有人员参与的情况下启动一个[会话](/docs/zh/work/sessions)。使用触发器自动执行定期或事件驱动的工作。
如果要稍后跟进某个会话中的任务，例如“明天检查对方是否回复”，请改用[提醒](/docs/zh/connect/reminders)。提醒是限定于该会话的触发器。它保存在数据库中，而不是 `beeuni.yaml`。
## 触发器类型
Beeuni 支持四种触发器类型。
- **cron** — 按你设置的计划运行。
- **webhook** — 外部服务向项目的 webhook URL 发送签名请求时运行。
- **event** — 连接的应用中发生事件时运行，例如新建拉取请求或收到新邮件。参阅[应用事件触发器](#app-event-triggers)。
- **monitor** — 全天候运行仓库中的命令。命令输出到 stdout 的每一行都会触发运行。此功能处于实验阶段：参阅[监控器](#monitors)。
你可以在项目清单 `beeuni.yaml` 中定义触发器。每个触发器都包含一个提示词，它会显示为触发后会话的第一条消息。运行时状态（例如上次触发时间和状态）存储在清单之外的数据库中。触发器运行不会创建提交。
通过控制面板创建、更新或删除触发器，会直接写入默认分支，不会经过[变更请求](/docs/zh/work/change-requests)（CR）。在会话中编辑 `beeuni.yaml` 并运行 `beeuni ship`，则会照常经过分支和 CR 流程。
## 设置 cron 触发器
1. **添加触发器**
```sh
beeuni triggers add daily-digest --type cron \
--cron "0 0 9 * * 1-5" --timezone America/Los_Angeles \
--prompt "Summarize yesterday's activity and save it as a daily note."
```
`cron` 是一个 6 字段表达式：秒、分、时、日、月、星期。触发器最多每分钟运行一次：`0 */30 * * * *` 表示每 30 分钟运行一次，而 `*/30 * * * * *`（每 30 秒运行一次）会被拒绝。此命令只会编辑本地 `beeuni.yaml`。
2. **发布**
```sh
beeuni ship
```
`beeuni ship` 会提交 `beeuni.yaml` 并推送它。变更合并到项目的默认分支后，计划就会生效。
3. **确认它是否运行**
```sh
beeuni triggers ls
```
列表会显示每个触发器的 slug、状态和上次触发时间。若要立即触发，而不是等待计划时间，请运行 `beeuni triggers fire daily-digest`。此命令会等待运行结果；如果运行失败，则以非零状态码退出并显示失败文本；`--wait ` 用于限制等待时间（默认为 `90s`）。
## 设置 webhook 触发器
webhook 触发器需要一个密钥。Beeuni 会用它验证每个传入请求的签名。
1. **添加密钥**
```sh
beeuni secrets set WEBHOOK_SECRET=
```
有关密钥的更多信息，请参阅[密钥](/docs/zh/project/secrets)。
2. **添加触发器**
```sh
beeuni triggers add new-lead --type webhook \
--secret-env WEBHOOK_SECRET \
--prompt "A new lead arrived: {{ body.name }} ({{ body.email }}). Add it to the CRM."
```
`--secret-env` 指定用于签署发往此触发器请求的密钥。
3. **发布**
```sh
beeuni ship
```
4.
### 向它发送请求
Beeuni 会根据项目 ID 和触发器的 slug 构建 webhook URL：
```
POST /v1/webhooks/projects//
```
从外部服务向此 URL 发送带签名的 `POST` 请求。Beeuni 会根据 `WEBHOOK_SECRET` 验证签名，然后启动一个会话，提示词中可使用请求正文。确切的标头和格式请参阅下文的 [Webhook 签名](#webhook-signature)。
默认情况下，每次触发都会在新分支上启动一个全新会话。触发器也可以复用或固定会话；webhook 触发器还可以筛选要启动会话的负载——请参阅下文的[会话策略](#session-strategy)和[负载模板](#payload-templating)。
## 应用事件触发器
应用事件触发器会在应用事件发生时运行代理：例如拉取请求开启、收到邮件或问题状态发生变化。你无需配置 webhook、密钥或签名。Beeuni 会为你订阅事件，无需手动签名。
事件来自**事件源**，即传递应用事件的适配器。`GITHUB_PULL_REQUEST_CREATED` 等事件 ID 标识该事件源支持的事件。使用事件目录选择连接器对应的事件。
### 在 Web 应用中设置
1. 打开项目，然后选择 **Triggers** 和 **New trigger**。
2. 选择 **App event**。
3. 选择一个应用，然后在其中选择一个连接器及其共享账号，或连接另一个账号。除非你另选账号，否则会使用标记为 **Default** 的账号。
4. 选择一个事件。其设置表单（例如仓库设置）会显示在下方。
5. 编写提示词并保存。
当徽章显示 **Live** 时，触发器即已生效。其他徽章包括 **Activating**、**Needs connection** 和 **Error**。它们分别对应下文的 `pending`、`needs_connection` 和 `error` 状态。
### 查看所有应用事件触发器
在 Web 应用中，打开 **Triggers** 并选择 **App events**。筛选栏显示 **All**、**Schedules**、**App events** 和 **Webhooks**，每项后面都带有数量。所选项会保存在地址中的 `?type=event`，因此你可以分享链接。列表按应用分组。列表下方的 **Apps with events** 会列出所有可启动代理的应用，并优先显示项目已经使用的应用。选择一个应用即可打开该应用的新建触发器表单。
连接器窗口中有一个 **Triggers** 选项卡，其中显示该连接器上的应用事件。只有包含事件的应用才会显示此选项卡。
使用 CLI：
```bash
beeuni triggers ls --type event # every app event trigger, grouped by app
beeuni triggers ls --connector github-work # the app events on one connector
beeuni triggers ls --type event --json # the same list as JSON
```
`--type` 也接受 `cron`、`webhook` 和 `monitor`。`--connector` 和 `--type` 可以组合使用。
### 使用 CLI 设置
代理或人员按顺序执行这些步骤。每一步都会输出下一步所需的信息。
```sh
beeuni triggers events --apps
beeuni triggers events --app github
beeuni connectors add github --provider composio --app github --apply
beeuni connectors connect github --owner project
beeuni triggers events --connector github
beeuni triggers events --connector github --event GITHUB_PULL_REQUEST_CREATED
beeuni triggers add pr-review --type event \
--connector github --event GITHUB_PULL_REQUEST_CREATED \
--config repo=hekmat/api \
--prompt "Review {{ event.data.html_url }}" --apply
beeuni triggers info pr-review
```
1. `triggers events --apps` 会列出可触发事件的应用。应用按事件源分组（`source: composio`）。每个应用都会列出其连接器（配置）及其共享账号。`STATE` 列显示 `connected` 或 `needs account`；没有连接器的应用会列在 `No connector yet` 下。
2. 如果应用没有连接器，`connectors add` 会添加连接器。如果已设置 `CONNECTOR`，则跳过此步骤。
3. `connectors connect --owner project` 会输出一个链接。由人员打开链接来连接共享账号。成员的私人账号不算共享账号。再次运行此命令可添加第二个共享账号，然后使用 `connectors rename