voice live with agents quickstart

Author: eric-urban

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

@@ -9,7 +9,9 @@ ms.date: 7/31/2025
 ms.custom: references_regions
 ---
 
-In this article, you learn how to use voice live with generative AI 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 agents and Azure AI Speech in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs).
+
+[!INCLUDE [Introduction](intro.md)]
 
 ## Prerequisites
 

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

@@ -0,0 +1,19 @@
+---
+author: eric-urban
+ms.service: azure-ai-speech
+ms.topic: include
+ms.date: 7/31/2025
+ms.author: eur
+---
+
+You can create and run an application to use voice live with agents for real-time voice agents.
+
+- Using agents allows leveraging a built-in prompt and configuration managed within the agent itself, rather than specifying instructions in the session code. 
+
+- Agents encapsulate more complex logic and behaviors, making it easier to manage and update conversational flows without changing the client code. 
+
+- The agent approach streamlines integration. The agent ID is used to connect and all necessary settings are handled internally, reducing the need for manual configuration in the code. 
+
+- This separation also supports better maintainability and scalability for scenarios where multiple conversational experiences or business logic variations are needed.
+
+To instead use the voice live API without agents, see the [voice live quickstart](/azure/ai-services/speech-service/voice-live-quickstart).

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

@@ -7,6 +7,10 @@ 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. 
+
+[!INCLUDE [Introduction](intro.md)]
+
 ## Prerequisites
 
 - An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.

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

@@ -11,6 +11,8 @@ ms.custom: references_regions
 
 In this article, you learn how to use voice live with generative AI and Azure AI Speech 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>.

articles/ai-services/speech-service/includes/quickstarts/voice-live-api/intro.md

@@ -0,0 +1,19 @@
+---
+author: eric-urban
+ms.service: azure-ai-speech
+ms.topic: include
+ms.date: 7/31/2025
+ms.author: eur
+---
+
+You create and run an application to use voice live directly with generative AI models for real-time voice agents.
+
+- Using models directly allows specifying custom instructions (prompts) for each session, offering more flexibility for dynamic or experimental use cases.
+
+- Models may be preferable when you want fine-grained control over session parameters or need to frequently adjust the prompt or configuration without updating an agent in the portal.
+
+- The code for model-based sessions is simpler in some respects, as it does not require managing agent IDs or agent-specific setup.
+
+- Direct model use is suitable for scenarios where agent-level abstraction or built-in logic is unnecessary.
+
+To instead use the voice live API with agents, see the [voice live agents quickstart](/azure/ai-services/speech-service/voice-live-agents-quickstart).

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

@@ -7,6 +7,10 @@ ms.topic: include
 ms.date: 7/31/2025
 ---
 
+In this article, you learn how to use voice live with generative AI and Azure AI Speech using Python code. 
+
+[!INCLUDE [Introduction](intro.md)]
+
 ## Prerequisites
 
 - An Azure subscription. <a href="https://azure.microsoft.com/free/ai-services" target="_blank">Create one for free</a>.