SuperAPI AI 工具集

voice-agent

智能体与模型

查看项目

更新于 10-16 01:12

技能介绍

用途:构建能接听和拨打真实电话的 AI 语音代理。代理与消息代理是同一对象,只是多了一个 voice 配置块。Zavu 负责整条链路:语音识别、模型推理、语音合成与打断处理,你只需提供提示词和技能。注意:语音是工具真正执行的渠道,纯文本路径不会向模型提供工具。

主要能力:voice 块可配置 enabled(必填)、greeting 与多语言 greetings、language、对话模型、ttsProvider/ttsVoiceId、sttProvider/sttModel、voiceSpeed(0.5–1.5)、interruptible(默认允许打断)、maxCallDurationMinutes(1–120)、maxIdleSeconds(5–300)、voicemailAction 与 voicemailMessage、transferPhoneNumber(设置后代理获得转接工具,实现人工接管)。channels 与 voice 相互独立,需同时配置。工具用 defineTool 声明,在 Zavu Cloud 的函数中执行;预订类需求可直接在仪表盘添加 check_availability、book_meeting 并连接 Cal.com 或 Google 日历,无需写后端。

使用方式:可用 npx zavudev agents catalog 查看现成代理,npx zavudev agents pull kepler --dir kepler 拉取脚手架(预订类加 --calendar calcom),npm install 后 npx zavudev deploy 部署,npx zavudev agents list 确认结果。用 npx zavudev agents senders connect 把多个号码接到同一代理。本地可用 npx zavudev fn invoke --tool <名称> --args '{...}' 测试工具处理器;npx zavudev agents test 测试提示词与知识库(仅文本路径,不触发工具调用)。外呼用 npx zavudev calls create --to <号码>,查看用 calls list / calls get(含逐轮转写与工具调用)/ calls hangup。

适用场景:电话预订、客服应答、外呼提醒等需要真实通话与工具执行的场景。

限制:需 voice.enabled: true,否则 POST /v1/calls 返回 400;测试模式 API 密钥不可用;接听来电需具备语音能力的电话号码;按接通分钟数加电话费从预付余额计费,402 表示余额不足。无法免费试听音频,agents test 仅文本且会提示该限制。工具处理器不得返回虚假成功,否则会向真实来电者确认不存在的预订。部署退出码为 0 不代表代理可达,需检查警告行。voiceSpeed 仅部分语音支持,greetings 需匹配来电者语言。号码能力列由运营商上报,可能不准,应以 sender 的 channels 是否包含 voice 为准。