Skip to content

Azure-Samples/azure-search-knowledge-mining

Repository files navigation

page_type languages products description urlFragment
sample
csharp
javascript
html
powershell
azure
azure-ai-search
Welcome to the Knowledge Mining Solution Accelerator!
azure-search-knowledge-mining

Knowledge Mining Solution Accelerator

Knowledge Mining Solution Accelerator

Important

As of November 15, 2023, Azure Cognitive Search has been renamed to Azure AI Search.

About this repository

Welcome to the Knowledge Mining Solution Accelerator! This accelerator provides developers with all of the resources they need to quickly build an initial Knowledge Mining prototype with Azure AI Search. Use this accelerator to jump-start your development efforts with your own data or as a learning tool to better understand how you can use AI Search to meet the unique needs of your business.

In this repository, we've provided you with all of the artifacts you need to quickly create a AI Search Solution including: templates for deploying the appropriate Azure resources, assets for creating your first search index, templates for using custom skills, a basic web app, and PowerBI reports to monitor search solution performance. We've infused best practices throughout the documentation to help guide you. With AI Search, you can easily index both digital data (such as documents and text files) and analog data (such as images and scanned documents).

Note: This guide uses the AI enrichment feature of AI Search. AI enrichment allows you to ingest many kinds of data (documents, text files, images, scanned docs, and more), extract their contents, enrich and transform it, and then index it for exploration purposes. To learn more about this feature, see the AI Enrichment in AI Search doc.

Once you're finished, you'll have a web app ready to search your data.

A web app showing several resources and their lists of searchable tags

Prerequisites

In order to successfully complete your solution, you'll need to gain access and provision the following resources:

  • Azure subscription - Create one for free
  • Visual Studio 2019 or later - Community edition or higher
  • Postman for making API calls
  • Documents uploaded to any data source supported by Azure Search Indexers. For a list of these, see Indexers in Azure AI Search. This solution accelerator uses Azure Blob Storage as a container for source data files. You can find sample documents in the sample_documents/ folder.

The directions provided in this guide assume you have a fundamental working knowledge of the Azure portal, Azure Functions, Azure AI Search, Visual Studio and Postman. For additional training and support, please see:

Process overview

Clone or download this repository and then navigate through each of these folders in order, following the steps outlined in each of the README files. When you complete all of the steps, you'll have a working end-to-end solution that combines data sources with data enrichment skills, a web app powered by Azure AI Search, and intelligent reporting on user search activity.

the AI indexing pipelines used for processing unstructured data in Azure AI Search

The contents of this folder show you how to deploy the required resources to your Azure subscription. You can do this either through the Azure portal or using the provided PowerShell script.

Alternatively, you can automatically deploy the required resources using this button:

Deploy to Azure

If you need to deploy to Azure Government, check out the Azure Government version of the Knowledge Mining Solution Accelerator.

This folder contains a Postman collection that you can use to create a search index. The collection is pre-configured to take advantage of out-of-the-box AI Search functionality.

We recommend using this collection to create an initial search index and then iterating by editing the postman collection and adding custom skills as needed.

This folder contains a basic Web UI Template, written in .NET Core, which you can configure to query your search index. Follow the steps outlined in the Web UI Template README file to integrate your new search index into the web app.

This folder contains examples and templates to add your own custom skills to your solution. These custom skills help to align the solution to the needs of your particular use case. This step is entirely optional and may be skipped if not needed.

For additional samples and information on custom skill development, see the Custom skill documentation. .NET Azure Function Custom Skills have moved to the Power Skills repository.

This folder contains pre-built PowerBI reports that you can use to monitor your solution and to understand user search behavior. They leverage data captured through Application Insights and can be modified to meet your particular business objectives. This step is entirely optional and may be skipped if not needed.

This folder contains a small data set in a variety of file formats that you can use to build your solution if you don't have another data set available.

Become an Azure AI Search expert in a day! This folder contains a self paced workshop that teaches you everything you need to know. Most developers with Azure familiarity should be able to complete the majority of the modules in the training within 8 hours.

License

Please refer to LICENSE for all licensing information.