SuperAPI AI 工具集

livekit-agents

智能体与模型

查看项目

更新于 10-16 07:20

技能介绍

用途:这是一个面向 LiveKit Cloud 的语音 AI 智能体开发技能,适用于用户提出“构建语音智能体”“创建 LiveKit 智能体”“加入语音 AI”等需求时。它给出的是开发方法论而非具体 API 细节,假定使用 LiveKit Cloud,自托管场景的部分建议(尤其 LiveKit Inference)不直接适用。

主要能力与要点:提供架构与工作流指导,如用 handoff 分离对话阶段、用 task 限定范围操作,减少单体智能体带来的上下文膨胀;强调语音场景延迟关键,需压缩 LLM 上下文、避免不必要工具调用、优先流式响应,并处理网络延迟与打断等异常路径。

必要用法与前提:开始前需完成检查清单——读完技能文档、准备好 LiveKit Cloud 项目凭据(LIVEKIT_URL、LIVEKIT_API_KEY、LIVEKIT_API_SECRET,通常写入 .env.local)、配置文档访问、计划编写测试,并对照实时文档验证所有 API。推荐通过 LiveKit Inference 使用 AI 模型,可免管理各模型厂商密钥;CLI 可辅助凭据设置。

文档与测试:禁止依赖模型记忆中的 LiveKit API,须使用 livekit-docs MCP 查证;若不可用,应告知用户并建议按 https://docs.livekit.io/intro/mcp-server/ 安装,或改用网络搜索并标注未验证代码。每个智能体实现必须包含测试,覆盖基本对话流、工具调用、错误处理与工作流转换,推荐测试驱动开发。

限制:技能本身不提供 API 签名、配置值、部署步骤与模型清单,需查实时文档;智能体在手动测试中“看似可用”也可能在生产中失败,未经测试不建议发布。