Skip to content

Commit e0b6a72

Browse files
committed
final touchups
1 parent f1928b8 commit e0b6a72

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

articles/machine-learning/how-to-retrieval-augmented-generation-cloud-to-local.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -27,16 +27,16 @@ In this article, you learn how to transition RAG flows from your Azure Machine L
2727
2828
## Prerequisites
2929

30-
- Python 3.9 or above installed locally.
30+
- Python installed locally
3131

32-
- The `promptflow` SDK and `promptflow-tools` packages installed by running<br>`pip install promptflow promptflow-tools`.
33-
- The `promptflow-vectordb` tool installed by running<br>`pip install promptflow-vectordb`.
32+
- The **promptflow** SDK and **promptflow-tools** packages installed by running<br>`pip install promptflow promptflow-tools`
33+
- The **promptflow-vectordb** tool installed by running<br>`pip install promptflow-vectordb`
3434

35-
- Visual Studio Code with the **Python** and **Prompt flow** extensions installed.
35+
- Visual Studio Code with the **Python** and **Prompt flow** extensions installed
3636

3737
:::image type="content" source="./media/how-to-retrieval-augmented-generation-cloud-to-local/vs-code-extension.png" alt-text="Screenshot of the prompt flow VS Code extension in the marketplace.":::
3838

39-
- An [Azure OpenAI account resource](/azure/ai-services/openai/how-to/create-resource#create-a-resource) that has [model deployments](/azure/ai-services/openai/how-to/create-resource#deploy-a-model) for both **chat** and **text-embedding-ada**.
39+
- An [Azure OpenAI account resource](/azure/ai-services/openai/how-to/create-resource#create-a-resource) that has [model deployments](/azure/ai-services/openai/how-to/create-resource#deploy-a-model) for both **chat** and **text-embedding-ada**
4040

4141
- A [vector index created](how-to-create-vector-index.md) in Azure Machine Learning studio for the example prompt flow to use.
4242

@@ -80,7 +80,7 @@ The rest of this article details how to use the VS Code Prompt flow extension to
8080

8181
:::image type="content" source="./media/how-to-retrieval-augmented-generation-cloud-to-local/vs-code-extension-toolbar.png" alt-text="Screenshot of the prompt flow VS Code extension icon in the VS Code left menu.":::
8282

83-
1. If necessary, select **Install dependencies** and make sure the correct Python interpreter is selected, and the `promptflow` and `promptflow-tools` packages are installed.
83+
1. Select **Install dependencies** in the management pane and make sure the correct Python interpreter is selected, and the **promptflow** and **promptflow-tools** packages are installed.
8484

8585
### Create the connections
8686

@@ -96,7 +96,7 @@ To use the vector index lookup tool locally, you need to create the same connect
9696

9797
1. Select the **Create connection** link at the bottom of the file. The app runs to create the connection. When prompted, enter the API key for your connection in the terminal.
9898

99-
1. Also create a new Azure AI Search connection for the new version of the local vector index lookup tool to use. For more information, see [Index Lookup tool for Azure Machine Learning (Preview)](prompt-flow/tools-reference/index-lookup-tool.md) and [Package tool isn't found error](prompt-flow/tools-reference/troubleshoot-guidance.md#package-tool-isnt-found-error-occurs-when-you-update-the-flow-for-a-code-first-experience).
99+
1. If you used an Azure AI Search index as the data source for your vector index, also create a new Azure AI Search connection for the local vector index lookup tool to use. For more information, see [Index Lookup tool for Azure Machine Learning (Preview)](prompt-flow/tools-reference/index-lookup-tool.md).
100100

101101
### Check the files
102102

@@ -117,13 +117,16 @@ To use the vector index lookup tool locally, you need to create the same connect
117117

118118
:::image type="content" source="./media/how-to-retrieval-augmented-generation-cloud-to-local/search-tool.png" alt-text="Screenshot of the tool section of the lookup node.":::
119119

120-
1. Scroll to the **generate_prompt_context** node, and in the raw *flow.dag.yaml* file, select the **Open code file** link.
120+
>[!NOTE]
121+
>If you have any issues with the local `promptflow_vectordb` tool, see [Package tool isn't found error](prompt-flow/tools-reference/troubleshoot-guidance.md#package-tool-isnt-found-error-occurs-when-you-update-the-flow-for-a-code-first-experience) and [Migrate from legacy tools to the Index Lookup tool](/azure/ai-studio/how-to/prompt-flow-tools/index-lookup-tool#migrate-from-legacy-tools-to-the-index-lookup-tool) for troubleshooting.
122+
123+
1. Scroll to the **generate_prompt_context** node, and in the raw *flow.dag.yaml* file, select the **Open code file** link.
121124

122125
1. In the Python code file, make sure the package name of the vector tool is `promptflow_vectordb`.
123126

124127
:::image type="content" source="./media/how-to-retrieval-augmented-generation-cloud-to-local/generate-node.png" alt-text="Screenshot of the Python code file with the vector tool package name highlighted.":::
125128

126-
1. Scroll to the **answer_the_question_with_context** node and make sure the connection is the same as the local connection you created. Check the **deployment_name**, which is the model you use here for the embedding.
129+
1. Scroll to the **answer_the_question_with_context** node and make sure it uses the local connection you created. Check the **deployment_name**, which is the model you use here for the embedding.
127130

128131
:::image type="content" source="./media/how-to-retrieval-augmented-generation-cloud-to-local/answer-connection.png" alt-text="Screenshot of answer the question with context node with the connection highlighted.":::
129132

0 commit comments

Comments
 (0)