RAG quickstart updates

Author: HeidiSteen

Quickstart-RAG/Quickstart-rag.ipynb

@@ -6,7 +6,7 @@
    "source": [
     "# RAG Quickstart for Azure AI Search\n",
     "\n",
-    "This quickstart provides a query for RAG scenarios. It demonstrates a approach for grounding chat queries with data in a search index on Azure AI Search.\n",
+    "This quickstart provides a query for RAG scenarios. It demonstrates an approach for grounding chat queries with data in a search index on Azure AI Search.\n",
     "\n",
     "We took a few shortcuts to keep the exercise basic and focused on query definitions:\n",
     "\n",
@@ -24,23 +24,13 @@
    "source": [
     "## Prerequisites\n",
     "\n",
-    "- Azure AI Search, any tier\n",
+    "- Azure AI Search, Basic tier or higher is recommended. Enable semantic ranking and role-based access control.\n",
     "\n",
-    "- Azure OpenAI, in the same region as Azure AI Search\n",
+    "- Azure OpenAI, in the same region as Azure AI Search. Configure Azure OpenAI to use a system managed identity.\n",
     "\n",
-    "- Deployment GPT-3.5-Turbo, GPT-4, or equivalent LLM\n",
+    "- Deployment GPT-3.5-Turbo, GPT-4, or equivalent LLM.\n",
     "\n",
-    "### Configuration requirements\n",
-    "\n",
-    "Use the Azure portal for these steps.\n",
-    "\n",
-    "1. Configure Azure OpenAI to use a system-assigned managed identity.\n",
-    "\n",
-    "1. Configure Azure AI Search to use a system-assigned managed identity.\n",
-    "\n",
-    "1. Create the hotels-sample-index using the Import data wizard.\n",
-    "\n",
-    "1. Add a semantic configuration named \"semantic-config\" and make it the default configuration:\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",
     "  \n",
     "    ```json\n",
     "    \"semantic\": {\n",
@@ -58,14 +48,14 @@
     "       }]},\n",
     "    ```\n",
     "\n",
-    "1. On Azure AI Search, create a role assignment for the Azure OpenAI managed identity. Required roles: Search Index Data Reader, Search Service Contributor.\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",
-    "1. On Azure OpenAI, create a role assigmnet for the user running the code: Required role: Cognitive Services OpenAI User."
+    "- On Azure OpenAI, create a role assigmnet for the user running the code: Required role: Cognitive Services OpenAI User."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -77,7 +67,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -89,7 +79,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -102,11 +92,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Set up the query for generating responses\n",
+    "# Set up the clients, define a chat instance, create a search function\n",
     "from azure.core.credentials_async import AsyncTokenCredential\n",
     "from azure.identity.aio import get_bearer_token_provider\n",
     "from azure.search.documents.aio import SearchClient\n",
@@ -131,7 +121,7 @@
     "        credential=credential\n",
     "    )\n",
     "\n",
-    "# This quickstart is only using text at the moment\n",
+    "# This quickstart is only using text at this time\n",
     "class SearchType(Enum):\n",
     "    TEXT = \"text\"\n",
     "    VECTOR = \"vector\"\n",
@@ -197,24 +187,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Based on your request, here are a few hotel recommendations with beach access and good views:\n",
-      "\n",
-      "1. Ocean Air Motel - oceanfront hotel with a private balcony and indoor and outdoor pools\n",
-      "2. Marquis Plaza & Suites - offers a view, free Wi-Fi, and a pool\n",
-      "3. Pull'r Inn Motel - offers a view, a pool, and free Wi-Fi\n",
-      "\n",
-      "I hope this helps! Let me know if you need any further assistance.\n"
-     ]
-    }
-   ],
+   "outputs": [],
    "source": [
+    "# Instantiate the chat thread and run the conversation\n",
     "import azure.identity.aio\n",
     "\n",
     "chat_thread = ChatThread()\n",