agent-ui

用途

agent-ui 是一个面向 React/Next.js 的智能体（Agent）组件，来自 ui.inference.sh。其定位是“batteries-included”，即把构建智能体界面所需的常见能力打包进单个组件中，减少自行搭建运行时与工具逻辑的工作量。

主要能力

根据资料，组件内置以下特性：

• 运行时（Runtime included）：无需自行编写后端逻辑。
• 工具生命周期（Tool lifecycle）：涵盖 pending、progress、approval、results 各阶段。
• 人在回路（Human-in-the-loop）：内置审批流程。
• 挂件（Widgets）：由智能体响应生成声明式 JSON UI。
• 流式输出（Streaming）：实时 token 流式传输。
• 客户端工具（Client-side tools）：可在浏览器中运行的工具。

使用方式

1. 安装 belt CLI 技能：npx skills add belt-sh/cli
2. 安装组件：npx shadcn@latest add https://ui.inference.sh/r/agent.json
3. 安装 SDK（用于代理路由）：npm install @inferencesh/sdk
4. 配置 API 代理路由（Next.js）：创建 app/api/inference/proxy/route.ts，内容为导入 route 自 @inferencesh/sdk/proxy/nextjs 并导出 GET, POST, PUT。
5. 设置环境变量：在 .env.local 中配置 INFERENCE_API_KEY=inf_...。
6. 在页面中调用组件，示例：导入 Agent 自 @/registry/blocks/agent/agent，传入 proxyUrl="/api/inference/proxy" 与 agentConfig（含 core_app.ref、description、system_prompt）。

客户端工具示例中，通过 createScopedTools(formRef) 创建工具并传入 config.tools，配合 system_prompt 指示可使用表单填写工具。

Props 包括：

• proxyUrl（string）：API 代理端点
• name（string）：智能体名称（可选）
• config（AgentConfig）：智能体配置
• allowFiles（boolean）：启用文件上传
• allowImages（boolean）：启用图片上传

相关技能与文档

相关技能可通过 npx skills add inference-sh/skills@chat-ui、@widgets-ui、@tools-ui 安装。文档涉及 Agents Overview、Agent SDK、Human-in-the-Loop、Agents That Generate UI、Agent UX Patterns，组件文档位于 ui.inference.sh/blocks/agent。

适用场景与限制

适用于需要在 React/Next.js 项目中快速集成智能体对话和交互界面的开发者。资料未提供关于收费、价格、平台兼容范围、性能表现或具体效果的信息。