跳转到使用指南
AI Elements作者 vercel

AI Elements Skill.

用可编辑的 React 组件构建 AI 聊天界面。

  • AI 界面
  • React
源文件解读 · ai-elementsSKILL.md
任务 用可编辑的 React 组件构建 AI 聊天界面。 产出 添加到项目所配置组件目录中的指定组件源文件。 开始前的准备 文档列出的前置条件包括 Node.js 18+、Next.js、AI SDK 和 shadcn/ui。
编辑摘要 · 源文件核查于 2026-11-02 · 非生成示例

01 功能说明

用可编辑的 React 组件构建 AI 聊天界面

使用 Vercel 的 AI Elements Skill,以基于 shadcn 的可编辑 React 组件组合聊天消息、工具展示和提示词输入界面。

基于来源的工作流并非执行基准测试

工作方法

AI Elements 指导智能体为现有 Next.js 应用添加专门用于聊天的组件,涵盖对话视图、消息内容、工具展示和提示词输入。组件代码保存在你的仓库中,因此界面可以遵循产品自身的样式和交互要求。

源文件将这些组件与 AI SDK 及 shadcn/ui 的约定衔接起来。示例围绕文本片段组合基础消息组件,而不是把助手回复当作一个无法拆分的黑盒控件。因此,当模型已经接入、接下来需要为用户提供连贯的阅读和回复界面时,这款 Skill 就能派上用场。

预期交付物

  • 添加到项目所配置组件目录中的指定组件源文件。
  • 由消息和回复基础组件组合而成的 React 对话视图。
  • 符合项目的样式,以及尚未解决的集成问题说明。
查看示例简报

从简报到审查

  1. 01
    检查现有应用

    检查包执行工具、Next.js 环境、AI SDK 依赖和 shadcn 配置。添加组件之前,确认导入别名和全局样式。

  2. 02
    添加所需界面组件

    通过项目的包执行工具运行受支持的组件安装器。选择对话界面需要的组件,并检查新增到仓库中的文件。

  3. 03
    接入并定制

    按照源文件示例,将每条消息的角色映射到 Message,嵌套 MessageContent,并用 MessageResponse 渲染文本片段。工具结果需要使用专门支持该结果的展示方式,不能假定这个纯文本示例也能渲染它们。调整本地 Tailwind 类,并检查生成的各类对话状态。

02 适用场景

适合什么场景

文档列出的前置条件包括 Node.js 18+、Next.js、AI SDK 和 shadcn/ui。

适合的场景

  • 需要可编辑的聊天界面Next.js 聊天机器人需要可编辑的消息和输入组件。
  • 项目已经遵循 shadcn 约定团队希望在现有 shadcn 约定下定制 AI 界面代码。

需要检查的限制

  • 应用的前置条件文档列出的前置条件包括 Node.js 18+、Next.js、AI SDK 和 shadcn/ui。
  • 后端集成仍需单独确认添加界面组件并不代表模型凭据、流式接口或工具执行已经配置完成。

请提供这些输入

  • 项目配置应用的包配置和组件别名。
  • 消息数据约定AI SDK 集成所提供的消息和工具结果数据结构。
  • 界面方向期望的对话布局、主题和组件选择。

03 关键决策

影响结果的关键选择

  1. 源代码由项目掌控

    组件代码保存在产品仓库中,可以查看和编辑。

  2. 可组合的回复界面

    通过组合基础消息组件,可以分别展示回答中需要独立呈现的部分。

  3. 沿用既有样式约定

    现有 Tailwind 和 shadcn 约定为集成提供了明确的起点。

04 示例任务

从一份具体的需求开始

以下示例任务说明尚未经过测试。使用前请检查该技能的设置。

查看源文件和环境要求

应用的包配置和组件别名。

上游源文件
https://github.com/vercel/ai-elements/blob/ca8be600bfd01b3131f9bf6134b51602a71f4374/skills/ai-elements/SKILL.md

下方链接会打开上游使用说明。使用前请查看仓库的环境配置要求;这不是安装命令。

先完成一项明确的交付物

运行该技能之前,请根据需要调整此需求中的范围、来源材料和约束。

示例简报
使用 ai-elements,为这个现有 Next.js 应用构建对话页面。先检查我们的包执行工具、shadcn 配置、别名和 AI SDK 消息结构。只添加这个页面需要的消息、回复和提示词输入组件。按照文档中的组合方式展示文本片段,并保留当前主题。初次预览使用预先准备的测试消息。请说明添加了哪些源文件、界面如何连接到现有的聊天 hook,以及哪些运行时依赖仍需验证。

检查结果

根据以下可观察标准检查实际输出。

  • 导入路径能够通过实际组件位置和已配置的别名正确解析。
  • 消息角色和文本片段按预期主题渲染。
  • 智能体明确区分可用的界面预览与经过验证的真实模型对话。

OpenDesign 为编码智能体提供本地设计工作区。此条目并不表示该技能已内置,也不表示其中包含其外部工具、凭据和软件依赖项。

05 来源与许可证

来源与许可证

本页面描述的是下方链接所指向的固定来源修订版本。上游行为和要求可能会发生变化。

来源所有者
vercel
技能文件
SKILL.md
许可证
Apache-2.0
已审查的快照
2026-11-02 · ca8be600bfd0
编辑来源摘要
用可编辑的 React 组件构建 AI 聊天界面。

由 OpenDesign 根据所链接来源撰写的原创摘要。仓库星标数只是带有时间属性的受欢迎程度指标,并不代表技能使用量或质量评分。

06 开始前的问题

开始前可能想问

安装后的组件可以编辑吗?

可以。安装器会把组件代码添加到你的项目中,你可以定制其中的样式类和行为。

必须使用 AI Gateway 吗?

源文件推荐通过它访问模型;前置条件清单则单独列出了应用、AI SDK 和 shadcn 的配置要求。

为什么组件看起来没有样式?

修改组件的标记结构之前,先检查项目的 Tailwind 和 shadcn 全局样式。

OpenDesign

让需求和设计工作保存在一起。

将简报、来源材料和设计工作集中保存在本地工作区中。将该技能添加到工作流程前,请检查其自身的设置说明。

上游源文件
https://github.com/vercel/ai-elements/blob/ca8be600bfd01b3131f9bf6134b51602a71f4374/skills/ai-elements/SKILL.md