inngest-agents

用途：该技能面向需要构建、迁移或调试 AI 智能体、多步骤 AI 工作流、工具调用循环、客服智能体、研究智能体、人工审批流程以及实时智能体 UI 的用户。核心思路是把智能体运行交给 Inngest 函数托管，用 AgentKit 的 createAgent 定义智能体，模型调用走 Inngest step.ai 以获得持久化的重试与结果缓存。\n\n主要能力：围绕智能体使用 Inngest 底层 step 原语处理数据库读写、工具有副作用、等待、审批、实时进度与流程控制。支持工具调用、human-in-the-loop（用 step.waitForEvent 等待人工审批，可设 timeout 与 match）、实时进度（v4 用 step.realtime.publish，或在一段 step.run 内用 inngest.realtime.publish）、以及并发与限流（按 provider 或租户设 key，如 throttle 限 120/1m、concurrency 按 accountId 限 3）。推荐架构为：HTTP 层鉴权并以稳定 ID 发事件后快速返回；Inngest 函数负责智能体运行；在 step.run 中加载状态与上下文；模型推理走 AgentKit/step.ai；非模型副作用用 step.run 包裹。\n\n适用场景：智能体可能超过单次 HTTP 请求、需要调用工具/API/数据库/MCP、需在部署或崩溃后存活、需等待人工审批或外部回调、需把进度流式传给 UI、需为模型调用设并发或限流、且重复发送/计费/写入代价高昂时较合适。若只是单次短小只读模型调用、无副作用，或 UI 自动补全允许丢请求，则通常不值得使用。\n\n限制与注意事项：工具副作用应隔离在 step.run 并有稳定幂等键，工具参数需用 schema 校验，租户/用户 ID 应取自已鉴权事件数据；工具输出需适配 step 状态上限。避免把智能体循环状态只放内存、对全部调用单个大 try/catch、一个工具失败就重跑整个智能体、用 setTimeout/cron 轮询/Redis TTL 做人工审批。文档另提供可复制的 example（../../examples/durable-agent）与验证建议（类型检查、单测工具、复用开发服务器查看步骤）。缺少的具体版本与安装细节暂未提供。