adding details to connections section

Author: fosteramanda

articles/ai-services/agents/includes/acs/acs-setup.md

@@ -1,28 +1,37 @@
+---
+manager: nitinme
+author: fosteramanda
+ms.author: fosteramanda
+ms.service: azure
+ms.topic: include
+ms.date: 12/10/2024
+---
+
 ## Setup: Create an agent that can use an existing Azure AI Search index
 
-#### 1. Prerequisite: Have an existing Azure AI Search index
+#### Prerequisite: Have an existing Azure AI Search index
 A prerequisite of using the Azure AI Search tool is to have an existing Azure AI Search index. If you don't have an existing index, you can create one in the Azure portal or via REST API.
 -  [Quickstart: Create a vector index using the Azure portal](../../../../search/search-get-started-portal-import-vectors.md)
 - [Quickstart: Create a vector index using REST API](../../../../search/search-get-started-vector.md)
 
 
-#### 2. Complete the agent setup
-- **Option 1: Standard Agent Setup using existing AI Search resource** If you want your agent to use an existing AI Search resource to create new indexes or bring existing ones you should use the [standard agent setup and add your AI Search resource ID](../../quickstart.md). 
+#### Complete the agent setup
+- **Option 1: Standard Agent Setup using an existing AI Search resource** If you want your agent to use an existing AI Search resource to create new indexes or bring existing ones you should use the [standard agent setup and add your AI Search resource ID](../../quickstart.md). 
     - You can provide your Azure AI Search resource ID in the bicep file. Your resource ID should be in the format: `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}`.
 - **Option 2: Standard Agent Setup** If you want to create a new Azure AI Search resource for your agents to use when creating new indexes follow the [standard agent setup](../../quickstart.md).
 
 
-#### 3. Create a project connection to the Azure AI Search resource with the index you want to use
+#### Create a project connection to the Azure AI Search resource with the index you want to use
 If you already connected the AI Search resource that contains the index you want to use to your project, skip this step.
 
 ##### Get your Azure AI Search resource connection key and endpoint
-- Access your Azure AI Search resource.
+1. Access your Azure AI Search resource.
      - In the Azure portal, navigate to the AI Search resource that contains the index you want to use. 
-- Copy the connection endpoint.
+2. Copy the connection endpoint.
     - In the Overview tab, copy the URL of your resource. The URL should be in the format `https://<your-resource-name>.search.windows.net/`.
      :::image type="content" source="../../media/tools/ai-search/connection-endpoint.png" alt-text="A screenshot of an AI Search resource Overview tab in the Azure portal." lightbox="../../media/tools/ai-search/connection-endpoint.png":::
 
-- Verify API Acccess control is set to **Both** and copy one of the keys under **Manage admin keys**. 
+3. Verify API Acccess control is set to **Both** and copy one of the keys under **Manage admin keys**. 
     - From the left-hand navigation bar, scroll down to the Settings section and select **Keys**. 
     - Under the **API Access Control** section, ensure the option **Both** API key and Role-based access control is selected.
     - If you want the connection to use API Keys for authentication, copy one of the keys under **Manage admin keys**.
@@ -31,9 +40,8 @@ If you already connected the AI Search resource that contains the index you want
 ##### Create an Azure AI Search project connection
 
 # [Azure CLI](#tab/azurecli)
-```azurecli
-az ml connection create --file {connection.yml} --resource-group {my_resource_group} --workspace-name {my_hub_name}
-```
+**Create the following connections.yml file**
+
 
 You can use either an API key or credential-less YAML configuration file. For more information on the YAML configuration file, see the [Azure AI Search connection YAML schema](../../../../machine-learning/reference-yaml-connection-ai-search.md):
 - API Key example:
@@ -52,14 +60,20 @@ You can use either an API key or credential-less YAML configuration file. For mo
     type: azure_ai_search
     endpoint: https://contoso.search.windows.net/
     ```
+**Then, run the following command:**
 
+Replace ```my_resource``` and ```my_project_name``` with your resource group and project name created in the agent setup.
+```azurecli
+az ml connection create --file {connection.yml} --resource-group {my_resource_group} --workspace-name {my_project_name}
+```
 # [Python](#tab/pythonsdk)
+Replace the placeholders ```my_connection_name```, ```my_endpoint```, and ```my_key``` (optional)  with your Azure AI Search connection details and run the following code to create a project connection to your Azure AI Search resource.
 ```python
 from azure.ai.ml.entities import AzureAISearchConnection
 
-# constrict an Azure AI Search connection
-my_connection_name = "myaiservivce"
-my_endpoint = "demo.endpoint" # this could also be called target
+# create an Azure AI Search project connection
+my_connection_name = "my-acs-connection-name"
+my_endpoint = "my-acs-endpoint" # this could also be called target
 my_api_keys = None # leave blank for Authentication type = AAD
 
 my_connection = AzureAISearchConnection(name=my_connection_name,