触发器

触发器定义了工作流如何在 ADK Studio 中启动。每个工作流都以一个 Trigger 节点开始，该节点决定了入口点——无论是来自用户输入、一个 HTTP webhook、一个 cron 计划，还是一个外部事件。

触发器类型

手动触发器

默认的触发器类型。当工作流具有手动触发器时，聊天输入框会显示一个可配置的标签和占位符。

配置：

输入标签显示在聊天输入字段上方，默认提示用作占位符文本。

---

Webhook 触发器

暴露一个 HTTP 端点，在被调用时启动工作流。有助于与外部服务、CI/CD 管道或其他应用程序集成。

配置：

端点

每个 webhook 触发器会创建两个端点：

GET webhooks 也有效：

GET /api/projects/:id/webhook/my-path?message=Hello

认证

Bearer token：

curl -X POST "http://localhost:3000/api/projects/{id}/webhook/my-path" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Process this"}'

API 密钥：

curl -X POST "http://localhost:3000/api/projects/{id}/webhook/my-path" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Process this"}'

Webhook 事件通知

通过 SSE 订阅实时 webhook 执行事件：

GET /api/projects/:id/webhook-events

此流在接收和处理 webhook 时发出事件。

---

计划触发器

使用 cron 表达式按重复计划运行工作流。

配置：

Cron 语法

标准的 5 字段 cron 表达式：

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sun=0)
│ │ │ │ │
* * * * *

示例：

调度服务跟踪 last_executed 时间戳以防止重复运行。

---

事件触发器

根据外部系统事件启动工作流。事件通过 source 和 eventType 进行匹配，并可选择对事件数据进行 JSONPath 过滤。

配置：

发送事件

curl -X POST "http://localhost:3000/api/projects/{id}/events" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "payment-service",
    "eventType": "payment.completed",
    "data": {
      "orderId": "12345",
      "amount": 99.00,
      "status": "active"
    }
  }'

JSONPath 过滤器

过滤事件，以便工作流仅在满足特定条件时触发：

不符合过滤条件的事件将被静默忽略。

---

触发器感知运行按钮

Studio UI 会根据当前活动的触发器类型进行调整：

• 手动 — 带有配置的标签和占位符的标准聊天输入
• Webhook — 运行按钮发送模拟的 Webhook 有效负载
• 计划 — 运行按钮发送配置的默认提示
• 事件 — 运行按钮发送模拟的事件有效负载

当工作流自上次构建以来发生更改时，发送按钮会转换为构建按钮，以提示重新编译。

---

API 参考

上一页: ← 动作节点 | 下一页: 开发指南 →