Merge pull request #104 from HeidiSteen/main

updated an import statement for the semantic quickstart notebook

Author: HeidiSteen

Quickstart-Semantic-Search/semantic-search-quickstart.ipynb

@@ -22,8 +22,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Uncomment the next line if you need to install the azure-search-documents client library:\n",
-    "%pip install azure-search-documents --pre\n",
+    "# Import the libraries needed to create a search index, upload documents, and query the index\n",
+    "%pip install azure-search-documents\n",
     "%pip show azure-search-documents\n",
     "%pip install python-dotenv\n",
     "\n",
@@ -33,7 +33,6 @@
     "from azure.search.documents import SearchClient\n",
     "from azure.search.documents.indexes.models import (  \n",
     "    SearchIndex,  \n",
-    "    SearchField,  \n",
     "    SearchFieldDataType,  \n",
     "    SimpleField,  \n",
     "    SearchableField,\n",
@@ -83,7 +82,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "In the third cell, the index \"hotels-quickstart\" will be deleted if it previously existed."
+    "In the next cell, the index \"hotels-quickstart\" will be deleted if it previously existed. This step allows you to reuse the index name."
    ]
   },
   {
@@ -156,7 +155,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Formulate the create_index request. This request targets the indexes collection of your search service and creates an index based on the index schema you provided in the previous cell."
+    "Formulate the create_index request. This request targets the indexes collection of your search service and creates an index using the index schema from the previous cell."
    ]
   },
   {
@@ -184,7 +183,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Next, provide four documents that conform to the index schema. Specify an upload action for each document."
+    "Next, set up documents to include four hotel documents conforming to the schema."
    ]
   },
   {
@@ -278,7 +277,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Formulate the request. This upload_documents request targets the docs collection of the hotels-quickstart index and pushes the documents provided in the previous step into the search index."
+    "Formulate the request. This upload_documents request targets the docs collection of the hotels-quickstart index and pushes the documents from the previous step into the search index."
    ]
   },
   {
@@ -299,7 +298,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "You are now ready to run some queries. For this operation, use search_client.  \n",
+    "You're now ready to run some queries. For this operation, use search_client.  \n",
     "\n",
     "### Empty query with unscored results\n",
     "\n",
@@ -366,7 +365,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "results =  search_client.search(query_type='semantic', query_language='en-us', semantic_configuration_name='my-semantic-config',\n",
+    "results =  search_client.search(query_type='semantic', semantic_configuration_name='my-semantic-config',\n",
     "    search_text=\"what hotel has a good restaurant on site\", \n",
     "    select='HotelName,Description,Category', query_caption='extractive')\n",
     "\n",
@@ -400,7 +399,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "results =  search_client.search(query_type='semantic', query_language='en-us', semantic_configuration_name='my-semantic-config',\n",
+    "results =  search_client.search(query_type='semantic', semantic_configuration_name='my-semantic-config',\n",
     "    search_text=\"what hotel stands out for its gastronomic excellence\", \n",
     "    select='HotelName,Description,Category', query_caption='extractive', query_answer=\"extractive\",)\n",
     "\n",
@@ -439,7 +438,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If you are finished with this index, you can delete it by running the following lines. Deleting unnecessary indexes frees up space for stepping through more quickstarts and tutorials."
+    "If you're finished with this index, you can delete it by running the following lines. Deleting unnecessary indexes frees up space for stepping through more quickstarts and tutorials."
    ]
   },
   {

Quickstart/v11/azure-search-quickstart.ipynb

@@ -22,10 +22,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Uncomment the next line if you need to install the azure-search-documents client library:\n",
-    "# %pip install azure-search-documents --pre\n",
-    "\n",
-    "# This sample uses version: 11.1.0\n",
+    "# Import the libraies used in this notebook\n",
     "%pip show azure-search-documents\n",
     "\n",
     "import os\n",
@@ -80,7 +77,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "In the third cell, the index \"hotels-quickstart\" will be deleted if it previously existed."
+    "In the next step, the index \"hotels-quickstart\" is deleted, assuming it already exists on your search service. This action frees up index space and an allows you to reuse the index name. "
    ]
   },
   {

Tutorial-AI-Enrichment/PythonTutorial-AzureSearch-AIEnrichment.ipynb

@@ -59,7 +59,7 @@
     "headers = {'Content-Type': 'application/json',\n",
     "           'api-key': '<YOUR-ADMIN-API-KEY>'}\n",
     "params = {\n",
-    "    'api-version': '2020-06-30'\n",
+    "    'api-version': '2023-11-01'\n",
     "}"
    ]
   },