聊天机器人

Chatbot（原名 AI Chatbot）是一款基于 Next.js 和 AI SDK 构建的免费开源模板，可帮助您快速搭建功能强大的聊天机器人应用。

阅读文档 · 功能特性 · 模型提供商 · 部署属于您自己的版本 · 本地运行

功能特性

• Next.js 应用路由
  • 先进的路由系统，实现无缝导航与卓越性能
  • React 服务器组件（RSCs）和服务器操作，用于服务端渲染并提升性能
• AI SDK
  • 统一的 API，支持使用大语言模型生成文本、结构化对象及工具调用
  • 提供钩子，便于构建动态的聊天与生成式用户界面
  • 通过 AI 网关支持 OpenAI、Anthropic、Google、xAI 等多家模型提供商
• shadcn/ui
  • 基于 Tailwind CSS 的样式系统
  • 使用 Radix UI 的组件基元，确保无障碍访问与高度灵活性
• 数据持久化
  • 使用 Neon Serverless Postgres 存储聊天记录与用户数据
  • 利用 Vercel Blob 实现高效的文件存储
• Auth.js
  • 简单且安全的身份验证机制

模型提供商

本模板使用 Vercel AI 网关 通过统一接口访问多种 AI 模型。模型配置位于 lib/ai/models.ts 文件中，并按不同提供商进行路由设置。当前包含的模型有：Mistral、Moonshot、DeepSeek、OpenAI 和 xAI。

AI 网关身份验证

对于 Vercel 部署：身份验证将通过 OIDC 令牌自动完成。

对于非 Vercel 部署：您需要在 .env.local 文件中设置 AI_GATEWAY_API_KEY 环境变量，以提供 AI 网关的 API 密钥。

借助 AI SDK，您还可以仅需几行代码，便切换到直接对接 LLM 提供商的方式，例如 OpenAI、Anthropic、Cohere 等，以及更多其他提供商。

部署属于您自己的版本

您只需点击一下，即可将 Chatbot 的自定义版本部署到 Vercel：

本地运行

要运行 Chatbot，您需要使用 .env.example 中定义的环境变量。建议您使用 Vercel 环境变量 来管理这些变量，但仅使用一个 .env 文件也足够。

注意：请勿提交您的 .env 文件，否则会泄露敏感信息，导致他人能够控制您各类 AI 及身份验证提供商的账户权限。

1. 安装 Vercel CLI：npm i -g vercel
2. 将本地实例与 Vercel 和 GitHub 账户关联（此操作会创建 .vercel 目录）：vercel link
3. 下载您的环境变量：vercel env pull

pnpm install
pnpm db:migrate # 初始化数据库或应用最新的数据库变更
pnpm dev

此时，您的应用模板应该已经在 localhost:3000 上运行了。

Chatbot 快速上手指南

Chatbot 是一个基于 Next.js 和 AI SDK 构建的免费开源模板，旨在帮助开发者快速搭建功能强大的聊天机器人应用。它支持多种大模型提供商（如 OpenAI、Anthropic、DeepSeek 等），并集成了用户认证、数据持久化和文件存储等功能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• Node.js：建议安装最新 LTS 版本 (v18+)
• 包管理器：推荐使用 pnpm (也可使用 npm 或 yarn)
• Vercel 账号：用于一键部署和管理环境变量（可选，但推荐）
• 数据库：本项目默认配置为 Neon Serverless Postgres（通过 Vercel 集成自动处理）

安装步骤

1. 一键部署（推荐）

最快上手的方式是通过 Vercel 一键部署模板，这将自动配置环境变量和数据库：

点击按钮后，按照 Vercel 界面提示完成项目创建。

2. 本地运行

如果您希望在本地开发或自定义代码，请按以下步骤操作：

第一步：安装 Vercel CLI 并拉取配置 我们需要使用 Vercel CLI 来关联项目并下载必要的环境变量（包括 AI Gateway 密钥和数据库连接串）。

npm i -g vercel
vercel link
vercel env pull

注意：vercel env pull 会生成 .env.local 文件。请勿将此文件提交到版本控制系统，以免泄露密钥。

第二步：安装依赖与初始化数据库 进入项目目录，安装依赖并执行数据库迁移：

pnpm install
pnpm db:migrate

第三步：启动开发服务器

pnpm dev

启动成功后，访问 http://localhost:3000 即可看到应用。

基本使用

配置模型提供商

该项目默认通过 Vercel AI Gateway 统一接入多种模型（包括 Mistral, Moonshot, DeepSeek, OpenAI, xAI 等）。

• Vercel 部署环境：无需额外配置，系统自动通过 OIDC 令牌进行认证。
• 本地或非 Vercel 环境：确保 .env.local 文件中已包含 AI_GATEWAY_API_KEY。若需切换为直接调用特定厂商（如直接调用 OpenAI 或 Anthropic），可修改 lib/ai/models.ts 文件中的路由配置，利用 AI SDK 仅需几行代码即可切换提供商。

核心功能体验

启动应用后，您将体验到以下核心功能：

1. 智能对话：在聊天界面输入问题，系统将调用配置的 LLM 进行流式回复。
2. 多模态支持：支持上传文件（通过 Vercel Blob 存储），实现基于文档的问答。
3. 用户系统：内置 Auth.js，支持安全的用户登录与注册，聊天记录将自动保存至 Neon Postgres 数据库。
4. UI 交互：基于 shadcn/ui 和 Tailwind CSS 构建，提供响应式且美观的聊天界面。

自定义开发

若要添加新的工具调用或调整 UI 组件：

• 后端逻辑：编辑 app/(chat)/api 目录下的路由处理器，利用 AI SDK 的 Hooks 扩展功能。
• 前端组件：修改 components 目录，所有 UI 组件均基于 Radix UI 构建，易于定制和扩展。