Polpo UI 是 Polpo AI 智能体专用的可组合 React 聊天组件集合，主打「三种组合层级、三种安装方式」。
用途方面，资料表明它用于构建 AI agent 交互界面，适合需要创建聊天应用、聊天挂件（chat widget）或多智能体（multi-agent）界面的场景。组件本身不处理路由，会话跳转需通过 onSessionCreated 回调接入项目自身的路由方案。
主要能力包括一组聊天相关组件：Chat（根复合组件，由 Provider + Messages + Input 组成）、ChatInput（文本域、提交、文件附加、拖放）、ChatMessage（用户/助手消息分发）、ChatMessages（带自动滚动的 Virtuoso 列表）、ChatProvider（包装 useChat 与 useFiles 的上下文）、ChatSessionList（可选中/删除的平铺会话列表）、ChatSessionsByAgent（按智能体分组的会话）、ChatAgentSelector（智能体下拉选择器）、ChatSuggestions（建议按钮网格）、ChatAskUser（向用户提问向导）、ChatLanding（落地页 + 问候 + 输入 + 建议）、ChatScrollButton（滚动到底部指示）、ChatSkeleton（加载骨架）、ChatTyping（打字动画点）、ToolCallChip（自动分发的工具渲染器）、ToolCallShell（带展开/折叠的基础工具渲染器）。配套 Hooks 提供 useChatContext（返回 messages、sendMessage、isStreaming、abort、uploadFile、pendingToolCall）、useSubmitHandler 与 useDocumentDrag。
使用方式上，新项目可用 npx create-polpo-app 交互式创建，或以非交互方式指定模板：npx create-polpo-app my-app -t chat -y、-t chat-widget -y、-t multi-agent -y。向现有项目添加时采用 shadcn 风格复制源码：npx @polpo-ai/ui add（交互式多选），或 npx @polpo-ai/ui add --all、npx @polpo-ai/ui add tools hooks --overwrite（非交互）。也可安装编译后的 npm 包：npm install @polpo-ai/chat @polpo-ai/sdk @polpo-ai/react react-virtuoso lucide-react streamdown，并在 Tailwind 中配置扫描路径（Tailwind v4 使用 @source "../node_modules/@polpo-ai/chat/dist//*.js"，Tailwind v3 在 tailwind.config.js 的 content 中加入 "./node_modules/@polpo-ai/chat/dist//*.js"）。Provider 配置示例为：import { PolpoProvider } from "@polpo-ai/react"，并以 baseUrl="https://api.polpo.sh"、apiKey={process.env.NEXT_PUBLIC_POLPO_API_KEY}、autoConnect={false} 包裹 children；资料特别提示 baseUrl 为根 URL，SDK 内部会自动追加 /v1/，不要手动添加。
组合层级分三档：Level 1 零配置（<Chat agent="coder" sessionId="session_abc" />）；Level 2 组合（传入 children 替换默认输入框，如自定义 MyCustomInput）；Level 3 原语（直接导入 ChatMessage、ChatSkeleton 与 useChat 自行组装）。此外还有 Render Function 模式，依据 hasMessages 在 ChatInput 与 LandingPage 之间切换。
参考资料指向 references/components.md（各组件完整 props）、references/patterns.md（应用组装、ask-user、会话、自定义工具）、references/cli.md（create-polpo-app、@polpo-ai/ui 与相关 flag）、references/theming.md（颜色、暗色模式、字体、Tailwind 配置）。
限制与缺失信息：资料未说明该工具的收费、价格、授权协议、运行平台与效果承诺；组件包不负责路由，需开发者自行处理。上述未提及事项暂未提供。