Vector samples - Azure AI Search

This repository provides Python, C#, REST, and JavaScript code samples for vector support in Azure AI Search.

There are breaking changes from REST API version 2023-07-01-Preview to newer API versions. These breaking changes also apply to the Azure SDK beta packages targeting that REST API version. See Upgrade REST APIs for migration guidance.

Feature status

Vector support consists of generally available features and preview features.

Feature	Status
vector indexing	generally available (2023-11-01 and stable SDK packages)
vector queries	generally available (2023-11-01 and stable SDK packages)
integrated data chunking	public preview (2023-10-01-preview and later, plus beta SDK packages)
integrated embedding	public preview (2023-10-01-preview and later, plus beta SDK packages)
index projections	public preview (2023-10-01-preview and later, plus beta SDK packages)
vectorizers	public preview (2023-10-01-preview and later, plus beta SDK packages)
scalar quantization	public preview (2024-03-01-preview and later, plus beta SDK packages)
OneLake indexer	public preview (2024-05-01-preview, plus beta SDK packages)
Binary vectors support	public preview (2024-05-01-preview, plus beta SDK packages)

Preview features are available under Supplemental Terms of Use.

demo-python samples

Sample	Description	Status
demo-python readme	A growing collection of notebooks that demonstrate aspects of vector search support, including data chunking and embedding of both text and image content and queries, using a variety of frameworks and techniques.	GA and preview

demo-dotnet samples

Sample	Description	Status
DotNetVectorDemo	A .NET console app that calls Azure OpenAI to vectorize data. It then calls Azure AI Search to create, load, and query vector data.	Generally available (GA)
DotNetIntegratedVectorizationDemo	A .NET console app that calls Azure AI Search to create an index, indexer, data source, and skillset. An Azure Storage account provides the data. Azure OpenAI is called by the skillset during indexing, and again during query execution to vectorize text queries.	Public preview
QuantizationAndStorageOptions	A .NET console app that demonstrates narrow data types and built-in scalar quantization, reducing vector index size in memory and on disk. It also disables storage of vectors returned in query response, which you don't need if you're not returning vectors in a query.	Public preview

demo-java samples

Sample	Description	Status
demo-vectors	A Java console app that calls Azure OpenAI to vectorize data. It then calls Azure AI Search to create, load, and query vector data.	GA
demo-integrated-vectorization	A Java console app that calls Azure AI Search to create an index, indexer, data source, and skillset. An Azure Storage account provides the data. Azure OpenAI is called by the skillset during indexing, and again during query execution to vectorize text queries.	GA and preview

demo-javascript samples

Sample	Description	Status
JavaScriptVectorDemo	A single folder contains three code samples. The azure-search-vector-sample.js script calls just Azure OpenAI and is used to generate embeddings for fields in an index. The docs-text-openai-embeddings.js program is an end-to-end code sample that calls Azure OpenAI for embeddings and Azure AI Seach to create, load, and query an index that contains vectors. The query-text-openai-embeddings.js script generates an embedding for a vector query.	GA and preview

Other vector samples and tools

• azure-ai-search-lab A learning and experimentation lab for trying out various AI-enabled search scenarios in Azure. It includes web application front-end which uses Azure AI Search and Azure OpenAI to execute searches with a variety of options - ranging from simple keyword search, to semantic ranking, vector and hybrid search, and using generative AI to answer search queries in various ways. This allows you to quickly understand what each option does, how it affects the search results, and how various approaches compare against each other.
• chat-with-your-data-solution-accelerator A template that deploys multiple Azure resources for a custom chat-with-your-data solution. Use this accelerator to create a production-ready solution that implements coding best practices.
• Azure Search OpenAI Demo A sample app for the Retrieval-Augmented Generation pattern running in Azure, using Azure AI Search for retrieval and Azure OpenAI large language models to power ChatGPT-style and Q&A experiences. Use the "vectors" branch to leverage Vector retrieval.
• Azure Search OpenAI Demo - C# A sample app for the Retrieval-Augmented Generation pattern running in Azure, using Azure AI Search for retrieval and Azure OpenAI large language models to power ChatGPT-style and Q&A experiences using C#.
• Azure OpenAI Embeddings QnA with Azure Search as a Vector Store (github.com) A simple web application for a OpenAI-enabled document search. This repo uses Azure OpenAI Service for creating embeddings vectors from documents. For answering the question of a user, using Azure AI Search for retrieval and Azure OpenAI large language models to power ChatGPT-style and Q&A experiences.
• ChatGPT Retreival Plugin Azure Search Vector Database The ChatGPT Retrieval Plugin lets you easily find personal or work documents by asking questions in natural language. Azure AI Search now supported as an official vector database.
• Azure Search Vector Search Demo Web App Template A Vector Search Demo React Web App Template using Azure OpenAI for Text Search and Cognitive Services Florence Vision API for Image Search.
• Azure Cognitive Search Comparison Tool

Documentation

• Azure AI Search Documentation

  • Retrieval Augmented Generation (RAG) in Azure AI Search
  • Vector search overview
  • Hybrid search overview
  • Create a vector index
  • Query a vector index
  • Vector search algorithms
  • REST API reference

• Azure OpenAI Service Documentation

• Azure AI Vision Documentation