Updates to prerequisites

Author: HeidiSteen

Quickstart-RAG/Quickstart-rag.ipynb

@@ -25,13 +25,33 @@
    "source": [
     "## Prerequisites\n",
     "\n",
-    "- Azure AI Search, Basic tier or higher is recommended. Enable semantic ranking and role-based access control.\n",
+    "- [Azure OpenAI](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource)\n",
     "\n",
-    "- Azure OpenAI, in the same region as Azure AI Search. Configure Azure OpenAI to use a system managed identity.\n",
+    "  - Configure Azure OpenAI to use a system managed identity.\n",
+    "  - Deploy a chat model (GPT-3.5-Turbo, GPT-4, or equivalent LLM).\n",
     "\n",
-    "- Deployment GPT-3.5-Turbo, GPT-4, or equivalent LLM.\n",
+    "- [Azure AI Search](https://learn.microsoft.com/azure/search/search-create-service-portal)\n",
     "\n",
-    "- Create the hotels-sample-index using [this quickstart](https://learn.microsoft.com/azure/search/search-get-started-portal), and then modify it to use this semantic configuration:\n",
+    "  - Basic tier or higher is recommended.\n",
+    "  - Choose the same region as Azure OpenAI.\n",
+    "  - Enable semantic ranking.\n",
+    "  - Enable role-based access control.\n",
+    "\n",
+    "## Configure access\n",
+    "\n",
+    "This quickstart assumes authentication and authorization using Microsoft Entra ID and role assignments. It also assumes that you run this code from your local device.\n",
+    "\n",
+    "- On Azure AI Search, create a role assignment for the Azure OpenAI system managed identity. Required roles: **Search Index Data Reader**, **Search Service Contributor**.\n",
+    "\n",
+    "- Make sure you also have a role assignment that gives you permissions to create and query objects: Required roles: **Search Index Data Reader**, **Search Index Data Contributor**, **Search Service Contributor**.\n",
+    "\n",
+    "- On Azure OpenAI, create a role assigment for yourself to send requests from your local device: Required role: **Cognitive Services OpenAI User**.\n",
+    "\n",
+    "## Create the sample index\n",
+    "\n",
+    "This quickstart assumes the hotels-sample-index, which you can create in minutes using [this quickstart](https://learn.microsoft.com/azure/search/search-get-started-portal).\n",
+    "\n",
+    "Once the index exists, modify it in the Azure portal to use this semantic configuration:\n",
     "  \n",
     "    ```json\n",
     "    \"semantic\": {\n",
@@ -49,9 +69,7 @@
     "       }]},\n",
     "    ```\n",
     "\n",
-    "- On Azure AI Search, create a role assignment for the Azure OpenAI managed identity. Required roles: **Search Index Data Reader**, **Search Service Contributor**.\n",
-    "\n",
-    "- On Azure OpenAI, create a role assigment for the user running the code: Required role: **Cognitive Services OpenAI User**."
+    "Now that you have your Azure resources, an index, and model in place, you can run the script to chat with the index."
    ]
   },
   {