用途:Gamma 公开 API(v1.0)以生成为主,撰写时并不提供传统 webhook 推送,因此该技能用轮询模式(GET /v1.0/generations/{id})检测生成完成,并在应用层构造事件,供事件驱动架构使用。
主要能力:定义应用级事件模型,包括 generation.started(POST /generations 返回 generationId)、generation.completed(轮询返回 status: "completed")、generation.failed(status: "failed")、generation.timeout(轮询超过最大时长)。提供 EventEmitter 事件发射与监听模式、Bull 队列后台 worker 处理、以及 DIY 的 webhook 风格 HTTP 回调(生成完成后 POST 结果到配置 URL)。输出要求返回不透明事件 ID、校验结果、幂等结果、目标状态与脱敏错误类别,事件负载与凭据不得写入日志。
使用方式:前置条件为完成 gamma-sdk-patterns 设置,并具备事件总线或消息队列(Bull、RabbitMQ 或 EventEmitter)。轮询间隔建议 5 秒,示例超时为 180 秒;复杂内容可延长超时。需处理轮询超时、漏检完成、重复处理(用 Set 或数据库记录已处理的 generationId 做幂等)以及导出 URL 过期(完成时立即下载)等问题。
适用场景:需要实时更新、后台生成任务、通知用户或更新数据库的集成。
限制:Gamma 本身不推送事件,所有事件均为应用层合成;示例中的超时、队列并发数等参数需按实际调整;具体收费、平台支持与官方 webhook 支持情况暂未提供。