AI对话界面渲染
用 React 渲染 AI 对话消息,让工具调用和流式状态正常显示
功能与用途
基于 AI SDK v6 规范的 AI 对话与工具调用前端渲染指南。详细解析包含文本、工具调用、思考过程及步骤标记的 UIMessage parts 数组结构,提供手写映射遍历与卡片化呈现的标准组件模式,涵盖输出完成、等待批准、拒绝等完整状态流。同时指导配套服务端路由的 streamText 与异步 convertToModelMessages 写法,梳理避免直接输出原始 JSON、防止 useChat 兼容报错等高频踩坑点。
适用场景
- 自定义聊天界面构建:在 React 应用中遍历 UIMessage 的 parts 数组,分别渲染文本、思考流与各类交互状态。
- 结构化工具调用展示:告别原始 JSON 打印,将工具调用与执行结果转换为可视化的卡片及审核交互组件。
- AI 消息流式显示排错:定位和修复因服务端格式不兼容或前端直接取 content 导致的消息空白、乱码与报错。
适用人群
- 用 Next.js + AI SDK 做聊天界面的前端工程师
- 需要自定义渲染工具调用结果的 AI 应用开发者
- 排查对话显示异常的开发者
使用步骤
- 说清你卡在哪:全是原始 JSON、工具结果显示不对、还是消息根本不出现
- 让它给出对应的 parts 渲染代码,工具部分按 state 区分运行中、需批准、已完成、被拒绝
- 服务端按它说的用 convertToModelMessages 转换,并改用 toUIMessageStreamResponse 返回
- 客户端换成 DefaultChatTransport 和 sendMessage,再对着常见错误清单逐条核
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
AI chat response rendering guidance — handling UIMessage parts, tool call displays, streaming states, and structured data presentation. Use when building custom chat UIs, rendering tool results, or troubleshooting AI response display issues.
使用前准备
- Next.js 项目与 React 开发环境
- 已接入 AI SDK v6(@ai-sdk/react)
依赖与权限
- 读取用户主动提供的内容