用途:面向以代理为先的应用,整理 Vercel AI SDK v6(6.0+)的使用规则,适用于设置模型提供方、用 tool() 定义代理工具、实现多步代理工作流、从 generateText/streamText 提取结果,以及从 v5 迁移到 v6。
主要能力与规则分类:按优先级分为提供方设置(provider-,关键)、文本生成(generate-,高)、工具定义(tool-,高)、多步代理(agent-,高)、结果提取(result-,中)、消息类型(message-,中)、错误处理(error-,中)。
关键 v6 变更:CoreMessage 改为 ModelMessage;工具参数 parameters 改为 inputSchema;maxSteps 改为 stopWhen: stepCountIs(5);call.args 改为 call.input;call.toolResult 改为 step.toolResults[].output。
用法要点:使用 AI Gateway 模型字符串(如 anthropic/claude-opus-4-5)时无需提供方包装;工具用 tool({ description, inputSchema, execute }) 定义;多步代理用 stopWhen: stepCountIs(5);结果提取通过 result.steps.flatMap 遍历 step.toolCalls 与 step.toolResults,用 toolCallId 匹配 output。常用导入包括 generateText、generateObject、streamText、streamObject、tool、stepCountIs、hasToolCall、ModelMessage,以及 Zod 4.x 的 z。认证需设置 AI_GATEWAY_API_KEY 环境变量。
限制:资料未提供具体安装命令、版本兼容细节、收费信息及完整规则文件内容,需查阅各规则文件(如 rules/provider-gateway.md、rules/tool-input-schema.md、rules/agent-stop-when.md、rules/result-tool-access.md)获取详细说明与代码示例。