Skip to content

Commit 8afa73f

Browse files
committed
more edits
1 parent 7b8b00a commit 8afa73f

File tree

2 files changed

+17
-17
lines changed

2 files changed

+17
-17
lines changed

articles/search/search-get-started-portal-import-vectors.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ Get started with [integrated vectorization (preview)](vector-search-integrated-v
2222
In this preview version of the wizard:
2323

2424
+ Source data is blob only, using the default parsing mode (one search document per blob).
25-
+ Index schema is nonconfigurable. Source fields include `content` (chunked and vectorized), `metadata_storage_name` for title, and a `metadata_storage_path` for the document key which is populated as `parent_id` in the Index.
26-
+ Vectorization is Azure OpenAI only (text-embedding-ada-002), using the [HNSW](vector-search-ranking.md) algorithm with defaults.
25+
+ Index schema is nonconfigurable. Source fields include `content` (chunked and vectorized), `metadata_storage_name` for title, and a `metadata_storage_path` for the document key, represented as `parent_id` in the Index.
26+
+ Vectorization is Azure OpenAI only (text-embedding-ada-002), using the [Hierarchical Navigable Small Worlds (HNSW)](vector-search-ranking.md) algorithm with defaults.
2727
+ Chunking is nonconfigurable. The effective settings are:
2828

2929
```json
@@ -32,21 +32,22 @@ In this preview version of the wizard:
3232
pageOverlapLength: 500
3333
```
3434

35-
## Prerequisites
35+
For more configuration and data source options, try Python or the REST APIs. See [integrated vectorization sample](https://github.com/Azure/azure-search-vector-samples/blob/main/demo-python/code/integrated-vectorization/azure-search-integrated-vectorization-sample.ipynb) for details.
36+
3637

3738
+ An Azure subscription. [Create one for free](https://azure.microsoft.com/free/).
3839

39-
+ Azure AI Search, in any region and on any tier. Most existing services support vector search. For a small subset of services created prior to January 2019, an index containing vector fields fails on creation. In this situation, a new service must be created.
40+
+ Azure AI Search, in any region and on any tier. Most existing services support vector search. For a small subset of services created before January 2019, an index containing vector fields fails on creation. In this situation, a new service must be created.
4041

4142
+ [Azure OpenAI](https://aka.ms/oai/access) endpoint with a deployment of **text-embedding-ada-002** and an API key or [**Cognitive Services OpenAI User**](/azure/ai-services/openai/how-to/role-based-access-control#azure-openai-roles) permissions to upload data. You can only choose one vectorizer in this preview, and the vectorizer must be Azure OpenAI.
4243

43-
+ [Azure Storage account](/azure/storage/common/storage-account-overview), standard performance (general-purpose v2), Hot and Cool access tiers.
44+
+ [Azure Storage account](/azure/storage/common/storage-account-overview), standard performance (general-purpose v2), hot, cool, and cold access tiers.
4445

4546
+ Blobs providing text content, unstructured docs only, and metadata. In this preview, your data source must be Azure blobs.
4647

4748
+ Read permissions in Azure Storage. A storage connection string that includes an access key gives you read access to storage content. If instead you're using Microsoft Entra logins and roles, make sure the [search service's managed identity](search-howto-managed-identities-data-sources.md) has [**Storage Blob Data Reader**](/azure/storage/blobs/assign-azure-role-data-access) permissions.
4849

49-
+ All components (data source and embedding endpoint) must have public access enabled for the portal nodes to be able to access them. Otherwise, the wizard will fail. After the wizard runs, firewalls and private endpoints can be enabled in the different integration components for security. If private endpoints are already present and can't be disabled, the alternative option is to run the respective end-to-end flow from a script or program from a Virtual Machine within the same VNET as the private endpoint. Here is a [Python code sample](https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/integrated-vectorization) for integrated vectorization. In the same [GitHub repo](https://github.com/Azure/azure-search-vector-samples/tree/main) are samples in other programming languages.
50+
+ All components (data source and embedding endpoint) must have public access enabled for the portal nodes to be able to access them. Otherwise, the wizard fails. After the wizard runs, firewalls and private endpoints can be enabled in the different integration components for security. If private endpoints are already present and can't be disabled, the alternative option is to run the respective end-to-end flow from a script or program from a virtual machine within the same virtual network as the private endpoint. Here is a [Python code sample](https://github.com/Azure/azure-search-vector-samples/tree/main/demo-python/code/integrated-vectorization) for integrated vectorization. In the same [GitHub repo](https://github.com/Azure/azure-search-vector-samples/tree/main) are samples in other programming languages.
5051

5152
## Check for space
5253

@@ -202,4 +203,4 @@ Azure AI Search is a billable resource. If it's no longer needed, delete it from
202203

203204
## Next steps
204205

205-
This quickstart introduced you to the **Import and vectorize data** wizard that creates all of the objects necessary for integrated vectorization. If you want to explore each step in detail, try an [integrated vectorization sample](https://github.com/HeidiSteen/azure-search-vector-samples/blob/main/demo-python/code/integrated-vectorization/azure-search-integrated-vectorization-sample.ipynb).
206+
This quickstart introduced you to the **Import and vectorize data** wizard that creates all of the objects necessary for integrated vectorization. If you want to explore each step in detail, try an [integrated vectorization sample](https://github.com/Azure/azure-search-vector-samples/blob/main/demo-python/code/integrated-vectorization/azure-search-integrated-vectorization-sample.ipynb).

articles/search/vector-search-integrated-vectorization.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,20 @@ ms.date: 05/05/2024
1717
> [!IMPORTANT]
1818
> Integrated data chunking and vectorization is in public preview under [Supplemental Terms of Use](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). The [2023-10-01-Preview REST API](/rest/api/searchservice/skillsets/create-or-update?view=rest-searchservice-2023-10-01-preview&preserve-view=true) provides this feature.
1919
20-
*Integrated vectorization* adds data chunking and text-to-vector embedding to skills in indexer-based indexing. It also adds text-to-vector conversions to queries.
20+
*Integrated vectorization* adds data chunking and text-to-vector conversions during indexing and at query time.
2121

22-
<!-- This capability is preview-only. In the generally available version of [vector search](vector-search-overview.md) and in previous preview versions, data chunking and vectorization rely on external components for chunking and vectors, and your application code must handle and coordinate each step. In this preview, chunking and vectorization are built into indexing through skills and indexers. You can set up a skillset that chunks data using the Text Split skill, and then call an embedding model using either the AzureOpenAIEmbedding skill or a custom skill. Any vectorizers used during indexing can also be called on queries to convert text to vectors. -->
22+
For data chunking and text-to-vector conversions during indexing, you need:
2323

24-
For text-to-vector conversions during indexing:
25-
26-
+ [An indexer](search-indexer-overview.md) retrieves data from a supported data source.
27-
+ [A skillset](cognitive-search-working-with-skillsets.md) calls the [Text Split skill](cognitive-search-skill-textsplit.md) to chunk the data.
28-
+ The same skillset also calls a vectorizer. The vectorizer is either the [AzureOpenAIEmbedding skill](cognitive-search-skill-azure-openai-embedding.md) for text-embedding-ada-002 on Azure OpenAI, or a [custom skill](cognitive-search-custom-skill-web-api.md) that points to another embedding model, for example test-embedding-ada-002 on OpenAI.
24+
+ [An indexer](search-indexer-overview.md) to retrieve data from a supported data source.
25+
+ [A skillset](cognitive-search-working-with-skillsets.md) to call the [Text Split skill](cognitive-search-skill-textsplit.md) to chunk the data.
26+
+ The same skillset, calling a vectorizer. The vectorizer is either the [AzureOpenAIEmbedding skill](cognitive-search-skill-azure-openai-embedding.md) for text-embedding-ada-002 on Azure OpenAI, or a [custom skill](cognitive-search-custom-skill-web-api.md) that points to another embedding model, for example test-embedding-ada-002 on OpenAI.
2927
+ You also need a [vector index](search-what-is-an-index.md) to receive the chunked and vectorized content.
3028

3129
For text-to-vector queries:
3230

3331
+ [A vectorizer](vector-search-how-to-configure-vectorizer.md) defined in the index schema, assigned to a vector field, and used automatically at query time to convert a text query to a vector.
34-
+ A query that specifies one or more vector fields, and a query string providing text that's converted to a vector at query
32+
+ A query that specifies one or more vector fields.
33+
+ A text string that's converted to a vector at query time.
3534

3635
Vector conversions are one-way: text-to-vector. There's no vector-to-text conversion for queries or results (for example, you can't convert a vector result to a human-readable string).
3736

@@ -46,15 +45,15 @@ Here's a checklist of the components responsible for integrated vectorization:
4645
+ A supported data source for indexer-based indexing.
4746
+ An index that specifies vector fields, and a vectorizer definition assigned to vector fields.
4847
+ A skillset providing a Text Split skill for data chunking, and a skill for vectorization (either the AzureOpenAiEmbedding skill or a custom skill pointing to an external embedding model).
49-
+ Optionally, index projections (also defined in a skillset) to push chunked data to a secondary index
48+
+ Optionally, index projections (also defined in a skillset) to push chunked data to a secondary index.
5049
+ An embedding model, deployed on Azure OpenAI or available through an HTTP endpoint.
5150
+ An indexer for driving the process end-to-end. An indexer also specifies a schedule, field mappings, and properties for change detection.
5251

5352
This checklist focuses on integrated vectorization, but your solution isn't limited to this list. You can add more skills for AI enrichment, create a knowledge store, add semantic ranking, add relevance tuning, and other query features.
5453

5554
## Availability and pricing
5655

57-
Integrated vectorization availability is based on the embedding model. If you're using Azure OpenAI, check [regional availability]( https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=cognitive-services).
56+
Integrated vectorization is available in all regions and tiers. However, if you're using Azure OpenAI and the AzureOpenAIEmbedding skill, check [regional availability]( https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=cognitive-services) of that service.
5857

5958
If you're using a custom skill and an Azure hosting mechanism (such as an Azure function app, Azure Web App, and Azure Kubernetes), check the [product by region page](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/) for feature availability.
6059

0 commit comments

Comments
 (0)