[VoiceLive] Add support for built-in web search and file search tools by xitzhang · Pull Request #46723 · Azure/azure-sdk-for-python

xitzhang · 2026-05-05T18:18:37Z

Description

This PR promotes azure-ai-voicelive to 1.2.0 GA, consolidating all features from 1.2.0b1–b5
and adding new capabilities for API version 2026-04-10.

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.

…w features - Web Search & File Search support (ResponseWebSearchCallItem, ResponseFileSearchCallItem) - Avatar enhancements (voice sync, idle/speaking states, video delta, output buffer) - Transcription improvements (TranscriptionPhrase, TranscriptionWord, new models) - New SessionIncludeOption enum - Personal voice model updates (DragonHDOmniLatestNeural, MAI-Voice-1) - Fix ServerEvent.deserialize -> _deserialize for new model_base - Update tests for new models, enums, and breaking changes - Consolidate CHANGELOG for 1.2.0 GA release

xitzhang · 2026-05-05T18:20:11Z

/azp run
python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-05T18:20:29Z

Azure Pipelines successfully started running 1 pipeline(s).

Copilot

Pull request overview

This PR updates azure-ai-voicelive for the 1.2.0 GA release aligned to API version 2026-04-10, adding new VoiceLive models/enums (web/file search, avatar enhancements, transcription, telemetry) and adjusting tests/samples accordingly.

Changes:

Expanded the public model surface (new action/search models, new item/event types, new transcription/voice options) and updated exports/tests to match.
Updated package metadata/documentation for the 1.2.0 release (CHANGELOG, API version metadata, ApiView mappings).
Refactored/normalized telemetry + async client code paths and formatting in tests/samples.

Reviewed changes

Copilot reviewed 23 out of 24 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
sdk/voicelive/azure-ai-voicelive/tests/test_unit_voice_config.py	Updates unit tests to reflect new/removed personal voice model enums.
sdk/voicelive/azure-ai-voicelive/tests/test_unit_telemetry.py	Adds pylint suppression and formatting tweaks in telemetry unit tests.
sdk/voicelive/azure-ai-voicelive/tests/test_unit_smoke_validation.py	Extends import smoke test to include newly added enums/models.
sdk/voicelive/azure-ai-voicelive/tests/test_unit_models.py	Adds unit tests covering newly introduced action/search/transcription models.
sdk/voicelive/azure-ai-voicelive/tests/test_unit_enums.py	Adds assertions for newly added enum values and enums.
sdk/voicelive/azure-ai-voicelive/tests/test_live_realtime_service.py	Formatting-only changes in live async tests (no functional change indicated).
sdk/voicelive/azure-ai-voicelive/samples/basic_voice_assistant_async.py	Minor formatting/spacing tweaks in the sample.
sdk/voicelive/azure-ai-voicelive/pyproject.toml	Updates packaging metadata (dynamic version source, package discovery excludes, pytest config removal).
sdk/voicelive/azure-ai-voicelive/MANIFEST.in	Changes which `py.typed` marker is included in the sdist.
sdk/voicelive/azure-ai-voicelive/CHANGELOG.md	Promotes release section to `1.2.0 (Unreleased)` and documents new features/breaking changes.
sdk/voicelive/azure-ai-voicelive/azure/py.typed	Adds a top-level `azure/py.typed` marker file.
sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/telemetry/_voicelive_instrumentor.py	Formatting-only changes (line wrapping) in telemetry implementation.
sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/models/_enums.py	Adds new enums/enum values (voice type, event/item types, include options) and updates voice model enum set.
sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/models/init.py	Re-exports newly added models/enums in the public `models` namespace.
sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/aio/_patch.py	Updates server event deserialization call path.
sdk/voicelive/azure-ai-voicelive/azure/ai/voicelive/_version.py	Bumps library version to `1.2.0`.
sdk/voicelive/azure-ai-voicelive/azure/_version.py	Introduces a new top-level `azure._version` module (currently not aligned with 1.2.0).
sdk/voicelive/azure-ai-voicelive/azure/_utils/serialization.py	Adds generated serialization helper under `azure._utils` (appears duplicative).
sdk/voicelive/azure-ai-voicelive/azure/_utils/model_base.py	Adds generated model base helper under `azure._utils` (appears duplicative).
sdk/voicelive/azure-ai-voicelive/azure/_utils/init.py	Adds package init for the new `azure._utils` namespace.
sdk/voicelive/azure-ai-voicelive/azure/_types.py	Adds type aliases under top-level `azure._types`.
sdk/voicelive/azure-ai-voicelive/apiview-properties.json	Updates ApiView cross-language mappings for newly added types and enum entries.
sdk/voicelive/azure-ai-voicelive/_metadata.json	Updates default API version metadata to `2026-04-10`.

Comments suppressed due to low confidence (1)

sdk/voicelive/azure-ai-voicelive/azure/_version.py:10

azure/_version.py defines VERSION = "1.0.0b1", which does not match the package’s actual version (azure.ai.voicelive._version.VERSION is 1.2.0) and the PR’s GA release intent. If azure._version is used for packaging metadata, update it to the correct version; otherwise, remove it and avoid introducing a shared azure._version module into the global azure namespace.


