关于 ai-agent-workflow
面向 Next.js 开发者的配方式 Skill,指导使用 Workflow Development Kit 构建可恢复的持久化 AI Agent 工作流,涵盖流恢复、聊天持久化和自定义 Agent。
主要功能
- 01配置持久化工作流
- 02恢复 AI 响应流
- 03构建自定义持久化 Agent
- 04实现工具循环
- 05遵循工作流执行实践
适用场景
- 01客户端重连后恢复聊天流
- 02持久化 AI 聊天对话
- 03构建可持久执行的 Agent
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ andrelandgraf/ fullstackrecipes --skill ai-agent-workflow安装后在 Claude Code 中输入/ai-agent-workflow确认已加载。
详细介绍
多 Agent 工作流
构建可恢复的多 Agent 工作流,支持持久执行、工具循环,并在客户端重新连接时自动恢复流。
前提条件
请先按顺序完成以下配方:
使用 better-env 进行类型安全的环境配置
使用 better-env 配置模块,实现类型安全的服务端/公共环境变量访问、功能标志,以及二选一凭据约束。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/config-schema-setup
Neon + Drizzle 设置
使用 Drizzle ORM 将 Next.js 应用连接到 Neon Postgres,并针对 Vercel 无服务器函数优化连接池。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/neon-drizzle-setup
Better Auth 设置
使用 Better Auth、Drizzle ORM 和 Neon Postgres 添加用户身份验证。基础配置使用电子邮件/密码身份验证。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/better-auth-setup
使用 Neon 持久化 AI 聊天记录
将 AI 聊天对话持久化到 Neon Postgres,全面支持 AI SDK 消息部分,包括工具、推理和流式传输。使用 UUID v7 生成可按时间顺序排序的 ID。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/ai-chat-persistence
Pino 日志设置
配置 Pino 结构化日志。在开发环境中输出易读的彩色日志,在生产环境中输出结构化 JSON,以便日志聚合服务处理。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/pino-logging-setup
配方集——请按顺序完成
Workflow Development Kit 设置
安装并配置 Workflow Development Kit,用于构建可恢复、持久化的 AI Agent 工作流,支持步骤级持久化、流恢复和 Agent 编排。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/workflow-setup
可恢复的 AI 响应流
使用 WorkflowChatTransport、启动/恢复 API 端点和 useResumableChat hook,为 AI 聊天添加自动流恢复功能。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/resumable-ai-streams
自定义持久化 Agent
构建自定义持久化 AI Agent,全面控制 streamText 选项、提供商配置和工具循环。兼容 Workflow Development Kit。
curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/custom-durable-agent
工作流最佳实践
创建并运行持久化工作流,使用步骤、流式传输和 Agent 执行。涵盖工作流结果的启动、恢复和持久化。
bunx skills add andrelandgraf/fullstackrecipes/skills -s workflow-best-practices