用途:把 Together AI 异步作业(batch、fine-tuning、upload、dedicated deployment)的状态变化,转换成内部幂等事件,而不是依赖供应商签名的 webhook。
主要能力:映射作业状态到小型版本化内部事件模式;持久化 job ID、上次观察状态、下次轮询时间、尝试次数与截止时间;使用带抖动的有界指数退避轮询,在终态或截止时间停止;仅在有意义的状态转换时发出事件,并按 job/state 键去重;完成后先获取输出与错误产物,再声明记录级成功;需要时以自有密钥签名投递内部回调,含重放保护与死信路径。
使用方式:先确定作业类型、ID、项目、终态与检索方法,准备持久化游标/状态存储与幂等键策略,设定轮询间隔、截止时间、重试预算与事件保留策略。用 Read/Glob/Grep 检查作业持久化、轮询器、队列与回调处理;用 WebFetch 确认当前作业状态与检索方法;Write/Edit 仅在事件契约与存储边界批准后使用。轮询以项目级 TOGETHER_API_KEY Bearer 凭据进行;自有回调使用独立密钥、带时间戳签名、重放窗口与轮换方案。
限制:这些作业 API 没有通用的签名 webhook 表面,不要期待 Together 签名头,也不要把自有签名说成 Together 生成。不要向回调消费方暴露 Together key,不要编造供应商签名,未完成对账与保留审批前不要删除远端或本地作业产物。job ID 缺失时停止,不自动创建替代作业;检索暂时不可用时在总截止时间内带抖动重试;完成但有错误文件时发 completed-with-errors 并对账记录;回调持续失败时保留事件到死信队列以便重放。
输出:返回作业引用、状态映射、轮询计划、转换台账、对账状态、回调投递证据以及截止时间/死信处置。示例证据:job=batch-redacted; transition=IN_PROGRESS->COMPLETED; records=reconciled; callback=owned-signed。