Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nvd-54.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

AI Elements 是一个可组合的、基于 shadcn/ui 的组件库，专为 AI 聊天界面而构建。Conversation、Message、Tool、Reasoning 和 PromptInput 等组件可直接放入任何 React 项目中，并以最少的粘合代码连接到 stream.messages。
克隆并运行完整的 AI Elements 示例，查看工具调用渲染、推理展示、流式消息等在工作项目中的效果。

​
工作原理

  1. 将组件作为源文件安装： AI Elements 通过 CLI 发布，直接将组件添加到你的项目中（shadcn/ui 注册表风格）
  2. 将消息映射到组件： 遍历 stream.messages，将 HumanMessage 实例渲染为用户气泡，将 AIMessage 实例渲染为助手响应
  3. 组合更丰富的 UI： 将工具调用包装在 <Tool> 中，推理包装在 <Reasoning> 中，所有内容都包装在 <Conversation> 中以进行滚动管理

​
安装

通过 CLI 安装 AI Elements 组件。它们作为可编辑的源文件添加到你的项目中： 
npm install @langchain/react @ai-elements/react
npx ai-elements@latest add conversation message prompt-input tool reasoning suggestion

​
连接 useStream

直接从 stream.messages 渲染 AI Elements 组件。每个 LangChain BaseMessage 映射到一个组件： 
import { useStream } from "@langchain/react";
import { HumanMessage, AIMessage } from "@langchain/core/messages";

import {
  Conversation,
  ConversationContent,
  ConversationScrollButton,
} from "@/components/ai-elements/conversation";
import {
  Message,
  MessageContent,
  MessageResponse,
} from "@/components/ai-elements/message";
import {
  Tool,
  ToolHeader,
  ToolContent,
  ToolInput,
  ToolOutput,
} from "@/components/ai-elements/tool";
import {
  Reasoning,
  ReasoningTrigger,
  ReasoningContent,
} from "@/components/ai-elements/reasoning";
import {
  PromptInput,
  PromptInputBody,
  PromptInputTextarea,
  PromptInputFooter,
  PromptInputSubmit,
} from "@/components/ai-elements/prompt-input";

export function Chat() {
  const stream = useStream({
    apiUrl: "http://localhost:2024",
    assistantId: "agent",
  });

  return (
    <div className="flex flex-col h-dvh">
      <Conversation className="flex-1">
        <ConversationContent>
          {stream.messages.map((msg, i) => {
            if (HumanMessage.isInstance(msg)) {
              return (
                <Message key={i} from="user">
                  <MessageContent>{msg.content as string}</MessageContent>
                </Message>
              );
            }
            if (AIMessage.isInstance(msg)) {
              return (
                <div key={i}>
                  {/* 推理块（当模型发出思考 Token 时显示） */}
                  <Reasoning>
                    <ReasoningTrigger />
                    <ReasoningContent>{getReasoningText(msg)}</ReasoningContent>
                  </Reasoning>

                  {/* 内联工具调用，带输入/输出显示 */}
                  {getToolCalls(msg).map((tc) => (
                    <Tool key={tc.id} defaultOpen>
                      <ToolHeader type={`tool-${tc.name}`} state={tc.state} />
                      <ToolContent>
                        <ToolInput input={tc.args} />
                        {tc.output && (
                          <ToolOutput output={tc.output} errorText={undefined} />
                        )}
                      </ToolContent>
                    </Tool>
                  ))}

                  {/* 流式文本响应 */}
                  <Message from="assistant">
                    <MessageContent>
                      <MessageResponse>{getTextContent(msg)}</MessageResponse>
                    </MessageContent>
                  </Message>
                </div>
              );
            }
          })}
        </ConversationContent>
        <ConversationScrollButton />
      </Conversation>

      <PromptInput
        onSubmit={({ text }) =>
          stream.submit({ messages: [{ type: "human", content: text }] })
        }
      >
        <PromptInputBody>
          <PromptInputTextarea placeholder="Ask me something..." />
        </PromptInputBody>
        <PromptInputFooter>
          <PromptInputSubmit
            status={stream.isLoading ? "streaming" : "ready"}
          />
        </PromptInputFooter>
      </PromptInput>
    </div>
  );
}

​
最佳实践

  • 自由编辑源文件： 组件以源文件形式存在于你的项目中，而不是作为外部包依赖，因此你可以更改任何内容而无需 fork
  • 使用 MessageResponse 进行流式处理： 它能正确处理流式部分 Token；避免在流式处理期间直接渲染原始 msg.content
  • 用 Conversation 包装： Conversation 组件管理滚动行为，使新消息自动滚动到视图中
  • 使用 isInstance 进行判断： 使用 HumanMessage.isInstance(msg) 和 AIMessage.isInstance(msg) 而不是检查 msg.getType()，以获得正确的 TypeScript 类型收窄
将这些文档连接到 Claude、VSCode 等工具，通过 MCP 获取实时答案。
在 GitHub 上编辑此页面或提交 issue。