SuperAPI AI 工具集

trigger-realtime

智能体与模型

查看项目

更新于 10-15 19:58

技能介绍

用途:从前后端实时订阅 Trigger.dev 任务运行,并流式传输数据。适用于为长任务构建进度指示器、实时仪表盘、向 UI 流式输出 AI/LLM 响应、在 React 组件中触发并监控任务,以及在任务中等待用户审批。

主要能力:后端可用 auth.createPublicToken 创建只读令牌(可限定 runs、tasks 范围与过期时间),用 auth.createTriggerPublicToken 创建前端触发令牌;通过 runs.subscribeToRun、subscribeToRunsWithTag、subscribeToBatch 订阅单个、按标签或批次的运行。React 侧安装 npm add @trigger.dev/react-hooks,提供 useRealtimeTaskTrigger、useRealtimeRun、useRealtimeRunsWithTag、useRealtimeStream、useWaitToken 等钩子。Realtime Streams 用 streams.define 定义流,在任务中 aiStream.pipe 管道输出,前端用 useRealtimeStream 读取。Wait Tokens 支持人在回路:任务内 wait.forToken 等待,前端 useWaitToken 完成审批。Run 对象含 id、status(QUEUED、EXECUTING、COMPLETED、FAILED、CANCELED)、payload、output、metadata、createdAt、costInCents。

使用方式:先在后端创建并下发访问令牌,再在任务中触发或定义流,最后在前端用对应钩子订阅并渲染状态、进度或流内容。

限制与建议:令牌应最小授权并设置过期时间,避免长期有效;钩子需处理错误;流可用 throttleInMs 控制重渲染频率。完整文档见 references/realtime.md。