voice live with agents quickstart

Author: eric-urban

articles/ai-services/speech-service/includes/quickstarts/voice-live-agents/ai-foundry.md

@@ -9,14 +9,15 @@ ms.date: 7/31/2025
 ms.custom: references_regions
 ---
 
-In this article, you learn how to use voice live with agents and Azure AI Speech in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs).
+In this article, you learn how to use voice live with [Azure AI Foundry Agent Service](/azure/ai-foundry/agents/overview) and [Azure AI Speech](/azure/ai-services/speech-service/overview) in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs).
 
 [!INCLUDE [Introduction](intro.md)]
 
 ## Prerequisites
 
 - An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.
 - An [Azure AI Foundry resource](../../../../multi-service-resource.md) created in one of the supported regions. For more information about region availability, see the [Voice Live API overview documentation](../../../voice-live.md).
+- An Azure AI Foundry agent created in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs). For more information about creating an agent, see the [Create an agent quickstart](/azure/ai-foundry/agents/quickstart).
 
 > [!TIP]
 > To use voice live, you don't need to deploy an audio model with your Azure AI Foundry resource. Voice live is fully managed, and the model is automatically deployed for you. For more information about models availability, see the [voice live overview documentation](../../../voice-live.md).

articles/ai-services/speech-service/includes/quickstarts/voice-live-agents/python.md

@@ -7,7 +7,7 @@ ms.topic: include
 ms.date: 7/31/2025
 ---
 
-In this article, you learn how to use voice live with agents and Azure AI Speech using Python code. 
+In this article, you learn how to use voice live with [Azure AI Foundry Agent Service](/azure/ai-foundry/agents/overview) and [Azure AI Speech](/azure/ai-services/speech-service/overview) using Python code. 
 
 [!INCLUDE [Introduction](intro.md)]
 
@@ -16,6 +16,7 @@ In this article, you learn how to use voice live with agents and Azure AI Speech
 - An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.
 - <a href="https://www.python.org/" target="_blank">Python 3.8 or later version</a>. We recommend using Python 3.10 or later, but having at least Python 3.8 is required. If you don't have a suitable version of Python installed, you can follow the instructions in the [VS Code Python Tutorial](https://code.visualstudio.com/docs/python/python-tutorial#_install-a-python-interpreter) for the easiest way of installing Python on your operating system.
 - An [Azure AI Foundry resource](../../../../multi-service-resource.md) created in one of the supported regions. For more information about region availability, see the [Voice Live API overview documentation](../../../voice-live.md).
+- An Azure AI Foundry agent created in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs). For more information about creating an agent, see the [Create an agent quickstart](/azure/ai-foundry/agents/quickstart).
 
 > [!TIP]
 > To use voice live, you don't need to deploy an audio model with your Azure AI Foundry resource. Voice live is fully managed, and the model is automatically deployed for you. For more information about models availability, see the [voice live overview documentation](../../../voice-live.md).
@@ -136,13 +137,11 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
     async def main() -> None:
         # Set environment variables or edit the corresponding values here.
         endpoint = os.environ.get("AZURE_VOICE_LIVE_ENDPOINT") or "https://contoso-proj-agentic-foundry-res.cognitiveservices.azure.com/"
+        agent_id = os.environ.get("AI_FOUNDRY_AGENT_ID") or "your-agent-id"
+        project_name = os.environ.get("AI_FOUNDRY_PROJECT_NAME") or "your-project-name"
         api_version = os.environ.get("AZURE_VOICE_LIVE_API_VERSION") or "2025-05-01-preview"
         api_key = os.environ.get("AZURE_VOICE_LIVE_API_KEY") or "your_api_key"
         
-        # Agent-specific configuration for Azure AI Foundry projects
-        agent_id = os.environ.get("AI_FOUNDRY_AGENT_ID") or "your-agent-id"
-        project_name = os.environ.get("AI_FOUNDRY_PROJECT_NAME") or "your-project-name"
-    
         # For the recommended keyless authentication, get and
         # use the Microsoft Entra token instead of api_key:
         scopes = "https://ai.azure.com/.default"

