Multi-Platform Webhook Triggers

内部Agent只有在其工作流被启动时才能创造价值。构建工作流启动机制（触发器）库是推动Agent落地应用的核心所在。如果没有便捷的触发器，员工将无法有效实现日常工作流的自动化。

实现多平台Webhook触发器，支持外部SaaS工具自动触发Agent工作流。

已实现的触发器类型：

1. Notion Webhook：在页面/数据库发生修改时触发

   • 文档状态变更（草稿→“待审核”）
   • 请求评审（RFC）工作流
   • 按主题自动分配评审人员
   • 带建议的行内评论

2. Slack消息触发器：机器人在频道内响应

   • 公开频道响应
   • 支持私有频道（含严谨日志记录）
   • 频道创建时触发自动加入
   • 新频道默认Prompt（仅被提及才响应）

3. Jira Webhook：问题生命周期事件触发

   • 问题创建、更新、评论
   • 工单分配的自定义路由逻辑

4. Slack Reacji（表情反应）：快速触发工作流

   • 监听任意频道中的特定表情
   • 示例：发送:jira:表情可将对话线程转换为工单
   • 集中式路由规则

5. 定时事件触发器：周期性触发

   • 向频道发布Slack工作流
   • GitHub Actions定时任务（Cron作业）

# 触发流程
平台事件 → Webhook → Agent触发器 → 工作流执行

实现注意事项

身份验证与授权

• 尽可能使用 OAuth2 令牌 + SSL
• 平台专属安全机制（如Slack请求验证）
• 对于不支持授权令牌的平台，不启用该机制

私有频道安全

slack_private_channels:
  auto_join: false  # 不自动加入私有频道
  logging:
    # 关键注意：请勿记录私有频道的活动痕迹
    exclude_private_channels: true
    # 泄露私有消息会立即丧失用户信任

触发器配置

# Notion 触发器
notion_triggers:
  - database: "RFC 数据库"
    event: "页面更新"
    filter: "status.draft → status.ready_for_review"  # 状态从草稿切换至待审核
    workflow: "分配审核人"

  - database: "文档库"
    event: "页面创建"
    workflow: "建议优化方案"

# Slack 表情反应触发器
slack_reacji:
  - emoji: ":jira:"
    scope: "任意频道"
    workflow: "线程转工单"
    routing: "集中式"

# 定时触发器
scheduled_triggers:
  - cron: "0 9 * * MON"
    workflow: "每周站会准备"
    via: "github_actions"  # 通过GitHub Actions执行

为何不选择 Zapier/n8n？

作者选择自定义实现而非现有自动化平台，原因如下：

• 完全控制权：细节层面的体验优化，比通用集成的约束更有助于推动用户落地使用
• 精细化行为处理：可对实体解析、异常场景进行自定义逻辑处理
• 技术认知沉淀：帮助内部团队建立对Agent的认知直觉
• 兼容性兼容：仍可通过通用Webhook兜底机制对接Zapier

通用Webhook兜底机制

# 小众平台的降级方案
generic_webhook:
  endpoint: "/webhooks/generic"
  behavior: "将完整消息纳入context"
  integration: "可与Zapier搭配使用"

优势：

• 低摩擦性：工作流启动简便，可支撑迭代式学习
• 平台原生适配：用户可在现有工具（Slack、Notion、Jira）中开展操作
• 响应式：Agent 可响应各类事件，而非仅处理明确发起的请求
• 高灵活性：支持自定义路由与精细化工作流配置
• 强可扩展性：只需向 LLM 粘贴文档，即可轻松新增触发类型

劣势：

• 维护开销大：每个平台集成都需要持续投入运维工作
• 安全复杂度高：涉及私有频道、认证令牌、请求校验等复杂环节
• 平台锁定风险：与特定工具深度绑定，存在锁定效应
• 可观测性挑战：需避免记录敏感数据，增加了观测难度
• 自研vs成品工具抉择：需在自研与采购成品工具（Zapier、n8n）之间权衡

细节质量至关重要：

“这种细节层面的品质打磨对落地推广的促进作用，是Zapier集成的局限性根本无法企及的。”

自定义实现可支持以下精细化特性：

• Slack 实体解析，提供无缝操作体验
• 私有频道中的审慎日志策略
• 集中式工单路由逻辑

适用场景：

• 具备多集成节点的内部 Agent 平台
• 已广泛使用 Slack、Notion、Jira 的团队
• 文档密集型工作流（如 RFC、评审、审批流程）
• 需实现自动化路由与分类分诊的场景

更适合选用Zapier/n8n的场景：

• 小众的一次性集成需求
• 自定义开发前的快速原型验证
• 需自助服务能力的非技术用户群体