Skip to content

Commit 53b92af

Browse files
Merge pull request #246894 from HeidiSteen/heidist-vectors
[azure search] semantic search basic tier support
2 parents d187123 + 59f81fc commit 53b92af

File tree

6 files changed

+16
-13
lines changed

6 files changed

+16
-13
lines changed

articles/search/search-get-started-semantic.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This quickstart walks you through the query modifications that invoke semantic s
2727

2828
+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/).
2929

30-
+ Azure Cognitive Search, at Standard one (S1) tier or higher, with [semantic search enabled](semantic-search-overview.md#enable-semantic-search).
30+
+ Azure Cognitive Search, at Basic tier or higher, with [semantic search enabled](semantic-search-overview.md#enable-semantic-search).
3131

3232
+ An API key and search endpoint:
3333

articles/search/search-sku-tier.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ Most features are available on all tiers, including the free tier. In a few case
6666
| [IP firewall access](service-configure-firewall.md) | Not available on the Free tier. |
6767
| [Private endpoint (integration with Azure Private Link)](service-create-private-endpoint.md) | For inbound connections to a search service, not available on the Free tier. For outbound connections by indexers to other Azure resources, not available on Free or S3 HD. For indexers that use skillsets, not available on Free, Basic, S1, or S3 HD.|
6868
| [Availability Zones](search-reliability.md) | Not available on the Free or Basic tier. |
69-
| [Semantic search (preview)](semantic-search-overview.md) | Not available on the Free or Basic tier. |
69+
| [Semantic search (preview)](semantic-search-overview.md) | Not available on the Free tier. |
7070

7171
Resource-intensive features might not work well unless you give it sufficient capacity. For example, [AI enrichment](cognitive-search-concept-intro.md) has long-running skills that time out on a Free service unless the dataset is small.
7272

articles/search/semantic-how-to-query-request.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ There are two main activities to perform:
2525

2626
## Prerequisites
2727

28-
+ A search service on Standard tier (S1, S2, S3) or Storage Optimized tier (L1, L2), subject to [region availability](https://azure.microsoft.com/global-infrastructure/services/?products=search).
28+
+ A search service on Basic, Standard tier (S1, S2, S3), or Storage Optimized tier (L1, L2), subject to [region availability](https://azure.microsoft.com/global-infrastructure/services/?products=search).
2929

30-
If you have an existing S1 or greater service in a supported region, you can enable semantic search without having to create a new service.
30+
If you have an existing Basic or greater service in a supported region, you can enable semantic search without having to create a new service.
3131

3232
+ Semantic search [enabled on your search service](semantic-search-overview.md#enable-semantic-search).
3333

articles/search/semantic-ranking.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ A [semantic answer](semantic-answers.md) will also be returned if you specified
6969
7070
## Next steps
7171

72-
Semantic ranking is offered on Standard tiers, in specific regions. For more information about availability and sign-up, see [Availability and pricing](semantic-search-overview.md#availability-and-pricing). A new query type enables the ranking and response structures of semantic search. To get started, [Configure semantic ranking](semantic-how-to-query-request.md).
72+
Semantic ranking is offered on Basic tiers and higher, in specific regions. For more information about availability and sign-up, see [Availability and pricing](semantic-search-overview.md#availability-and-pricing). A new query type enables the ranking and response structures of semantic search. To get started, [Configure semantic ranking](semantic-how-to-query-request.md).
7373

7474
Alternatively, review the following articles about default ranking. Semantic ranking depends on the similarity ranker to return the initial results. Knowing about query execution and ranking will give you a broad understanding of how the entire process works.
7575

articles/search/vector-search-how-to-create-index.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -71,23 +71,25 @@ If the index doesn't have a vector configuration, you're prompted to create one
7171
+ Name the field (no spaces).
7272
+ Choose type `Collection(Edm.Single)`.
7373
+ Select "Retrievable" if you want the query to return the vector data in search results. If you have other fields with human readable content that you can return as a proxy for the match, you should set "Retrievable" to false to save space.
74-
+ "Searchable" is mandatory for a vector field and can't be set.
75-
+ "Dimensions" is the length of the vector returned by the model. Set this value to specify `1536` for **text-embeddding-ada-002**, where the input text that you provide is described numerically using 1536 dimension.
74+
+ "Searchable" is mandatory for a vector field and can't be changed.
75+
+ "Dimensions" is the length of the vector returned by the model. Set this value to specify `1536` for **text-embeddding-ada-002**, where the input text that you provide is numerically described using 1536 dimensions.
7676

77-
1. Select or create a vector configuration used for similarity search. Currently, only Hierarchical Navigation Small World (HNSW) is supported. If there's no configuration in the index, select **Create**.
77+
1. Select or create a vector configuration used for similarity search. If the index doesn't have a vector configuration, you must select **Create**.
7878

7979
:::image type="content" source="media/vector-search-how-to-create-index/portal-add-vector-configuration.png" alt-text="Screenshot of the vector configuration properties." border="true":::
8080

8181
**Key points**:
8282

83-
+ Name the configuration(no spaces). The name must be unique within the index.
84-
+ "hnsw" is the Approximate Nearest Neighbors (ANN) algorithm used to find similar vectors.
85-
+ "Bi-directional link count" default is 4. The range is 2 to 100. Lower values should return less noise in the results.
83+
+ Name the configuration. The name must be unique within the index.
84+
+ "hnsw" is the Approximate Nearest Neighbors (ANN) algorithm used to find similar vectors. Currently, only Hierarchical Navigable Small World (HNSW) is supported.
85+
+ "Bi-directional link count" default is 4. The range is 2 to 100. Lower values (lower recall) should return less noise in the results.
8686
+ "efConstruction" default is 400. It's the number of nearest neighbors used during indexing.
8787
+ "efSearch default is 500. It's the number of nearest neighbors used during search.
8888
+ "Similarity metric" should be "cosine" if you're using Azure OpenAI, otherwise use the similarity metric of the embedding model. Supported values are `cosine`, `dotProduct`, `euclidean`.
8989

90-
If you're familiar with HNSW parameters, you might be wondering about "k" number of nearest neighbors to return in the result. In Cognitive Search, that value is set on the query request.
90+
If you're familiar with HNSW parameters, you might be wondering about "k" number of nearest neighbors to return in the result. In Cognitive Search, that value is set on the query request.
91+
92+
1. Select **Save** to save the vector configuration and the field definition.
9193

9294
### [**REST API**](#tab/rest-add-field)
9395

articles/search/whats-new.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: HeidiSteen
77
ms.author: heidist
88
ms.service: cognitive-search
99
ms.topic: overview
10-
ms.date: 06/29/2023
10+
ms.date: 07/31/2023
1111
ms.custom: references_regions
1212
---
1313

@@ -24,6 +24,7 @@ Learn about the latest updates to Azure Cognitive Search functionality, docs, an
2424
|-----------------------------|------|--------------|
2525
| [**Vector search public preview**](vector-search-overview.md) | Feature | Adds vector fields to a search index for similarity search over vector representations of data. |
2626
| [**2023-07-01-Preview Search REST API**](/rest/api/searchservice/index-preview) | API | New preview version of the Search REST APIs that adds support for vector search. This API version is inclusive of all preview features. If you're using earlier previews, switch to **2023-07-01-preview** with no loss of functionality. |
27+
| [**Semantic search availability**](semantic-search-overview.md) | Feature | Semantic search is now available on the Basic tier. |
2728

2829
## May 2023
2930

0 commit comments

Comments
 (0)