voice-agent
Installation
SKILL.md
Zoom AI Services Voice Agent
Use Voice Agent for an interactive microphone conversation where the service transcribes speech, runs an AI turn, and streams spoken or text output in real time.
Current API audit: The V2 route, session shape, event stream, and error recovery below were verified against the official sample and live connections on 2026-10-20. The documented V1 surface was verified on the same /v2/ws/ route with a different subprotocol and body.
Routing Guardrail
- Real-time microphone conversation → use this skill.
- One uploaded audio/video file needs transcript plus summary → use Speech Summarization.
- Live meeting audio/video with meeting metadata → use RTMS.
- One-shot transcription only → use Scribe.
- Existing transcript text → use Summarizer.
- Typed classification or routing → use Decisions.
Match the session body to the subprotocol: V2 uses listen / think / speak, while the documented V1 surface uses OpenAI-style audio.input / audio.output. A mismatch returns error.code = shape_switch_not_allowed.