VERSION = "1.0.0b1"

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

xitzhang · 2026-05-05T18:47:08Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-05T18:47:27Z

Azure Pipelines successfully started running 1 pipeline(s).

xitzhang · 2026-05-06T01:04:05Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-06T01:04:21Z

Azure Pipelines successfully started running 1 pipeline(s).

…-sdk-for-python into xitzhang/1.2.0change

xitzhang · 2026-05-15T02:39:23Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-15T02:39:37Z

Azure Pipelines successfully started running 1 pipeline(s).

xitzhang · 2026-05-15T18:50:27Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-15T18:50:43Z

Azure Pipelines successfully started running 1 pipeline(s).

xitzhang · 2026-05-15T18:57:31Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-15T18:57:47Z

Azure Pipelines successfully started running 1 pipeline(s).

xitzhang · 2026-05-15T19:19:01Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-15T19:19:17Z

Azure Pipelines successfully started running 1 pipeline(s).

xitzhang · 2026-05-15T19:47:23Z

/azp run python - azure-ai-voicelive - tests

azure-pipelines · 2026-05-15T19:47:38Z

Azure Pipelines successfully started running 1 pipeline(s).

Xiting Zhang added 2 commits May 5, 2026 11:09

Update version to 1.2.0 GA

723c5ca

Copilot AI review requested due to automatic review settings May 5, 2026 18:18

xitzhang requested review from amber-yujueWang, emilyjiji, pankopon and rhurey as code owners May 5, 2026 18:18

github-actions Bot added the Voice Live label May 5, 2026

Copilot started reviewing on behalf of xitzhang May 5, 2026 18:21 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

xitzhang and others added 3 commits May 5, 2026 11:36

Potential fix for pull request finding

a2dfd36

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

4c20f0d

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Potential fix for pull request finding

1c9dde8

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Azure deleted a comment from azure-pipelines Bot May 5, 2026

Xiting Zhang added 2 commits May 5, 2026 13:56

Fix azure/_version.py to 1.2.0 GA (was 1.0.0b1)

376059a

remove _version

2675906

xitzhang changed the title ~~[draft][VoiceLive] azure-ai-voicelive 1.2.0 GA release — API version 2026-04-10~~ [draft][VoiceLive] Added support for built-in web search and file search tools May 5, 2026

xitzhang changed the title ~~[draft][VoiceLive] Added support for built-in web search and file search tools~~ [draft][VoiceLive] Add support for built-in web search and file search tools May 5, 2026

Xiting Zhang added 5 commits May 5, 2026 14:28

Fix sphinx docstring formatting in ServerEventConversationItemCreated

19ae789

update cspell

5d70526

update cespell file

07e07d0

update status

68aa4b6

Remove unused conn_self param from _extract_send_event_ids

25c6fbd

Merge branch 'main' into xitzhang/1.2.0change

607cf6e

xitzhang and others added 5 commits May 13, 2026 11:20

Merge branch 'main' into xitzhang/1.2.0change

bfae8c3

Merge branch 'main' into xitzhang/1.2.0change

ea87cda

Merge branch 'xitzhang/1.2.0change' of https://github.com/Azure/azure…

444b236

…-sdk-for-python into xitzhang/1.2.0change

regenerate from typespec

031c619

Merge branch 'main' into xitzhang/1.2.0change

89787a7

Merge remote-tracking branch 'origin/main' into xitzhang/1.2.0change

273ffee

xitzhang changed the title ~~[draft][VoiceLive] Add support for built-in web search and file search tools~~ [VoiceLive] Add support for built-in web search and file search tools May 15, 2026

Update CHANGELOG.md

dfc20e7

fix bulletlist in docs

5618af5

Fix pylint implicit string concatenation in aio patch

d2cb9b6

xitzhang enabled auto-merge (squash) May 15, 2026 21:41

emilyjiji approved these changes May 15, 2026

View reviewed changes

xitzhang merged commit a3f900f into main May 15, 2026
29 checks passed

xitzhang deleted the xitzhang/1.2.0change branch May 15, 2026 22:13

Conversation

xitzhang commented May 5, 2026

Description

All SDK Contribution checklist:

General Guidelines and Best Practices

Testing Guidelines

Uh oh!

xitzhang commented May 5, 2026

Uh oh!

azure-pipelines Bot commented May 5, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

xitzhang commented May 5, 2026

Uh oh!

azure-pipelines Bot commented May 5, 2026

Uh oh!

xitzhang commented May 6, 2026

Uh oh!

azure-pipelines Bot commented May 6, 2026

Uh oh!

xitzhang commented May 15, 2026

Uh oh!

azure-pipelines Bot commented May 15, 2026

Uh oh!

xitzhang commented May 15, 2026

Uh oh!

azure-pipelines Bot commented May 15, 2026

Uh oh!

xitzhang commented May 15, 2026

Uh oh!

azure-pipelines Bot commented May 15, 2026

Uh oh!

xitzhang commented May 15, 2026

Uh oh!

azure-pipelines Bot commented May 15, 2026

Uh oh!

xitzhang commented May 15, 2026

Uh oh!

azure-pipelines Bot commented May 15, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants