edit pass: comm-services-samples-tutorials

Author: paulth1

articles/communication-services/how-tos/call-automation/handle-events-with-event-processor.md

@@ -31,7 +31,7 @@ By using event processor features, you can easily build robust applications that
 The Call Automation event processor first needs to consume events that were sent from the service. After the event arrives at the callback endpoint, pass the event to the event processor.
 
 > [!IMPORTANT]
-> Have you established a webhook callback events endpoint? The event processor still needs to consume callback events through a webhook callback. For information on how to establish webhook endpoints, see [Quickstart: Make an outbound call by using Call Automation](../../quickstarts/call-automation/quickstart-make-an-outbound-call.md).
+> Have you established a webhook callback events endpoint? The event processor still needs to consume callback events through a webhook callback. For information on how to establish webhook endpoints, see [Make an outbound call by using Call Automation](../../quickstarts/call-automation/quickstart-make-an-outbound-call.md).
 
 ```csharp
 using Azure.Communication.CallAutomation;
@@ -79,14 +79,14 @@ With the event processor, you can easily wait for the `CallConnected` event unti
 Now that the call is established, try to play some audio in the call, and then wait until the media plays.
 
 ```csharp
-// Play my prompt to everyone
+// Play my prompt to everyone.
 FileSource fileSource = new FileSource(playPrompt);
 PlayResult playResult = await callConnection.GetCallMedia().PlayToAllAsync(fileSource);
 
-// Wait for play to complete
+// Wait for play to complete.
 PlayEventResult playEventResult = await playResult.WaitForEventProcessorAsync();
 
