AI SDK AGENTS

---

✨ AI SDK AGENTS：您的全栈AI应用构建利器

欢迎探索 AI SDK AGENTS！我们提供一系列可直接复制、开箱即用的Vercel AI SDK模式，旨在帮助您轻松构建强大的AI应用程序。告别繁琐的从零开始，拥抱高效的模块化开发体验！

---

💡 主要特色与优势

• 即插即用，轻松复制：无需复杂配置，只需简单复制粘贴，即可将交互式AI模块集成到您的项目中。
• 全面的AI SDK模式：我们涵盖了多种核心AI应用场景：
  • 工具调用 (Tool Calling)：集成外部API和服务，让AI agents能与真实世界互动。
  • 数据流 (Dataflows)：高效处理和传输AI生成的数据。
  • 工作流程 (Workflows)：构建多步骤、自动化的AI流程。
  • 人机协作 (Human-in-the-loop)：实现AI与用户之间的无缝协作与确认。
  • 智能代理 (Agent Orchestration)：设计和部署复杂的AI代理系统，实现自主决策和规划。
• 基于Vercel AI SDK v6 和 Shadcn/ui 构建：

  “全栈Vercel AI SDK模式，适用于工作流程、工具调用和代理编排。使用Vercel AI SDK v6和shadcn/ui构建。无头、可主题化、实用。”

  这意味着您将获得：
  • 卓越的流式传输和工具调用能力：支持OpenAI、Claude和Gemini等主流AI模型。
  • 高度可定制的UI组件：基于Tailwind CSS构建的无头组件，您可以完全掌控其外观和风格。
  • 现代开发栈集成：无缝兼容React 19 & Next.js 15，支持Server Components和App Router模式。
• 丰富的应用场景演示：
  • 结构化代理输出 (Structured Agent Output)：通过Output.choice等功能限制代理输出，确保可预测、类型安全的响应。
  • 评估器-优化器模式 (Evaluator-Optimizer Pattern)：双AI代理协同工作，一个评估，一个优化，持续提升输出质量。
  • 内联引用 (Inline Citations)：生成带嵌入式引用的内容，支持来源验证。
  • 队列管理 (Queue Management)：AI代理辅助管理消息、待办事项和附件。
  • 任务管理 (Task Management)：AI自动创建、追踪和分配任务。
  • 动态工具 (Dynamic Tool)：创建运行时生成schemas的动态工具，例如单位转换器。
  • 网络搜索与抓取 (Websearch/Crawling)：利用Firecrawl等工具进行网页内容抓取和数据提取。
  • 人机协作文本输入 (HIL Inquire Text Input)：通过AI驱动的文本输入问题收集详细信息，并支持审批流程。
  • 文字转语音 (Generate Speech)：利用ElevenLabs等API将文本转换为高质量语音。
  • 实时流式结构化对象 (Stream Object)：通过streamObject和experimental_useObject实时流式传输AI生成的结构化数据。
  • AI代理ROI计算器 (ROI Calculator)：高级ROI计算器，用于评估AI代理实施的投资回报。
• 超过80+ AI SDK模式：

  “解锁80+ AI SDK模式，探索用于聊天界面、代理工具调用、工作流程、工件生成等生产就绪的模式。”

  从聊天界面、工具调用到复杂代理编排，应有尽有。

---

🎯 核心概念：Agent（代理）

什么是 Agent？

“代理只是一个LLM，它选择下一步而不是遵循固定的脚本。”

与预定义步骤的工作流不同，Agent 更像一个即兴创作的“厨师”，它理解目标并能根据情况调整计划。

为什么选择 Agent？

• 探索、恢复和适应能力：Agent 能在不确定性高的任务中表现出色。
• 灵活性高：当答案路径模糊不清，或用户需求不断变化时，Agent 能够发挥关键作用。

何时使用 Agent？

我们建议遵循“从小处着手”的原则：

1. 尝试直接的LLM调用。
2. 如仍不满意，添加检索或优化提示。
3. 需要多个固定步骤时，使用工作流。
4. 只有当解决问题的路径不确定时，才考虑使用 Agent。

简而言之：任务明确时用工作流，任务开放或多变时用 Agent。

---

🚀 主要模式概览

我们提供一套核心模式，助您高效构建 AI 应用：

• 1. 提示链 (Prompt Chaining)：将复杂任务分解为多个简单步骤，并在中间进行检查。
• 2. 路由 (Routing)：根据请求分类，将任务分发给最合适的提示或工具。
• 3. 并行化 (Parallelization)：同时运行多个模型调用，然后合并结果（例如：分段处理或投票机制）。
• 4. 编排器 → 工作者 (Orchestrator → Workers)：一个模型规划和委派任务，其他模型专注于特定子任务。
• 5. 评估器 ↔ 优化器 (Evaluator ↔ Optimizer)：两个模型相互协作，一个生成草稿，另一个进行审查和优化。

这些模式可以组合使用，但请记住：只有当复杂性能带来实际效益（如准确性、延迟、成本、安全性）时，才增加它。

---

🛠️ 组件类型

• 完整区块 (Complete Blocks)：
  • 聊天界面（支持流式传输）
  • 工具调用示例（Firecrawl、Exa、自定义函数）
  • 代理模式（多步骤工作流）
  • 数据可视化组件（表格、图表）
• UI 组件 (UI Components)：
  • 流式聊天界面（支持Markdown和代码高亮）
  • 带加载状态的消息组件
  • 实时显示进度的工具执行UI
  • 文件上传组件
  • 带重试逻辑的错误边界
• 数据组件 (Data Components)：
  • 一系列基于React、TypeScript和Tailwind CSS构建的生产就绪数据组件。
• 营销组件 (Marketing Components)：
  • Hero区、价格表、功能网格、推荐语等，适用于构建现代着陆页。
• 工具组件 (Tool Components)：
  • Web抓取工具 (Firecrawl)、搜索工具 (Exa) 和定制工具集成。
  • 包含OpenAI函数调用示例。
• 用例组件 (Use Cases Components)：
  • 平行处理、多步骤工具模式、编排器模式、评估器-优化器模式、工具审批等。

---

📚 快速开始

只需三步，即可将AI功能添加到您的Next.js应用：

1. 设置 shadcn/ui：在您的Next.js项目中初始化 shadcn/ui。
2. 安装 AI 依赖：添加Vercel AI SDK和您偏好的AI提供商（@ai-sdk/openai, @ai-sdk/anthropic, @ai-sdk/google）。
3. 浏览并复制组件：选择一个区块，复制其代码，粘贴到您的应用中即可。

---