SuperAPI AI 工具集

agents-ui

智能体与模型

查看项目

更新于 10-16 05:02

技能介绍

用途:为 LiveKit 语音 AI 智能体构建基于 React 的前端界面,组件采用 shadcn 风格,安装后可完全自定义。该技能可与 LiveKit MCP 服务器配合,通过 docs_search、get_pages、get_changelog、code_search、get_python_agent_example 等工具获取最新文档与示例。

前置条件:Node.js >= 18、React 19、Tailwind CSS 4,且项目中已初始化 shadcn/ui。

安装:先在 components.json 中添加注册表 "@agents-ui": "https://livekit.io/ui/r/{name}.json",再用 npx shadcn@latest add @agents-ui/agent-session-provider 等命令安装所需组件,组件会复制到 components/agents-ui/ 目录。还需安装依赖:npm install livekit-client @livekit/components-react。

主要能力与组件:AgentSessionProvider 是必需的状态包装器;AgentControlBar 提供组合媒体控制与可视化;音频可视化有 Bar、Grid、Radial、Wave、Aura 五种样式;AgentTrackToggle / AgentTrackControl 控制麦克风、摄像头、屏幕共享;AgentChatTranscript、AgentChatIndicator 显示对话转录与输入指示;AgentDisconnectButton、StartAudioButton 用于会话控制和音频启动。

使用方式:用 useSession 从 @livekit/components-react 创建 session,并传入 AgentSessionProvider;TokenSource 从 livekit-client 导入,用 useRef 包裹避免重复创建,开发可用 TokenSource.sandboxTokenServer,生产可用 TokenSource.endpoint('/api/token')。通过 useEffect 调用 session.start() 并在清理时调用 session.end()。

状态与定制:会话状态包括 initializing、listening、thinking、speaking,可通过本地 useAgentState 钩子使用。组件支持 className 覆盖样式,因组件已复制到项目,可直接修改源码。

限制:需 React 19、Tailwind CSS 4 与 shadcn/ui 环境;音频播放需处理浏览器交互权限,必要时使用 StartAudioButton。资料未提供价格、收费或效果保证等信息。