-// Check if the play was completed successfully
+// Check if the play was completed successfully.
 if (playEventResult.IsSuccess)
 {
     // Success play!
@@ -100,7 +100,7 @@ else
 ```
 
 > [!WARNING]
-> The event processor uses `OperationContext` to track an event with its related request. If `OperationContext` wasn't set during the request, the event processor sets generated GUID to track future events to the request. If you set your own `OperationContext` during the request, the event processor still works, but we recommend that you set them differently from request to request. In this way, the event processor can distinguish the first request's event and the second request's event.
+> The event processor uses `OperationContext` to track an event with its related request. If `OperationContext` wasn't set during the request, the event processor sets generated GUID to track future events to the request. If you set `OperationContext` during the request, the event processor still works, but we recommend that you set them differently from request to request. In this way, the event processor can distinguish the first request's event and the second request's event.
 
 ## Handle events with the ongoing event processor
 
@@ -117,7 +117,7 @@ eventProcessor.AttachOngoingEventProcessor<ParticipantsUpdated>(callConnectionId
 });
 ```
 
-With this specific ongoing event processor, you can now print the number or participants or the participants on the call whenever people join or leave the call.
+With this specific ongoing event processor, you can now print the number of participants or the participants on the call whenever people join or leave the call.
 
 > [!TIP]
 > You can attach an ongoing handler to any event type. This capability opens the possibility to build your application with a callback design pattern.

articles/communication-services/samples/call-automation-ai.md

@@ -1,7 +1,7 @@
 ---
-title: Call Automation AI sample
+title: Call Automation AI Sample
 titleSuffix: An Azure Communication Services sample overview
-description: Overview of Call Automation AI hero sample using Azure Communication Services to enable developers to learn how to incorporate AI into their workflows.
+description: This Call Automation AI hero sample that uses Azure Communication Services enables developers to learn how to incorporate AI into their workflows.
 author: kpunjabi
 manager: visho
 services: azure-communication-services
@@ -16,11 +16,9 @@ zone_pivot_groups: acs-js-csharp-java-python
 
 # Get started with the Azure Communication Services Call Automation OpenAI sample
 
-The Azure Communication Services Call Automation OpenAI sample demonstrates how you can use Call Automation SDK and the recently announced public preview integration with Azure AI services to build intelligent virtual assistants.
-
-
-In this sample, we'll cover off what this sample does and what you need as pre-requisites before we run this sample locally on your machine. 
+The Azure Communication Services Call Automation OpenAI sample demonstrates how you can use the Call Automation SDK and the recently announced public preview integration with Azure AI services to build intelligent virtual assistants.
 
+In this article, we cover what this sample does and what you need as prerequisites before we run this sample locally on your machine.
 
 ::: zone pivot="programming-language-csharp"
 [!INCLUDE [Azure Communication Services Call Automation OpenAI C# sample](./includes/call-automation-ai-csharp.md)]

articles/communication-services/samples/call-automation-azure-openai-sample.md

@@ -1,7 +1,7 @@
 ---
-title: Call Automation AI sample
+title: Call Automation AI Sample
 titleSuffix: An Azure Communication Services sample showing how to integrate with Azure OpenAI
-description: Overview of Call Automation sample using Azure Communication Services to enable developers to learn how to incorporate Azure OpenAI voice model into their workflows.
+description: This Call Automation sample that uses Azure Communication Services shows developers how to incorporate an Azure OpenAI voice model into their workflows.
 author: kpunjabi
 services: azure-communication-services
 ms.author: kpunjabi
@@ -13,11 +13,11 @@ ms.custom: devx-track-extended-java, devx-track-js, devx-track-python, devx-trac
 zone_pivot_groups: acs-js-csharp
 ---
 
-# ACS Call Automation and Azure OpenAI Service
+# Call Automation and Azure OpenAI
 
-This sample application was demonstrated during Microsoft Ignite 2024. It highlights an integration of Azure Communication Services with Azure OpenAI Service to enable intelligent conversational agents.
+This sample application was demonstrated during Microsoft Ignite 2024. It highlights the integration of Azure Communication Services with Azure OpenAI to enable intelligent conversational agents.
 
-In this sample, we cover off what this sample does and what you need as prerequisites before we run this sample locally on your machine. 
+In this article, we cover what this sample does and what you need as prerequisites before we run the sample locally on your machine.
 
 ::: zone pivot="programming-language-csharp"
 [!INCLUDE [Azure Communication Services Call Automation Azure OpenAI C# sample](./includes/call-automation-azure-openai-csharp.md)]

articles/communication-services/samples/includes/call-automation-ai-csharp.md

@@ -1,6 +1,6 @@
 ---
-title: include file
-description: include file
+title: Include file
+description: Include file
 services: azure-communication-services
 manager: visho
 ms.service: azure-communication-services
@@ -11,32 +11,32 @@ ms.custom: include file
 ms.author: kpunjabi
 ---
 
-## Download code 
-Find the project for this sample on [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/callautomation-openai-sample-csharp). You can download this code and run it locally to try it for yourself. 
+## Download code
 
-## Overview 
+Find the project for this sample on [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/callautomation-openai-sample-csharp). You can download this code and run it locally to try it for yourself.
 
-This sample is a server-side application that helps you create a virtual assistant capable of handling calls using Call Automation and responding to customers using the newly announced integration with Azure AI services to provide AI capabilities such as Text-to-Speech and Speech-to-Text along with smart responses provided by Azure OpenAI. 
+## Overview
 
-This Azure Communication Services Call Automation AI sample demonstrates how to use the Call Automation SDK to answer an inbound call, recognizes user voice input using Call Automation recognize API with support for Speech-to-Text. Once input is recognized, it sends that information to OpenAI for an answer and plays the answer provided back by OpenAI to the caller using Call Automation play API with support for Text-to-Speech.
+This sample is a server-side application that helps you create a virtual assistant that can handle calls by using Call Automation. The virtual assistant responds to customers by using the newly announced integration with Azure AI services to provide AI capabilities such as text to speech and speech to text, along with smart responses provided by Azure OpenAI.
 
-## Prerequisites
+This Azure Communication Services Call Automation AI sample demonstrates how to use the Call Automation SDK to answer an inbound call. It recognizes user voice input by using Call Automation to recognize the API with support for speech to text. When the system recognizes the input, it sends that information to OpenAI for an answer. It uses the Call Automation Play API with support for text to speech to play back the answer provided by OpenAI to the caller.
 
-- Create an Azure account with an active subscription. For details, see [Create an account for free](https://azure.microsoft.com/free/)
-- Create an Azure Communication Services resource. For details, see [Create an Azure Communication Resource](../../quickstarts/create-communication-resource.md?tabs=windows&pivots=platform-azp). You need to record your resource **connection string** for this sample.
-- A Calling-enabled telephone number. [Get a phone number](../../quickstarts/telephony/get-phone-number.md).
-- Azure Dev Tunnels CLI. For details, see  [Enable dev tunnel](/azure/developer/dev-tunnels/get-started)
-- Create an Azure AI services resource. For details, see [Create an Azure AI services Resource](/azure/ai-services/multi-service-resource)
-- An Azure OpenAI Resource and Deployed Model. See [instructions](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal).
+## Prerequisites
 
+- An Azure account with an active subscription. For more information, see [Create an account for free](https://azure.microsoft.com/free/).
+- An Azure Communication Services resource. For more information, see [Create an Azure Communication Services resource](../../quickstarts/create-communication-resource.md?tabs=windows&pivots=platform-azp). You need to record your resource *connection string* for this sample.
+- A calling-enabled telephone number. For more information, see [Get a phone number](../../quickstarts/telephony/get-phone-number.md).
+- The Azure dev tunnel CLI. For more information, see [Enable dev tunnels](/azure/developer/dev-tunnels/get-started).
+- An Azure AI services resource. For more information, see [Create an Azure AI services resource](/azure/ai-services/multi-service-resource).
+- An Azure OpenAI resource and deployed model. For more information, see [Create an Azure OpenAI resource and deploy a model](/azure/ai-services/openai/how-to/create-resource?pivots=web-portal).
 
 ## Setup instructions
 
-Before running this sample, you need to set up the resources mentioned in the 'Prerequisites' section with the following configuration updates:
+Before you run this sample, you need to set up the resources mentioned in the preceding section with the following configuration updates.
 
-##### 1. Setup and host your Azure DevTunnel
+#### 1. Set up and host your dev tunnel
 
-[Azure DevTunnels](/azure/developer/dev-tunnels/overview) is an Azure service that enables you to share local web services hosted on the internet. Use the commands below to connect your local development environment to the public internet. This creates a tunnel with a persistent endpoint URL and which allows anonymous access. We'll then use this endpoint to notify your application of calling events from the Azure Communication Services Call Automation service.
+With [dev tunnels](/azure/developer/dev-tunnels/overview), you can share local web services that are hosted on the internet. Use the following commands to connect your local development environment to the public internet. This process creates a tunnel with a persistent endpoint URL and allows anonymous access. We use this endpoint to notify your application of calling events from Call Automation.
 
 ```bash
 devtunnel create --allow-anonymous
@@ -46,30 +46,31 @@ devtunnel host
 
 <a name='2-add-a-managed-identity-to-the-acs-resource-that-connects-to-the-cognitive-services-resource'></a>
 
-##### 2. Add a Managed Identity to the Azure Communication Services Resource that connects to the Azure AI services resource
-Follow the instructions in this [documentation](/azure/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration).
+#### 2. Add a managed identity to the Azure Communication Services resource that connects to the Azure AI services resource
 
-##### 3. Add the required API Keys and endpoints
-Open the appsettings.json file to configure the following settings:
+Follow the instructions in [Connect Azure Communication Services with Azure AI services](/azure/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration).
 
-- `DevTunnelUri`: your dev tunnel endpoint
-- `CognitiveServiceEndpoint`: The Azure AI services endpoint
-- `AcsConnectionString`: Azure Communication Service resource's connection string.
-- `AzureOpenAIServiceKey`: Azure OpenAI Service Key
-- `AzureOpenAIServiceEndpoint`: Azure OpenAI Service Endpoint
-- `AzureOpenAIDeploymentModelName`: Azure OpenAI Model name
+#### 3. Add the required API keys and endpoints
+
+Open the appsettings.json file to configure the following settings:
 
+- `DevTunnelUri`: Your dev tunnel endpoint.
+- `CognitiveServiceEndpoint`: Azure AI services endpoint.
+- `AcsConnectionString`: Azure Communication Services resource connection string.
+- `AzureOpenAIServiceKey`: Azure OpenAI service key.
+- `AzureOpenAIServiceEndpoint`: Azure OpenAI service endpoint.
+- `AzureOpenAIDeploymentModelName`: Azure OpenAI model name.
 
 ## Run the application
 
-1. Azure DevTunnel: Ensure your AzureDevTunnel URI is active and points to the correct port of your localhost application
-2. Run `dotnet run` to build and run the sample application
-3. Register an Event Grid Webhook for the IncomingCall Event that points to your DevTunnel URI. Instructions [here](/azure/communication-services/concepts/call-automation/incoming-call-notification).
+1. Ensure that your `AzureDevTunnel` URI is active and points to the correct port of your local host application.
+1. Run `dotnet run` to build and run the sample application.
+1. Register an Azure Event Grid webhook for the `IncomingCall` event that points to your `DevTunnel` URI. For more information, see [Incoming call concepts](/azure/communication-services/concepts/call-automation/incoming-call-notification).
 
+Now you have a running application. The best way to test this sample is to place a call to your Azure Communication Services phone number and talk to your intelligent agent.
 
-Once that's completed, you should have a running application. The best way to test this sample is to place a call to your Azure Communication Services phone number and talk to your intelligent agent.
+## Related content
 
-## Next steps
 - Learn more about [Call Automation](../../concepts/call-automation/call-automation.md).
 - Learn more about [playing custom messages](../../how-tos/call-automation/play-action.md).
 - Learn more about [recognizing user input](../../how-tos/call-automation/recognize-action.md).