Merge pull request #246059 from ShawnJackson/how-to-create-vector-index

[AQ] edit pass: how-to-create-vector-index

Author: ktoliver

articles/machine-learning/how-to-create-vector-index.md

@@ -1,7 +1,7 @@
 ---
-title: How to create vector index in Azure Machine Learning prompt flow (preview)
+title: Create a vector index in an Azure Machine Learning prompt flow (preview)
 titleSuffix: Azure Machine Learning
-description: How to create a vector index in Azure Machine Learning and use it in a prompt flow.
+description: Learn how to create a vector index in Azure Machine Learning and use it in a prompt flow.
 services: machine-learning
 ms.author: balapv
 author: balapv
@@ -13,77 +13,74 @@ ms.topic: how-to
 ms.custom: prompt-flow
 ---
 
-# How to create vector index in Azure Machine Learning prompt flow (preview)
+# Create a vector index in an Azure Machine Learning prompt flow (preview)
 
-Azure Machine Learning enables you to create a vector index from files/folders on your machine, a location in a cloud storage, an Azure Machine Learning data asset, a Git repository, or an SQL database. Azure Machine Learning can currently crack and process text files, md files, pdf, excel files, word documents. You can also reuse an existing Azure Cognitive Search Index instead of creating a new Index.
+You can use Azure Machine Learning to create a vector index from files or folders on your machine, a location in cloud storage, an Azure Machine Learning data asset, a Git repository, or a SQL database. Azure Machine Learning can currently process .txt, .md, .pdf, .xls, and .docx files. You can also reuse an existing Azure Cognitive Search index instead of creating a new index.
 
-When a Vector Index is created, Azure Machine Learning will chunk the data, create embeddings, and store the embeddings in a FAISS Index or Azure Cognitive Search Index. In addition, Azure Machine Learning creates: 
+When you create a vector index, Azure Machine Learning chunks the data, creates embeddings, and stores the embeddings in a Faiss index or Azure Cognitive Search index. In addition, Azure Machine Learning creates:
 
 * Test data for your data source.
 
