v1 voiceagents

[xitzhang]

Description

Please add an informative description that covers that changes made by the pull request and link all relevant issues.

If an SDK is being regenerated based on a new API spec, a link to the pull request containing these API spec changes should be included above.

All SDK Contribution checklist:

• The pull request does not introduce [breaking changes]
• CHANGELOG is updated for new features, bug fixes or other significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title of the pull request is clear and informative.
• There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

• Pull request includes test coverage for the included changes.

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).
9 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

Pull request overview

Regenerates the VoiceLive SDK model surface for the v1 Voice Agents API.

Changes:

• Reworks public models, enums, unions, and APIView mappings.
• Adds v1 audio, MCP, realtime, and RTC types.
• Updates package and generation metadata.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
pyproject.toml	Changes package classifier to Beta.
models/_enums.py	Replaces and expands protocol enums.
models/__init__.py	Updates public model exports.
_utils/model_base.py	Clarifies mapping-method documentation.
_unions.py	Defines new v1 model unions.
apiview-properties.json	Updates cross-language API mappings.
_metadata.json	Changes the generated API-version metadata.

[github-actions]

[Pilot] PR Pipeline Failure Analysis

A CI pipeline failed on this pull request. Here is an automated analysis of what went wrong and how to get the build green.

What failed

The azure-ai-voicelive package failed three categories of checks in build 6630196:

1. Validation — sphinx check (FAIL): Sphinx could not import azure.ai.voicelive.aio or azure.ai.voicelive.telemetry because:

   • aio/_patch.py tries to import ClientEventConversationItemCreate from models._models — name not found in the installed wheel.
   • telemetry/_voicelive_instrumentor.py tries to import ClientEventType from models._enums — name not found in the installed wheel.

2. Validation — apistub check (FAIL): Same root cause — apiview-stub-generator failed to import the package due to the missing ClientEventConversationItemCreate symbol.

3. Tests (FAIL): All test suites (tests.live.* and tests.unit.*) failed across every platform (macOS, Ubuntu 24.04, Windows 2022) in all install modes (whl, mindependency, sdist). This is almost certainly a downstream consequence of the same import error — the package cannot be imported at all, so every test errors on collection.

Root cause: The handwritten patch files (aio/_patch.py and telemetry/_voicelive_instrumentor.py) reference model/enum symbols (ClientEventConversationItemCreate, ClientEventType) that no longer exist in models/_models.py and models/_enums.py — likely removed or renamed in this PR's changes to those files.

Recommended next steps

• In sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/aio/_patch.py, update the import of ClientEventConversationItemCreate to use the correct current class name from models/_models.py (or add the class back if it was accidentally dropped).
• In sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/telemetry/_voicelive_instrumentor.py, update the import of ClientEventType to use the correct current enum name from models/_enums.py.
• Verify that models/__init__.py exports all symbols referenced by the patch and telemetry files.
• After fixing the imports, run azpysdk sphinx . and azpysdk apistub . locally from the package directory to confirm both checks pass before pushing.
• See the CI troubleshooting guide: https://aka.ms/ci-fix
• Push new commits to address the failures; this comment updates automatically on the next failing run.

Raw pipeline analysis (azsdk ci analyze)

Analyzing pipeline https://github.com/Azure/azure-sdk-for-python/pull/48312...
--------------------------------------------------------------------------------
Failed Tests
--------------------------------------------------------------------------------
All test suites failed across all platforms:
  tests.live.test_live_realtime_audio
  tests.live.test_live_realtime_avatar
  tests.live.test_live_realtime_basic
  tests.live.test_live_realtime_lifecycle
  tests.live.test_live_realtime_tools
  tests.live.test_live_realtime_transcription
  tests.live.test_live_realtime_turn_detection
  tests.unit.test_unit_client_events
  tests.unit.test_unit_connection
  tests.unit.test_unit_enums
  tests.unit.test_unit_integration
  tests.unit.test_unit_message_handling
  tests.unit.test_unit_models
  tests.unit.test_unit_models_interim_response_foundry
  tests.unit.test_unit_serialization
(Failed on: macos311, Ubuntu2404_313, ubuntu2404_310, ubuntu2404_310_coverage,
 Ubuntu2404_314, windows2022_312 — whl, mindependency, and sdist installs)

--------------------------------------------------------------------------------
Failed Tasks
--------------------------------------------------------------------------------
[sphinx] FAIL(1) in 35.72s
  ImportError: cannot import name 'ClientEventConversationItemCreate' from
  'azure.ai.voicelive.models._models'
  (raised from aio/_patch.py line 28)

  ImportError: cannot import name 'ClientEventType' from
  'azure.ai.voicelive.models._enums'
  (raised from telemetry/_voicelive_instrumentor.py line 20)

[apistub] FAIL(1) in 26.51s
  ImportError: cannot import name 'ClientEventConversationItemCreate' from
  'azure.ai.voicelive.models._models'
  (raised from aio/_patch.py line 28)

Pipeline: https://dev.azure.com/azure-sdk/public/_build/results?buildId=6630196

Copilot detected the failing pipeline and generated the analysis above. To have it attempt a fix automatically, reply with @copilot please fix the failing pipeline on this PR.

Generated by Pipeline Analysis - Next Steps · 42.8 AIC · ⌖ 8.87 AIC · ⊞ 6.6K · ◷