Vapi Squads — Multi-Agent Voice Routing in One Call

简介

Vapi Squads 把多个语音 agent 接成一个协调栈 —— 用户进来先碰 Greeter，通话中切给 Specialist，再交给 Closer 收尾。每个 agent 有自己的系统 prompt、工具、声音。适合单一 mega-prompt 变脆的语音产品（比如医疗问诊 → 分诊 → 预约）。Vapi 平台原生，Squad 可以包含 Workflow 或自由 assistant。装机时间 5 分钟（定义 agent → 接转接）。

为什么拆成 squad

单一 prompt 说「当酒店礼宾 AND 处理预订 AND 转给维修 AND…」做出来的 agent 各方面都平庸。Squad 让你写三个聚焦的小 prompt：

• Greeter（热情、转接快）
• BookingSpecialist（懂价格 / 日历 / 升级）
• MaintenanceTriage（问题分类、转真人）

各自有自己的工具集和声音。Squad 按意图在它们之间路由。

定义 squad

curl -X POST https://api.vapi.ai/squad \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -d '{
    "name": "Acme Concierge Squad",
    "members": [
      {
        "assistantId": "greeter-id",
        "assistantDestinations": [
          { "type": "assistant", "assistantName": "BookingSpecialist", "message": "Let me transfer you to our booking specialist." },
          { "type": "assistant", "assistantName": "MaintenanceTriage", "message": "Connecting you to maintenance." }
        ]
      },
      {
        "assistantId": "booking-specialist-id",
        "assistantDestinations": [
          { "type": "assistant", "assistantName": "Greeter", "message": "Anything else I can help with?" }
        ]
      },
      {
        "assistantId": "maintenance-triage-id",
        "assistantDestinations": [
          { "type": "assistant", "assistantName": "Greeter" }
        ]
      }
    ]
  }'

切换怎么发生

在 Greeter 的系统 prompt 里给 LLM 一个 transferCall 工具，目的地由 squad 声明。LLM 检测到意图就调这个函数，Vapi 切换到下一个 assistant —— 音频会话保持，不重新拨号。

Greeter: "Hi, Acme Hotels. How can I help?"
User:    "I'd like to book a room for next weekend."
Greeter: [调 transferCall(destination: "BookingSpecialist")]
         "Let me transfer you to our booking specialist."
[BookingSpecialist 接管，带完整对话上下文]
BookingSpecialist: "Hi! I see you're looking to book for next weekend. What city?"

用户感觉是一通连续的电话。

Squad vs 单 assistant + 工具

FAQ

Q: 下一个 assistant 拿到对话历史吗？ A: 拿到 —— Squad 切换保留完整对话上下文，接管的 agent 不会重问已经问过的问题。也能用显式的 transferContext 把状态按你想要的格式汇总传递。

Q: Squad 能包含 Workflow 吗？ A: 能 —— Squad 成员可以是自由 assistant 或 Workflow。常见组合：Greeter 自由（处理寒暄），BookingSpecialist 是 Workflow（脚本化预订流）。

Q: 跟 Workflow 的 transfer 节点啥区别？ A: Workflow 的 transfer 是单向（把通话交给真人或另一个 assistant 后不再回来）。Squad 切换是双向 —— BookingSpecialist 完事可以交回 Greeter。Squad 有状态感知，Workflow transfer 是退出。