refine according to reviewer comments

ChenJieting · ChenJieting · commit c720fdd9a207 · 2023-09-05T09:31:48.000+08:00
diff --git a/articles/machine-learning/prompt-flow/media/faq/switch-to-raw-file-mode.png b/articles/machine-learning/prompt-flow/media/faq/switch-to-raw-file-mode.png
diff --git a/articles/machine-learning/prompt-flow/media/faq/update-tool-name.png b/articles/machine-learning/prompt-flow/media/faq/update-tool-name.png
diff --git a/articles/machine-learning/prompt-flow/tools-reference/faiss-index-lookup-tool.md b/articles/machine-learning/prompt-flow/tools-reference/faiss-index-lookup-tool.md
@@ -26,7 +26,7 @@ Faiss Index Lookup is a tool tailored for querying within a user-provided Faiss-
     | workspace datastores or workspace default blob | AzureML Data Scientist |
     | other blobs | Storage Blob Data Reader |
 > [!NOTE]
-> When legacy tools switching to code first mode, if you encounter "'embeddingstore.tool.faiss_index_lookup.search' is not found" error, please refer to the [Troubleshooting Guidance](./troubleshooting-guidance.md).
+> When legacy tools switching to code first mode, if you encounter "'embeddingstore.tool.faiss_index_lookup.search' is not found" error, please refer to the [Troubleshoot Guidance](./troubleshoot-guidance.md).
 
 ## Inputs
 
diff --git a/articles/machine-learning/prompt-flow/tools-reference/troubleshoot-guidance.md b/articles/machine-learning/prompt-flow/tools-reference/troubleshoot-guidance.md
@@ -1,5 +1,5 @@
 ---
-title: Troubleshooting Guidance
+title: Troubleshoot Guidance
 titleSuffix: Azure Machine Learning
 description: This article addresses frequent questions about tool usage.
 services: machine-learning
@@ -12,7 +12,7 @@ ms.reviewer: lagayhar
 ms.date: 09/05/2023
 ---
 
-# Troubleshooting Guidance
+# Troubleshoot Guidance
 
 This article addresses frequent questions about tool usage.
 
@@ -27,9 +27,9 @@ To resolve the issue, you have two options:
 - **Option 1**
   - Update your runtime to latest version. 
   - Click on "Raw file mode" to switch to the raw code view, then open the "flow.dag.yaml" file.
-     ![switch-to-raw-file-mode](../media/faq/switch_to_raw_file_mode.png)
+     ![how-to-switch-to-raw-file-mode](../media/faq/switch-to-raw-file-mode.png)
   - Update the tool names.
-     ![update-tool-name](../media/faq/update_tool_name.png)
+     ![how-to-update-tool-name](../media/faq/update-tool-name.png)
      
       | Tool | New tool name |
       | ---- | ---- |
diff --git a/articles/machine-learning/prompt-flow/tools-reference/vector-db-lookup-tool.md b/articles/machine-learning/prompt-flow/tools-reference/vector-db-lookup-tool.md
@@ -45,7 +45,7 @@ The tool searches data from a third-party vector database. To use it, you should
     - Add "Weaviate" connection. Fill "API base" with your self-maintained instance address and fill "API key" field.
 
 > [!NOTE]
-> When legacy tools switching to code first mode, if you encounter "'embeddingstore.tool.vector_db_lookup.search' is not found" error, please refer to the [Troubleshooting Guidance](./troubleshooting-guidance.md).
+> When legacy tools switching to code first mode, if you encounter "'embeddingstore.tool.vector_db_lookup.search' is not found" error, please refer to the [Troubleshoot Guidance](./troubleshoot-guidance.md).
 
 ## Inputs
 
@@ -91,12 +91,14 @@ The following is an example JSON format response returned by the tool, which inc
 - **Azure Cognitive Search:**
 
   For Azure Cognitive Search, the following fields are populated:
+
   | Field Name | Type | Description |
   | ---- | ---- | ----------- |
   | original_entity | dict | the original response json from search REST API|
   | score | float |  @search.score from the original entity, which evaluates the similarity between the entity and the query vector |
   | text | string | text of the entity|
   | vector | list | vector of the entity|
+
   <details>
     <summary>Output</summary>
     
@@ -122,6 +124,7 @@ The following is an example JSON format response returned by the tool, which inc
 - **Qdrant:**
 
   For Qdrant, the following fields are populated:
+
   | Field Name | Type | Description |
   | ---- | ---- | ----------- |
   | original_entity | dict | the original response json from search REST API|
@@ -159,6 +162,7 @@ The following is an example JSON format response returned by the tool, which inc
 - **Weaviate:**
 
   For Weaviate, the following fields are populated:
+  
   | Field Name | Type | Description |
   | ---- | ---- | ----------- |
   | original_entity | dict | the original response json from search REST API|
diff --git a/articles/machine-learning/prompt-flow/tools-reference/vector-index-lookup-tool.md b/articles/machine-learning/prompt-flow/tools-reference/vector-index-lookup-tool.md
@@ -30,7 +30,7 @@ Vector index lookup is a tool tailored for querying within an Azure Machine Lear
     | workspace datastores or workspace default blob | AzureML Data Scientist |
     | other blobs | Storage Blob Data Reader |
 > [!NOTE]
-> When legacy tools switching to code first mode, if you encounter "'embeddingstore.tool.vector_index_lookup.search' is not found" error, please refer to the [Troubleshooting Guidance](./troubleshooting-guidance.md).
+> When legacy tools switching to code first mode, if you encounter "'embeddingstore.tool.vector_index_lookup.search' is not found" error, please refer to the [Troubleshoot Guidance](./troubleshoot-guidance.md).
 
 ## Inputs
 
