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/prompt-flow-tools/index-lookup-tool.md
+8-7Lines changed: 8 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -143,24 +143,25 @@ The following JSON format response is an example returned by the tool that inclu
143
143
144
144
145
145
## How to migrate from legacy tools to the Index Lookup tool
146
-
Previously, in prompt flow for Azure AI Studio there were three different tools for looking up a vector index: the Faiss Index Lookup tool, the Vector DB Lookup Tool, and the Vector Index Lookup tool. We have combined and simplified these three tools into one new tool, known as the [*Index Lookup* tool](./index-lookup-tool.md). The *Index Lookup* tool enables the usage of common vector indices (such as Azure AI Search, FAISS, and Pinecone) for retrieval augmented generation (RAG) in prompt flow. The tool automatically detects the indices in the workspace and allows the selection of the index to be used in the flow. This article will help guide you through the process of upgrading from the legacy lookup tools to the new *Index Lookup* tool.
146
+
The Index Lookup tool looks to replace the three deprecated legacy index tools, the [Vector Index Lookup tool](./vector-index-lookup-tool.md), the [Vector DB Lookup tool](./vector-db-lookup-tool.md) and the [Faiss Index Lookup tool](./faiss-index-lookup-tool.md).
147
+
If you have a flow that contains one of these tools, follow the steps below to upgrade your flow.
147
148
148
-
## Upgrade your tools
149
+
###Upgrade your tools
149
150
150
151
1. Update your runtime. In order to do this navigate to the "AI project settings tab on the left blade in AI Studio. From there you should see a list of Prompt flow runtimes. Select the name of the runtime you want to update, and click on the “Update” button near the top of the panel. Wait for the runtime to update itself.
151
152
1. Navigate to your flow. You can do this by clicking on the “Prompt flow” tab on the left blade in AI Studio, clicking on the “Flows” pivot tab, and then clicking on the name of your flow.
152
153
153
154
1. Once inside the flow, click on the “+ More tools” button near the top of the pane. A dropdown should open and click on “Index Lookup [Preview]” to add an instance of the Index Lookup tool.
154
155
155
-
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/index-dropdown.png" alt-text="Screenshot of the Index Lookup tool added to a flow in Azure AI Studio." lightbox="../../media/prompt-flow/upgrade-index-tools/index-dropdown.png":::
156
+
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/index-dropdown.png" alt-text="Screenshot of the More Tools dropdown in promptflow." lightbox="../../media/prompt-flow/upgrade-index-tools/index-dropdown.png":::
156
157
157
158
1. Name the new node and click “Add”.
158
159
159
-
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/save-node.png" alt-text="Screenshot of the Index Lookup tool added to a flow in Azure AI Studio." lightbox="../../media/prompt-flow/upgrade-index-tools/save-node.png":::
160
+
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/save-node.png" alt-text="Screenshot of the index lookup node with name." lightbox="../../media/prompt-flow/upgrade-index-tools/save-node.png":::
160
161
161
162
1. In the new node, click on the “mlindex_content” textbox. This should be the first textbox in the list.
162
163
163
-
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/mlindex-box.png" alt-text="Screenshot of the Index Lookup tool added to a flow in Azure AI Studio." lightbox="../../media/prompt-flow/upgrade-index-tools/mlindex-box.png":::
164
+
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/mlindex-box.png" alt-text="Screenshot of the expanded Index Lookup node with the mlindex_content box outlined in red." lightbox="../../media/prompt-flow/upgrade-index-tools/mlindex-box.png":::
164
165
165
166
1. In the Generate drawer that appears, follow the instructions below to upgrade from the three legacy tools:
166
167
- If using the legacy **Vector Index Lookup** tool, select “Registered Index" in the “index_type” dropdown. Select your vector index asset from the “mlindex_asset_id” dropdown.
@@ -169,11 +170,11 @@ Previously, in prompt flow for Azure AI Studio there were three different tools
169
170
8. After filling in the necessary information, click save.
170
171
9. Upon returning to the node, there should be information populated in the “mlindex_content” textbox. Click on the “queries” textbox next, and select the search terms you want to query. You’ll want to select the same value as the input to the “embed_the_question” node, typically either “\${inputs.question}” or “${modify_query_with_history.output}” (the former if you’re in a standard flow and the latter if you’re in a chat flow).
171
172
172
-
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/mlindex-with-content.png" alt-text="Screenshot of the Index Lookup tool added to a flow in Azure AI Studio." lightbox="../../media/prompt-flow/upgrade-index-tools/mlindex-with-content.png":::
173
+
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/mlindex-with-content.png" alt-text="Screenshot of the expanded Index Lookup node with index information in the cells." lightbox="../../media/prompt-flow/upgrade-index-tools/mlindex-with-content.png":::
173
174
174
175
10. Select a query type by clicking on the dropdown next to “query_type.” “Vector” will produce identical results as the legacy flow, but depending on your index configuration, other options including "Hybrid" and "Semantic" may be available.
175
176
176
-
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/vector-search.png" alt-text="Screenshot of the Index Lookup tool added to a flow in Azure AI Studio." lightbox="../../media/prompt-flow/upgrade-index-tools/vector-search.png":::
177
+
:::image type="content" source="../../media/prompt-flow/upgrade-index-tools/vector-search.png" alt-text="Screenshot of the expanded Index Lookup node with vector search outlined in red." lightbox="../../media/prompt-flow/upgrade-index-tools/vector-search.png":::
177
178
178
179
11. Edit downstream components to consume the output of your newly added node, instead of the output of the legacy Vector Index Lookup node.
179
180
12. Delete the Vector Index Lookup node and its parent embedding node.
0 commit comments