Skip to content

Commit effb6bd

Browse files
authored
Merge pull request #78 from HeidiSteen/main
Readme updates
2 parents 050e39c + 9ab9a73 commit effb6bd

File tree

3 files changed

+30
-50
lines changed

3 files changed

+30
-50
lines changed

Quickstart/v11/README.md

Lines changed: 18 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,49 +2,44 @@
22
page_type: sample
33
languages:
44
- python
5-
name: Quickstart in Python - Jupyter Notebook
5+
name: Quickstart in Python
66
products:
77
- azure
88
- azure-cognitive-search
99
description: |
10-
Learn how to create, load, and query an Azure Cognitive Search index using Python and the latest-version REST APIs
11-
urlFragment: python-sample-quickstart
10+
Learn how to create, load, and query an Azure Cognitive Search index using Python.
11+
urlFragment: python-quickstart
1212
---
1313

14-
# Quickstart sample for Azure Cognitive Search using Python
14+
# Python quickstart for Azure Cognitive Search
1515

1616
![Flask sample MIT license badge](https://img.shields.io/badge/license-MIT-green.svg)
1717

1818
Demonstrates using Python and the Azure SDK for Python to create an Azure Cognitive Search index, load it with documents, and execute a few queries. The index is modeled on a subset of the Hotels dataset, reduced for readability and comprehension. Index definition and documents are included in the code.
1919

2020
This sample is a Jupyter Python3 .ipynb file to perform the actions against the Cognitive Search service.
2121

22-
## Contents
23-
24-
| File/folder | Description |
25-
|-------------|-------------|
26-
| `azure-search-quickstart.ipynb` | Jupyter Python notebook. |
27-
| `.gitignore` | Define what to ignore at commit time. |
28-
| `CONTRIBUTING.md` | Guidelines for contributing to the sample. |
29-
| `README.md` | This README file. |
30-
| `LICENSE` | The license for the sample. |
31-
3222
## Prerequisites
3323

34-
- [Anaconda 3.x](https://www.anaconda.com/distribution/#download-section) providing Python 3.x and Jupyter Notebooks
35-
- [Azure Cognitive Search service](https://docs.microsoft.com/azure/search/search-create-service-portal)
36-
- Azure Cognitive Search SDK for Python (pip install azure-search-documents --pre)
24+
* Visual Studio Code with the Python extension (or equivalent tool), with Python 3.7 or later
3725

38-
## Setup
26+
* [azure-search-documents package](https://pypi.org/project/azure-search-documents/) from the Azure SDK for Python
27+
28+
## Set up the sample
3929

4030
1. Clone or download this sample repository.
4131
2. Extract contents if the download is a zip file. Make sure the files are read-write.
4232

43-
## Running the sample
44-
1. On the Windows Start menu, select Anaconda3, and then select Jupyter Notebook.
45-
1. Open the azure-search-quickstart.ipynb file in Jupyter Notebook
46-
1. Replace <service_name> <admin_key> and <query_key> with the service and api-key details of your search service
47-
1. Run each step individually
33+
## Run the sample
34+
35+
1. Open the azure-search-quickstart.ipynb file in Visual Studio Code.
36+
37+
1. Set the service endpoint and API key for your search service:
38+
39+
* service_name = "YOUR-SEARCH-SERVICE-NAME"
40+
* admin_key = "YOUR-SEARCH-SERVICE-ADMIN-API-KEY"
41+
42+
1. Run each step in sequence.
4843

4944
## Next steps
5045

README.md

Lines changed: 9 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,11 @@
1-
# Python sample repository for Azure Cognitive Search
1+
# Python samples for Azure Cognitive Search
22

3-
This repository contains Python sample code used in Azure Cognitive Search quickstarts, tutorials, and examples. You can use the shared (free) Azure Cognitive Search service to run any sample in this repository.
3+
This repository contains Python code samples used in Azure Cognitive Search documentation. Unless noted otherwise, all samples run on the shared (free) pricing tier of an [Azure Cognitive Search service](https://learn.microsoft.com/azure/search/search-create-service-portal).
44

5-
## Quickstart sample - Azure Cognitive Search
6-
7-
This sample is a Jupyter Python3 .ipynb file used in [Quickstart: Create and query a search index using a Jupyter Python notebook](https://docs.microsoft.com/azure/search/search-get-started-python). Learn how to use the [**azure-search-documents**](https://docs.microsoft.com/python/api/overview/azure/search-documents-readme) client library in the Azure SDK for Python to make service connections, create and load indexes, and run basic queries.
8-
9-
## Tutorial sample - Add search to a web app
10-
11-
This sample shows how to create, load, and query a search index in Python using the Azure.Search.Documents library in the Azure SDK for Python. It also includes application code and sample data so that you can see search integration in the context of a full app. The data is from [https://github.com/zygmuntz/goodbooks-10k](https://github.com/zygmuntz/goodbooks-10k). The app is an Azure Static Web app, using the React library for user interaction, and Azure Function to handle the query requests and responses in the application layer.
12-
13-
## Tutorial sample - Add a skillset (enrichments) to an indexing pipeline
14-
15-
This sample is a Jupyter Python3 .ipynb file used in the [Python Tutorial: Call Cognitive Services APIs in an Azure Cognitive Search indexing pipeline](https://docs.microsoft.com/azure/search/cognitive-search-tutorial-blob-python). This sample demonstrates cognitive search functionality, adding AI enrichments from Cognitive Services to extract, detect, and analyze information from image files or large unstructured document files.
16-
17-
## Tutorial sample - Image processing
18-
19-
This sample is a Jupyter Python3 .ipynb file that shows how to work with image skills in a skillset. Although the skillset performs useful operations, including Optical Character Recognition (OCR) and redaction of personally identifying information, the sample's purpose is to demonstrate the coordination of image file handoffs from one skill to the next.
20-
21-
In this sample, skillset output is sent to a [knowledge store](https://docs.microsoft.com/azure/search/knowledge-store-concept-intro) in Azure Storage. Because knowledge store is not yet supported in the [**azure-search-documents**](https://docs.microsoft.com/python/api/overview/azure/search-documents-readme) python library, the [Search REST APIs](https://docs.microsoft.com/rest/api/searchservice/) are used instead.
22-
23-
## Tutorial sample - Train and deploy a custom skill with Azure Machine Learning
24-
25-
This sample is a Jupyter Python3 .ipynb file. It's used in the [Tutorial: Build and deploy a custom skill with Azure Machine Learning](https://docs.microsoft.com/azure/search/cognitive-search-tutorial-aml-custom-skill). This sample provides an end-to-end walk through for training and deploying an aspect-based sentiment model to an Azure Kubernetes cluster for consumption as a custom skill in a Cognitive Search enrichment pipeline. Azure Machine Learning is used to train and deploy the model.
26-
27-
In this sample, skillset output is sent to a [knowledge store](https://docs.microsoft.com/azure/search/knowledge-store-concept-intro) in Azure Storage. Because knowledge store is not yet supported in the [**azure-search-documents**](https://docs.microsoft.com/python/api/overview/azure/search-documents-readme) python library, the [Search REST APIs](https://docs.microsoft.com/rest/api/searchservice/) are used instead.
5+
| Sample | Description |
6+
|--------|-------------|
7+
| azureml-custom-skill | This sample is a Jupyter Python3 .ipynb file. It's used in the [Tutorial: Build and deploy a custom skill with Azure Machine Learning](https://docs.microsoft.com/azure/search/cognitive-search-tutorial-aml-custom-skill). This sample provides an end-to-end walk through for training and deploying an aspect-based sentiment model to an Azure Kubernetes cluster for consumption as a custom skill in a Cognitive Search enrichment pipeline. Azure Machine Learning is used to train and deploy the model. |
8+
| image-processing | This sample is a Jupyter Python3 .ipynb file that shows how to work with image skills in a skillset. Although the skillset performs useful operations, including Optical Character Recognition (OCR) and redaction of personally identifying information, the sample's purpose is to demonstrate the coordination of image file handoffs from one skill to the next. |
9+
| quickstart | "Day One" introduction to the fundamental tasks of working with a search index: create, load, and query. This sample is a Jupyter Python3 .ipynb file. The index is modeled on a subset of the Hotels dataset, widely used in Cognitive Search samples, but reduced here for readability and comprehension. |
10+
| tutorial-ai-enrichment | This sample is a Jupyter Python3 .ipynb file used in the [Python Tutorial: Call Cognitive Services APIs in an Azure Cognitive Search indexing pipeline](https://docs.microsoft.com/azure/search/cognitive-search-tutorial-blob-python). This sample demonstrates cognitive search functionality, adding AI enrichments from Cognitive Services to extract, detect, and analyze information from image files or large unstructured document files. |
11+
| search-website-functions-v4 | Shows how to create, load, and query a search index in Python using the Azure.Search.Documents library in the Azure SDK for Python. It also includes application code and sample data so that you can see search integration in the context of a full app. The data is from [https://github.com/zygmuntz/goodbooks-10k](https://github.com/zygmuntz/goodbooks-10k). The app is an Azure Static Web app, using the React library for user interaction, and Azure Function to handle the query requests and responses in the application layer. |

search-website-functions-v4/README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,13 @@
22
page_type: sample
33
languages:
44
- python
5-
name: Add search to web apps
5+
name: Add search to a Python app
66
products:
77
- azure
88
- azure-cognitive-search
9+
- azure-static-web-app
910
description: |
10-
Add document search to a web app. This Python sample uses the Azure.Search.Documents library to create, load, and query the index. The app is an Azure Static Web app. User interaction is implemented with React. Query requests and responses are handled in Azure Function.
11+
Add document search to a web app. This Python sample uses the Azure.Search.Documents library to create, load, and query the index.
1112
urlFragment: python-sample-search-web-app
1213
---
1314

0 commit comments

Comments
 (0)