核心用法
agent-ui 是 ui.inference.sh 提供的 React/Next.js 组件，主打 "Batteries-included" 理念——开发者无需编写复杂后端逻辑，即可在数行代码内搭建具备完整生命周期的 AI Agent 界面。
集成步骤
1. 通过 shadcn CLI 安装组件：npx shadcn@latest add https://ui.inference.sh/r/agent.json
2. 安装 SDK 并创建 API Proxy 路由：npm install @inferencesh/sdk，在 Next.js 中暴露 GET/POST/PUT 端点。
3. 配置环境变量 INFERENCE_API_KEY。
4. 引入 <Agent> 组件，传入 proxyUrl 与 agentConfig（支持指定 LLM ref、system prompt、工具列表）。
关键特性
| 特性 | 说明 |
|------|------|
| 内置运行时 | 无需自建后端，代理路由自动转发请求 |
| 工具生命周期 UI | Pending → Progress → Approval → Results 的完整可视化 |
| 人工审批 (Human-in-the-loop) | 敏感操作自动弹出确认框，支持二次授权 |
| 生成式 Widgets | Agent 返回 JSON 即可渲染声明式 UI（表单、卡片等） |
| 流式输出 | 实时 Token 流，降低等待焦虑 |
| 客户端工具 | 支持在浏览器内执行的 local tools（如自动填表） |
适用人群
- SaaS 产品经理/前端开发者：需在现有产品中快速嵌入 "Copilot" 或 "AI 助手" 功能。
- 创业公司/MVP 团队：希望跳过基础设施，直接验证 AI 交互原型。
- 已有 shadcn/ui 技术栈的团队：组件风格一致，可无缝融入现有设计系统。
潜在局限与风险
1. 供应商锁定：深度绑定 inference.sh 生态（SDK、API Key、Proxy 路由），迁移成本较高。
2. 可定制性边界：虽支持 Widgets 与 client-tools，但复杂自定义 UI（如完全重写的审批流）可能需要 fork 源码。
3. 网络与合规：proxyUrl 模式意味着用户流量需经过开发者自建端点，若部署区域与 inference.sh 服务端存在跨境延迟或数据合规要求，需额外评估。
4. 调试透明度：工具执行状态由组件内部管理，深层调试需依赖官方 SDK 日志或浏览器 DevTools。
安全与可信度
- 组件源码托管于公开 registry，但未提供第三方安全审计报告；建议生产环境启用
INFERENCE_API_KEY权限最小化原则，并对proxyUrl实施速率限制与鉴权。 - 人工审批机制可降低误操作风险，但默认配置下仍需关注敏感工具（如数据写入、支付操作）的权限粒度。