Merge pull request #281814 from HeidiSteen/heidist-freshness

Added transitions

Author: prmerger-automator[bot]

articles/search/search-get-started-rag.md

@@ -47,16 +47,16 @@ Requests to the search endpoint must be authenticated and authorized. You can us
 
     1. On the left menu, select **Settings** > **Keys**, and then select either **Role-based access control** or **Both**.
 
-    1. On the left menu, select **Access control (IAM)**.
-
 1. Assign roles:
 
+    1. On the left menu, select **Access control (IAM)**.
+
     1. On Azure AI Search, add two role assignments for the Azure OpenAI managed identity: 
 
        - **Search Index Data Reader**
        - **Search Service Contributor**
 
-    1. On Azure OpenAI, assign yourself to a role. The code for this quickstart runs locally. Requests to Azure OpenAI originate from your system: 
+    1. On Azure OpenAI, select **Access control (IAM)** to assign yourself to a role. The code for this quickstart runs locally. Requests to Azure OpenAI originate from your system: 
 
        - **Cognitive Services OpenAI User**
 
@@ -115,8 +115,32 @@ We recommend the hotels-sample-index, which can be created in minutes and runs o
 
 1. Run the following query to test your index: `hotels near the ocean with beach access and good views`.
 
+   Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranking.
+
+   ```
+         "@search.score": 5.600783,
+      "@search.rerankerScore": 2.4191176891326904,
+      "@search.captions": [
+        {
+          "text": "Ocean Breeze Motel. Budget. pool\r\nair conditioning\r\nbar. Oceanfront hotel overlooking the beach features rooms with a private balcony and 2 indoor and outdoor pools. Various shops and art entertainment are on the boardwalk, just steps away..",
+          "highlights": "Ocean Breeze Motel. Budget.<em> pool\r\nair conditioning\r\nbar. O</em>ceanfront hotel overlooking the beach features rooms with a private balcony and 2 indoor and outdoor pools. Various shops and art entertainment are on the boardwalk, just steps away."
+        }
+      ],
+      "HotelId": "41",
+      "HotelName": "Ocean Breeze Motel",
+      "Description": "Oceanfront hotel overlooking the beach features rooms with a private balcony and 2 indoor and outdoor pools. Various shops and art entertainment are on the boardwalk, just steps away.",
+      "Category": "Budget",
+      "Tags": [
+        "pool",
+        "air conditioning",
+        "bar"
+      ],
+   ```
+
 ## Get service endpoints
 
+In the remaining sections, you set up API calls to Azure OpenAI and Azure AI Search. Get the service endpoints so that you can provide them as variables in your code.
+
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
 1. [Find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
@@ -129,7 +153,9 @@ We recommend the hotels-sample-index, which can be created in minutes and runs o
 
 ## Set up the query and chat thread
 
-This section uses Visual Studio Code and Python to call the chat APIs on Azure OpenAI.
+This section uses Visual Studio Code and Python to call the chat completion APIs on Azure OpenAI.
+
+1. Start Visual Studio Code and [open the .ipynb file](https://github.com/Azure-Samples/azure-search-python-samples/tree/main/Quickstart-RAG) or create a new Python file.
 
 1. Install the following Python packages.