-* A sample prompt flow, which uses the Vector Index you created. The sample prompt flow, which gets created has several key features like: Automatically generated prompt variants. Evaluation of each of these variations using the [test data generated](https://aka.ms/prompt_flow_blog). Metrics against each of the variants to help you choose the best variant to run. You can use this sample to continue developing your prompt. 
+* A sample prompt flow, which uses the vector index that you created. Features of the sample prompt flow include:
+
+  * Automatically generated prompt variants.
+  * Evaluation of each prompt variant by using the [generated test data](https://aka.ms/prompt_flow_blog).
+  * Metrics against each prompt variant to help you choose the best variant to run.
+
+  You can use this sample to continue developing your prompt.
 
 [!INCLUDE [machine-learning-preview-generic-disclaimer](includes/machine-learning-preview-generic-disclaimer.md)]
 
 ## Prerequisites
 
 * An Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/).
 
-* Access to Azure Open AI. 
-
-* Enable prompt flow in your Azure Machine Learning workspace
-
-In your Azure Machine Learning workspace, you can enable prompt flow by turn-on **Build AI solutions with Prompt flow** in the **Manage preview features** panel.
-
-
-## Create a new Vector Index using studio
-
-1.  Select **Prompt flow** on the left menu
-
-     :::image type="content" source="media/how-to-create-vector-index/prompt.png" alt-text="Screenshot showing the Prompt flow location on the left menu.":::
-
-1.  Select **Vector Index** on the top menu
+* Access to Azure OpenAI Service.
 
-    :::image type="content" source="./media/how-to-create-vector-index/vector-index.png" alt-text="Screenshot showing the Vector Index location on the top menu.":::
+* Prompt flows enabled in your Azure Machine Learning workspace. You can enable prompt flows by turning on **Build AI solutions with Prompt flow** on the **Manage preview features** panel.
 
+## Create a vector index by using Machine Learning studio
 
-1.  Select **Create**
+1. Select **Prompt flow** on the left menu.
 
-1.  After the create new vector index form opens, provide a name for your vector index.
+    :::image type="content" source="media/how-to-create-vector-index/prompt.png" alt-text="Screenshot that shows the location of prompt flow on the left menu.":::
 
-1.  Next choose your data source type
+1. Select the **Vector Index** tab.
 
-    :::image type="content" source="media/how-to-create-vector-index/new-vector-creation.png" alt-text="Screenshot showing the create new Vector Index form.":::
+    :::image type="content" source="./media/how-to-create-vector-index/vector-index.png" alt-text="Screenshot that shows the tab for vector index.":::
 
-1.  Based on the chosen type, provide the location details of your
-    source. Then, select **Next**.
+1. Select **Create**.
 
-1.  Review the details of your vector index, then select the **Create** button to create the vector index. For more information about how to [use Vector Stores (preview).](concept-vector-stores.md) 
+1. When the form for creating a vector index opens, provide a name for your vector index.
 
-1. This takes you to an overview page from where you can track and view the status of your Vector Index creation. Note: Vector Index creation may take a while depending on the size of data.
+    :::image type="content" source="media/how-to-create-vector-index/new-vector-creation.png" alt-text="Screenshot that shows basic settings for creating a vector index.":::
 
+1. Select your data source type.
 
+1. Based on the chosen type, provide the location details of your source. Then, select **Next**.
 
-## Add a Vector Index to a prompt flow
+1. Review the details of your vector index, and then select the **Create** button.
 
-Once you have created a Vector Index, you can add it to a prompt flow from the prompt flow canvas. The prompt flow designer has a Vector Index lookup tool. Add this tool to the canvas and enter the path to your Vector Index and the query you want to perform against the index. You can find the steps to do this here.
+1. On the overview page that appears, you can track and view the status of creating your vector index. The process might take a while, depending on the size of your data.
 
+## Add a vector index to a prompt flow
 
-1. Open an existing prompt flow
+After you create a vector index, you can add it to a prompt flow from the prompt flow canvas.
 
+1. Open an existing prompt flow.
 
-1. On the top menu, select **More Tools** and select Vector Index Lookup
+1. On the top menu of the prompt flow designer, select **More tools**, and then select **Vector Index Lookup**.
 
-    :::image type="content" source="media/how-to-create-vector-index/vector-lookup.png" alt-text="Screenshot showing the location of the More Tools button.":::
+    :::image type="content" source="media/how-to-create-vector-index/vector-lookup.png" alt-text="Screenshot that shows the list of available tools.":::
 
-1. The Vector Index lookup tool gets added to the canvas. If you don't see the tool immediately, scroll to the bottom of the canvas.
+   The Vector Index Lookup tool is added to the canvas. If you don't see the tool immediately, scroll to the bottom of the canvas.
 
-    :::image type="content" source="media/how-to-create-vector-index/vector-index-lookup-tool.png" alt-text="Screenshot showing the vector index lookup tool.":::
+    :::image type="content" source="media/how-to-create-vector-index/vector-index-lookup-tool.png" alt-text="Screenshot that shows the Vector Index Lookup tool.":::
 
-1. Enter the path to your Vector Index and enter your desired query. Be sure to type in your path directly, or to paste the path.
+1. Enter the path to your vector index, along with the query that you want to perform against the index.
 
 ## Next steps
 
-[Get started with RAG using a prompt flow sample (preview)](how-to-use-pipelines-prompt-flow.md)
+[Get started with RAG by using a prompt flow sample (preview)](how-to-use-pipelines-prompt-flow.md)
 
-[Use Vector Stores](concept-vector-stores.md) with Azure Machine Learning (preview)
+[Use vector stores with Azure Machine Learning (preview)](concept-vector-stores.md)

articles/machine-learning/includes/machine-learning-preview-generic-disclaimer.md

@@ -11,6 +11,6 @@ ms.custom: include file
 ---
 
 > [!IMPORTANT]
-> This feature is currently in public preview.
-> This preview version is provided without a service-level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
+> This feature is currently in public preview. This preview version is provided without a service-level agreement, and we don't recommend it for production workloads. Certain features might not be supported or might have constrained capabilities.
+>
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).