articles/ai-services/speech-service/includes/quickstarts/voice-live-agents/resource-authentication.md

@@ -11,6 +11,7 @@ Create a new file named `.env` in the folder where you want to run the code.
 In the `.env` file, add the following environment variables for authentication:
 
 ```plaintext
+AZURE_VOICE_LIVE_ENDPOINT=<your_endpoint>
 AI_FOUNDRY_PROJECT_NAME=<your_project_name>
 AI_FOUNDRY_AGENT_ID=<your_agent_id>
 AZURE_VOICE_LIVE_API_VERSION=2025-05-01-preview
@@ -23,6 +24,7 @@ Replace the default values with your actual project name, agent ID, API version,
 
 |Variable name | Value |
 |--------------------------|-------------|
+| `AZURE_VOICE_LIVE_ENDPOINT` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. |
 | `AI_FOUNDRY_PROJECT_NAME` | The name of your Azure AI Foundry project. |
 | `AI_FOUNDRY_AGENT_ID` | The ID of your Azure AI Foundry agent. |
 | `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-05-01-preview`. |
@@ -33,6 +35,7 @@ Learn more about [keyless authentication](/azure/ai-services/authentication) and
 
 |Variable name | Value |
 |--------------------------|-------------|
+| `AZURE_VOICE_LIVE_ENDPOINT` | This value can be found in the **Keys and Endpoint** section when examining your resource from the Azure portal. |
 | `AI_FOUNDRY_PROJECT_NAME` | The name of your Azure AI Foundry project. |
 | `AI_FOUNDRY_AGENT_ID` | The ID of your Azure AI Foundry agent. |
 | `AZURE_VOICE_LIVE_API_VERSION`| The API version you want to use. For example, `2025-05-01-preview`. |

articles/ai-services/speech-service/toc.yml

@@ -240,7 +240,7 @@ items:
       href: voice-live.md
     - name: Voice live quickstart
       href: voice-live-quickstart.md
-    - name: Voice live agents quickstart
+    - name: Voice live with Foundry agents quickstart
       href: voice-live-agents-quickstart.md
     - name: How to use voice live
       href: voice-live-how-to.md

articles/ai-services/speech-service/voice-live-agents-quickstart.md

@@ -1,5 +1,5 @@
 ---
-title: 'How to use voice live with agents for real-time voice agents with Azure AI Speech'
+title: Get started with Azure AI Speech voice live and Azure AI Foundry Agent Service
 titleSuffix: Azure AI services
 description: Learn how to use voice live with agents for real-time voice agents with Azure AI Speech.
 manager: nitinme
@@ -13,7 +13,7 @@ ms.custom: build-2025
 recommendations: false
 ---
 
-# Quickstart: Voice live with agents quickstart (Preview)
+# Quickstart: Create a voice live real-time voice agent with Azure AI Foundry Agent Service (Preview)
 
 [!INCLUDE [Feature preview](./includes/previews/preview-generic.md)]
 

articles/ai-services/speech-service/voice-live-quickstart.md

@@ -1,5 +1,5 @@
 ---
-title: 'How to use voice live API for real-time voice agents with Azure AI Speech'
+title: Get started with Azure AI Speech voice live for real-time voice agents
 titleSuffix: Azure AI services
 description: Learn how to use voice live API for real-time voice agents with Azure AI Speech.
 manager: nitinme
@@ -13,7 +13,7 @@ ms.custom: build-2025
 recommendations: false
 ---
 
-# Quickstart: Voice live API for real-time voice agents (Preview)
+# Quickstart: Create a voice live real-time voice agent (Preview)
 
 [!INCLUDE [Feature preview](./includes/previews/preview-generic.md)]