REALTIME VOICE / Microsoft
Azure AI Voice Live for Python
Pins Microsoft's Python Voice Live skill, which uses async Entra credentials and says not to pair this SDK with sync clients.
“Build real-time voice AI applications using Azure AI Voice Live SDK (azure-ai-voicelive). Use this skill when creating Python applications that need real-time bidirectional audio communication with Azure AI, including voice assistants, voice-enabled chatbots, real-time speech-to-speech translation, voice-driven avatars, or any WebSocket-based audio streaming with AI models. Supports Server VAD (Voice Activity Detection), turn-based conversation, function calling, MCP tools, avatar integration, and transcription.”
01 / THE REASONING
Why this made the selection.
- The file says the SDK is async-only and not to pair it with sync clients from other Azure SDKs in the same call path.
- It says new code should use DefaultAzureCredential, avoid API keys, and pass the Cognitive Services credential scope on the token connection.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- .github/plugins/azure-sdk-python/skills/azure-ai-voicelive-py/SKILL.md
- README.md
- .github/plugins/azure-sdk-python/README.md
- LICENSE
Our findings
- The file says to prefer DefaultAzureCredential and to avoid connection strings and API keys because they bypass Entra audit and rotation.
- It says production must set AZURE_TOKEN_CREDENTIALS to prod, or to one named credential, to constrain the credential chain.
- It says AzureKeyCredential is only for an existing keyed deployment that has not been migrated to Entra ID.
- The token sample passes credential scope https://cognitiveservices.azure.com/.default.
- It says the SDK is async-only and not to pair it with sync clients in the same call path.
Not established by this review
- The resource was not executed and its tools were not called.
- No Azure client was constructed and no credential was used.
- The linked reference files were not opened.
- The azure-sdk-python plugin was not installed.
- No WebSocket was opened and no audio was sent.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
/plugin install azure-sdk-python@skills Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The plugin README shows `/plugin install azure-sdk-python@skills`. That installs the azure-sdk-python plugin, not this one file.
- The same README also shows `npx skills add microsoft/skills --skill azure-sdk-python`.
- The repository README shows `npx skills add microsoft/skills`, which starts a wizard for the repository, and `/plugin install azure@skills` for a different plugin.
- The skill shows `pip install azure-ai-voicelive aiohttp azure-identity` for the SDK packages. That line was not run.
Before you start
- Python if the skill's pip line is run; this review did not run it
- An endpoint in AZURE_COGNITIVE_SERVICES_ENDPOINT
- Async DefaultAzureCredential for new code, or the legacy key only for an unmigrated keyed deployment
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-voicelive-py/SKILL.md
Supports: async-only refusal, Entra preference, and the Cognitive Services credential scope
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/README.md
Supports: /plugin install azure-sdk-python@skills installs the plugin, not one file
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: MIT statement, Copilot CLI plugin install, and a different azure plugin command
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-voicelive-py/SKILL.md
Supports: upstreamDescription, bestFor, review.notTested