Hi, I’m setting up a Squad in VAPI and running into a few questions. I want a dispatcher to work with multiple sub-agents, but I want the whole squad to sound like one single agent to the end user — so no “let me transfer you to…” or any obvious handoffs. I’d love to hear your best practices on: - Keeping all sub-agents aligned in voice/personality, so everything feels seamless. - Setting up good collaboration between dispatcher and sub-agents: When should the dispatcher answer something directly, and when should it delegate? - Making sure a sub-agent can hand results back to the dispatcher without it being noticeable to the user. - Useful settings or configurations (e.g., “agent/user speaks first,” role setup, prompt structure, etc.). Any example prompts or templates you use to make a squad behave like one unified agent. Any tips, examples, or “gotchas” are more than welcome! Thanks! 🙌

Best Practice: Unified System Prompt for Seamless Handoffs To keep your squad sounding like a single agent, use a system prompt like this for all assistants:

text
You are part of a multi-agent system designed to make agent coordination and execution easy. Handoffs between agents are handled seamlessly in the background; do not mention or draw attention to these handoffs in your conversation with the user. Always maintain a consistent voice and personality.

This ensures sub-agents never reveal transfers, keeping the experience unified and natural for the user. For more, see the [handoff tool documentation](https://docs.vapi.ai/tools/handoff#system-prompt-best-practices). Source: - [Handoff Tool Documentation](https://docs.vapi.ai/tools/handoff)

Message marked as helpful by @martyvandeveerdonk! 🎉

should it be added to each of the squad assistants? or just the router?

Each assistant would be most effective.

Working with Squads doing having issues once one assistant gets updated (the squad somehow is not getting updated properly and the whole squad experience is broken during conversations) so i was thinking to add it to each of the assistants as you suggested and to add for each of the assistant a proper handoff tool instead of working under Squads.. what's your take about it?

I would still stick with the squad configuration, but edit the assistant prompt of each member assistant so that it works in a seamless flow. The handoff tools still should be present in the squad config. Also recommend reviewing the documentation pages on best practices and squad example configs