用途:为 Pipa 创建、查看和删除事件触发自动化。当用户希望外部事件(如 GitHub PR 打开、Linear 新问题、Slack 消息)触发工作流时使用。
主要能力:通过网关触发订阅 API 管理触发器。V1 仅支持创建、列表、读取、删除;不支持更新、暂停、恢复、测试,修改需删除后重建。默认投递到请求者私信,仅当用户明确选择频道时才投递到频道。
使用方式:创建前需收集来源应用、外部账户、被监视资源、事件类型、投递目标和执行提示,并向用户确认最终方案后再调用创建接口。通过 GET /v1/trigger-types?toolkit=<toolkit> 查询 Composio 触发目录,使用返回的 slug 作为 provider_trigger_slug,不得自行构造。列表用 GET /v1/trigger-subscriptions,读取用 GET /v1/trigger-subscriptions/:id,删除用 DELETE /v1/trigger-subscriptions/:id。调用时在 Authorization 头携带 Bearer ${PIPA_EXECUTION_SECRET}。
适用场景:GitHub PR 打开时运行工作流、监视 Linear 新缺陷并汇总、Slack 出现阻塞时发送摘要、查看或删除已有触发器。
限制:不直接调用 Inngest,不创建原生 webhook 作为替代。列表、读取、删除仅限当前请求者账户范围。执行提示应使用规范化事件上下文,不直接使用原始提供方载荷。事件可能过期,执行时须将缺失源对象视为过期事件,不得猜测 ID 或盲目重试。创建前须检查宽泛资源范围、写入权限、递归循环、高频噪声事件等风险。环境变量由网关运行时注入,不在技能文件中存储密钥。