[Do not merge][Debug] Preview for voiceagent

sdk/voiceagents/azure-ai-voiceagents/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Release History
+
+## 1.0.0b1 (2026-08-06)
+
+### Other Changes
+
+- Initial version

sdk/voiceagents/azure-ai-voiceagents/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) Microsoft Corporation.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sdk/voiceagents/azure-ai-voiceagents/MANIFEST.in

@@ -0,0 +1,7 @@
+include *.md
+include LICENSE
+include azure/ai/voiceagents/py.typed
+recursive-include tests *.py
+recursive-include samples *.py *.md
+include azure/__init__.py
+include azure/ai/__init__.py

sdk/voiceagents/azure-ai-voiceagents/README.md

@@ -0,0 +1,93 @@
+# Azure AI Voice Agents client library for Python
+
+The Azure AI Voice Agents client library provides APIs for creating and managing
+voice agents in an Azure AI Foundry project, reading persisted voice
+conversations, and connecting to a voice agent over a realtime WebSocket session.
+
+Use this package to:
+
+- Generate or create voice agents with model, instruction, voice, and tool settings.
+- Manage voice agent versions and operational state.
+- Stream live microphone audio to an existing voice agent and receive spoken responses.
+- Read persisted conversation transcripts and audio when an agent is configured to store them.
+
+## Getting started
+
+### Install the package
+
+```bash
+python -m pip install azure-ai-voiceagents
+```
+
+### Prerequisites
+
+- Python 3.10 or later is required to use this package.
+- You need an [Azure subscription][azure_sub].
+- You need an Azure AI Foundry project endpoint, for example
+  `https://<account>.services.ai.azure.com/api/projects/<project>`.
+- For Microsoft Entra ID authentication, install [`azure-identity`][azure_identity_pip].
+- For realtime async WebSocket sessions, install an async transport such as `aiohttp`.
+
+### Authenticate the client
+
+The client supports token credentials from the
+[`azure-identity`][azure_identity_credentials] library. For example,
+[`DefaultAzureCredential`][default_azure_credential] can authenticate from your
+developer environment or configured application identity.
+
+```python
+from azure.ai.voiceagents import VoiceAgentsClient
+from azure.identity import DefaultAzureCredential
+
+client = VoiceAgentsClient(
+    endpoint="https://<account>.services.ai.azure.com/api/projects/<project>",
+    credential=DefaultAzureCredential(),
+)
+```
+
+## Examples
+
+Create a voice agents client and list the voice agents in a project:
+
+```python
+from azure.ai.voiceagents import VoiceAgentsClient
+from azure.ai.voiceagents.models import AgentDefinitionOptInKeys
+from azure.identity import DefaultAzureCredential
+
+client = VoiceAgentsClient(
+    endpoint="https://<account>.services.ai.azure.com/api/projects/<project>",
+    credential=DefaultAzureCredential(),
+)
+
+for agent in client.voice_agents.list_voice_agents(
+    foundry_features=AgentDefinitionOptInKeys.VOICE_AGENTS_V1_PREVIEW
+):
+    print(agent.name)
+```
+
+See the [samples](samples/README.md) directory for management, quickstart, and
+realtime conversation examples.
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require
+you to agree to a Contributor License Agreement (CLA) declaring that you have
+the right to, and actually do, grant us the rights to use your contribution.
+For details, visit <https://cla.microsoft.com>.
+
+When you submit a pull request, a CLA-bot will automatically determine whether
+you need to provide a CLA and decorate the PR appropriately (e.g., label,
+comment). Simply follow the instructions provided by the bot. You will only
+need to do this once across all repos using our CLA.
+
+This project has adopted the
+[Microsoft Open Source Code of Conduct][code_of_conduct]. For more information,
+see the Code of Conduct FAQ or contact <opencode@microsoft.com> with any
+additional questions or comments.
+
+<!-- LINKS -->
+[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
+[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credentials
+[azure_identity_pip]: https://pypi.org/project/azure-identity/
+[default_azure_credential]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#defaultazurecredential
+[azure_sub]: https://azure.microsoft.com/free/

sdk/voiceagents/azure-ai-voiceagents/_metadata.json

@@ -0,0 +1,6 @@
+{
+  "apiVersion": "v1",
+  "apiVersions": {
+    "Azure.AI.Projects": "v1"
+  }
+}