You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-studio/how-to/index-add.md
+22-70Lines changed: 22 additions & 70 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,6 +7,7 @@ ms.service: azure-ai-studio
7
7
ms.custom:
8
8
- ignite-2023
9
9
- build-2024
10
+
- ignite-2024
10
11
ms.topic: how-to
11
12
ms.date: 5/21/2024
12
13
ms.reviewer: estraight
@@ -26,107 +27,58 @@ You must have:
26
27
- An Azure AI Studio project
27
28
- An Azure AI Search resource
28
29
29
-
## Create an index from the Indexes tab
30
+
## Create an index from the Chat playground
30
31
31
32
1. Sign in to [Azure AI Studio](https://ai.azure.com).
32
33
1. Go to your project or [create a new project](../how-to/create-projects.md) in Azure AI Studio.
33
-
1. From the collapsible **My assets**menu on the left, select **Data + indexes**.
34
-
1. At the top, select the **Indexes** tab.
34
+
1. From the menu on the left, select **Playgrounds**.
35
+
35
36
36
37
:::image type="content" source="../media/index-retrieve/project-left-menu.png" alt-text="Screenshot of Project Left Menu." lightbox="../media/index-retrieve/project-left-menu.png":::
37
38
38
-
1. Select **+ New index**
39
+
1. Select a deployed model. If you have not done so already, deploy a model by selecting **Create new deployment**.
40
+
41
+
:::image type="content" source="../media/index-retrieve/create-deployment.png" alt-text="Screenshot of create a deployment button." lightbox="../media/index-retrieve/create-deployment.png":::
42
+
43
+
1. Scroll to the bottom of the model window. Select **+ Add a new data source**
44
+
45
+
:::image type="content" source="../media/index-retrieve/add-your-data.png" alt-text="Screenshot of the add your data section." lightbox="../media/index-retrieve/add-your-data.png":::
46
+
39
47
1. Choose your **Source data**. You can choose source data from a list of your recent data sources, a storage URL on the cloud, or upload files and folders from the local machine. You can also add a connection to another data source such as Azure Blob Storage.
40
48
41
49
:::image type="content" source="../media/index-retrieve/select-source-data.png" alt-text="Screenshot of select source data." lightbox="../media/index-retrieve/select-source-data.png":::
42
50
43
51
1. Select **Next** after choosing source data
44
-
1. Choose the **Index Storage** - the location where you want your index to be stored
45
-
1. If you already have a connection created for an Azure AI Search service, you can choose that from the dropdown.
52
+
1. Choose the **Index Storage** - the location where you want your index to be stored in the **Index configuration** tab.
53
+
1. If you already have an Azure AI Search resource, you can choose that from the dropdown.
46
54
47
55
:::image type="content" source="../media/index-retrieve/index-storage.png" alt-text="Screenshot of select index store." lightbox="../media/index-retrieve/index-storage.png":::
48
56
49
-
1. If you don't have an existing connection, choose **Connect other Azure AI Search service**
50
-
1. Select the subscription and the service you wish to use.
51
-
52
-
:::image type="content" source="../media/index-retrieve/index-store-details.png" alt-text="Screenshot of Select index store details." lightbox="../media/index-retrieve/index-store-details.png":::
53
-
54
-
1. Select **Next** after choosing index storage
55
-
1. Configure your **Search Settings**
56
-
1. The ***Vector settings*** defaults to true for Add vector search to this search resource. As noted, this enables Hybrid and Hybrid + Semantic search options. Disabling this limits vector search options to Keyword and Semantic.
57
-
1. For the hybrid option to work, you need an embedding model. Choose an embedding model from the dropdown.
58
-
1. Select the acknowledgment to deploy an embedding model if it doesn't already exist in your resource
59
-
60
-
:::image type="content" source="../media/index-retrieve/search-settings.png" alt-text="Screenshot of configure search settings." lightbox="../media/index-retrieve/search-settings.png":::
61
-
62
-
If a non-Azure OpenAI model isn't appearing in the dropdown follow these steps:
63
-
1. Navigate to the Project settings in [Azure AI Studio](https://ai.azure.com).
64
-
1. Navigate to connections section in the settings tab and select New connection.
65
-
1. Select **Serverless Model**.
66
-
1. Type in the name of your embedding model deployment and select Add connection. If the model doesn't appear in the dropdown, select the **Enter manually** option.
67
-
1. Enter the deployment API endpoint, model name, and API key in the corresponding fields. Then add connection.
68
-
1. The embedding model should now appear in the dropdown.
57
+
1. If you don't have an existing resource, choose **Create a new Azure AI Search resource**. Select **Next**.
58
+
59
+
1. Select the Azure OpenAI connection you want to use. Select **Next**.
69
60
70
-
:::image type="content" source="../media/index-retrieve/serverless-connection.png" alt-text="Screenshot of connect a serverless model." lightbox="../media/index-retrieve/serverless-connection.png":::
71
-
72
-
1. Select **Next** after configuring search settings
73
-
1. In the **Index settings**
74
-
1. Enter a name for your index or use the autopopulated name
75
-
1. Schedule updates. You can choose to update the index hourly or daily.
76
-
1. Choose the compute where you want to run the jobs to create the index. You can
77
-
- Auto select to allow Azure AI to choose an appropriate VM size that is available
78
-
- Choose a VM size from a list of recommended options
79
-
- Choose a VM size from a list of all possible options
80
-
81
-
:::image type="content" source="../media/index-retrieve/index-settings.png" alt-text="Screenshot of configure index settings." lightbox="../media/index-retrieve/index-settings.png":::
82
-
83
-
1. Select **Next** after configuring index settings
61
+
1. Enter a name you want to use for your vector index. Select **Next**.
84
62
1. Review the details you entered and select **Create**
85
63
1. You're taken to the index details page where you can see the status of your index creation.
86
64
87
-
## Create an index from the Playground
88
-
1. Open your AI Studio project.
89
-
1. Navigate to the Playground tab.
90
-
1. The Select available project index is displayed for existing indexes in the project. If an existing index isn't being used, continue to the next steps.
91
-
1. Select the Add your data dropdown.
92
-
93
-
:::image type="content" source="../media/index-retrieve/add-data-dropdown.png" alt-text="Screenshot of the playground add your data dropdown." lightbox="../media/index-retrieve/add-data-dropdown.png":::
94
-
95
-
1. If a new index is being created, select the ***Add your data*** option. Then follow the steps from ***Create an index from the Indexes tab*** to navigate through the wizard to create an index.
96
-
1. If there's an external index that is being used, select the ***Connect external index*** option.
97
-
1. In the **Index Source**
98
-
1. Select your data source
99
-
1. Select your AI Search Service
100
-
1. Select the index to be used.
101
-
102
-
:::image type="content" source="../media/index-retrieve/connect-external-index.png" alt-text="Screenshot of the page where you select an index." lightbox="../media/index-retrieve/connect-external-index.png":::
103
-
104
-
1. Select **Next** after configuring search settings.
105
-
1. In the **Index settings**
106
-
1. Enter a name for your index or use the autopopulated name
107
-
1. Schedule updates. You can choose to update the index hourly or daily.
108
-
1. Choose the compute where you want to run the jobs to create the index. You can
109
-
- Auto select to allow Azure AI to choose an appropriate VM size that is available
110
-
- Choose a VM size from a list of recommended options
111
-
- Choose a VM size from a list of all possible options
112
-
1. Review the details you entered and select **Create.**
113
-
1. The index is now ready to be used in the Playground.
114
-
115
65
116
66
## Use an index in prompt flow
117
67
118
68
1. Sign in to [Azure AI Studio](https://ai.azure.com) and select your project.
119
-
1. From the collapsible left menu, select **Prompt flow**.
69
+
1. From the collapsible left menu, select **Prompt flow** from the **Build and customize** section.
120
70
1. Open an existing prompt flow or select **+ Create** to create a new flow.
121
71
1. On the top menu of the flow designer, select **More tools**, and then select ***Index Lookup***.
122
72
123
73
:::image type="content" source="../media/index-retrieve/index-lookup-tool.png" alt-text="Screenshot of Vector index Lookup from More Tools." lightbox="../media/index-retrieve/index-lookup-tool.png":::
124
74
125
75
1. Provide a name for your Index Lookup Tool and select **Add**.
126
-
1. Select the **mlindex_content** value box, and select your index. After completing this step, enter the queries and **query_types** to be performed against the index.
76
+
1. Select the **mlindex_content** value box, and select your index from the value section. After completing this step, enter the queries and **query_types** to be performed against the index.
127
77
128
78
:::image type="content" source="../media/index-retrieve/configure-index-lookup-tool.png" alt-text="Screenshot of the prompt flow node to configure index lookup." lightbox="../media/index-retrieve/configure-index-lookup-tool.png":::
129
79
80
+
:::image type="content" source="../media/index-retrieve/generate-index.png" alt-text="Screenshot of the prompt flow node to generate an index." lightbox="../media/index-retrieve/generate-index.png":::
0 commit comments