From 5484f2dec8a4d27692f44e0bf4c1af9a2a9d99d7 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Wed, 18 Oct 2023 14:50:50 +0800
Subject: [PATCH 01/10] add enable by doc

---
 .../create-and-use-tool-package.md            |   3 +-
 .../develop-a-tool/how-to-use-enabled-by.md   | 106 ++++++++++++++++++
 docs/how-to-guides/develop-a-tool/index.md    |   1 +
 3 files changed, 109 insertions(+), 1 deletion(-)
 create mode 100644 docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md

diff --git a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
index 2c1ae207d8e..c6ebe7252a4 100644
--- a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
+++ b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
@@ -162,4 +162,5 @@ Alternatively, you can test your tool package using the script below to ensure t
 * If you encounter a `403 Forbidden Error`, it's likely due to a naming conflict with an existing package. You will need to choose a different name. Package names must be unique on PyPI to avoid confusion and conflicts among users. Before creating a new package, it's recommended to search PyPI (https://pypi.org/) to verify that your chosen name is not already taken. If the name you want is unavailable, consider selecting an alternative name or a variation that clearly differentiates your package from the existing one.
 
 ## Advanced features
-[Customize your tool icon](add-a-tool-icon.md)
\ No newline at end of file
+[Customize your tool icon](add-a-tool-icon.md)
+[How to use enabled by in the tool](how-to-use-enabled-by.md)
\ No newline at end of file
diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
new file mode 100644
index 00000000000..78c899a494d
--- /dev/null
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -0,0 +1,106 @@
+# How to use enabled by in the tool
+## Introduction
+This guide will instruct you on how to use the "enabled by" feature in the tool. The "enabled by" feature is designed to display which inputs are enabled when a customer uses a specific input type or input value. This feature is particularly beneficial if you wish to vary your inputs in response to different demands.
+
+We introduce parameter "enabled_by" in the tool yaml to determine which input is enabled by which other input.
+Concurrently, we support enabling an input by another input type or input value, Hence, we introduce two other parameters: "enabled_by_type" and "enabled_by_value".
+
+> Note: We don't recommend you to use the "enabled_by_type" and "enabled_by_value" at the same time. if you use them at the same time, the "enabled_by_type" will be ignored.
+
+## Prerequisites
+To proceed, it's crucial for you to understand the process of developing a tool and generating a tool yaml. For thorough insights and instructions, please refer to [Create and Use Tool Package](create-and-use-tool-package.md). 
+
+## How to support enabled by
+Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" type. When the "connection" type is AzureOpenAIConnection, the "deployment_name" input is enabled and displayed. When the "connection" type is OpenAIConnection, the "model" input is enabled and displayed. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml:
+
+
+### Step 1: Support "enabled by" in the tool package
+All inputs will be passed to the tool, allowing you to define your own set of rules to determine which input to use. Here is an example of how you can support the "enabled by" feature in your tool package:
+
+
+```python
+from enum import Enum
+from typing import Union
+
+import openai
+
+from promptflow.connections import AzureOpenAIConnection, OpenAIConnection
+from promptflow._internal import tool
+from promptflow.tools.exception import InvalidConnectionType
+
+
+class EmbeddingModel(str, Enum):
+    TEXT_EMBEDDING_ADA_002 = "text-embedding-ada-002"
+    TEXT_SEARCH_ADA_DOC_001 = "text-search-ada-doc-001"
+    TEXT_SEARCH_ADA_QUERY_001 = "text-search-ada-query-001"
+
+
+@tool
+def embedding(connection: Union[AzureOpenAIConnection, OpenAIConnection], input: str, deployment_name: str = "", model: EmbeddingModel = EmbeddingModel.TEXT_EMBEDDING_ADA_002):
+    connection_dict = dict(connection)
+    # if the connection type is AzureOpenAIConnection, use the deployment_name input.
+    if isinstance(connection, AzureOpenAIConnection):
+        return openai.Embedding.create(
+            input=input,
+            engine=deployment_name,
+            **connection_dict,
+        )["data"][0]["embedding"]
+    # if the connection type is OpenAIConnection, use the model input.
+    elif isinstance(connection, OpenAIConnection):
+        return openai.Embedding.create(
+            input=input,
+            model=model,
+            **connection_dict,
+        )["data"][0]["embedding"]
+    else:
+        error_message = f"Not Support connection type '{type(connection).__name__}' for embedding api. " \
+                        f"Connection type should be in [AzureOpenAIConnection, OpenAIConnection]."
+        raise InvalidConnectionType(message=error_message)
+```
+
+### Step 2: Support "enabled by" in the tool yaml
+Once you have generated a tool yaml, you can incorporate the 'enabled by' feature into it. Here is an example showcasing the use of 'enabled_by_type' in the tool yaml:
+
+```yaml
+promptflow.tools.embedding.embedding:
+  name: Embedding
+  description: Use Open AI's embedding model to create an embedding vector representing the input text.
+  type: python
+  module: promptflow.tools.embedding
+  function: embedding
+  inputs:
+    connection:
+      type: [AzureOpenAIConnection, OpenAIConnection]
+    deployment_name:
+      type:
+      - string
+      # The input deployment_name is enabled by connection
+      enabled_by: connection
+      # When the connection type is AzureOpenAIConnection, deployment_name is enabled and displayed.
+      enabled_by_type: [AzureOpenAIConnection]
+      capabilities:
+        completion: false
+        chat_completion: false
+        embeddings: true
+      model_list:
+      - text-embedding-ada-002
+      - text-search-ada-doc-001
+      - text-search-ada-query-001
+    model:
+      type:
+      - string
+      # the input model is enabled by connection
+      enabled_by: connection
+      # When the connection type is OpenAIConnection, model is enabled and displayed.
+      enabled_by_type: [OpenAIConnection]
+      enum:
+      - text-embedding-ada-002
+      - text-search-ada-doc-001
+      - text-search-ada-query-001
+    input:
+      type:
+      - string
+```
+
+> Note: Both "enabled_by_type" and "enabled_by_value" are list types, which means you can use multiple inputs to enable a single input. For instance, if "enabled_by_type" is [AzureOpenAIConnection, OpenAIConnection], the input will be enabled when the connection type is either AzureOpenAIConnection or OpenAIConnection.
+
diff --git a/docs/how-to-guides/develop-a-tool/index.md b/docs/how-to-guides/develop-a-tool/index.md
index 87c8525639d..71d22c503b8 100644
--- a/docs/how-to-guides/develop-a-tool/index.md
+++ b/docs/how-to-guides/develop-a-tool/index.md
@@ -7,4 +7,5 @@ We provide guides on how to develop a tool and use it.
 
 create-and-use-tool-package
 add-a-tool-icon
+how-to-use-enabled-by
 ```
\ No newline at end of file

From de338b3c3df49c117dee7a411f15af19823ea3f4 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Wed, 18 Oct 2023 15:37:50 +0800
Subject: [PATCH 02/10] add pic

---
 .../develop-a-tool/how-to-use-enabled-by.md   |  23 ++++++++++--------
 .../develop-a-tool/enabled_by_type.png        | Bin 0 -> 16095 bytes
 2 files changed, 13 insertions(+), 10 deletions(-)
 create mode 100644 docs/media/how-to-guides/develop-a-tool/enabled_by_type.png

diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index 78c899a494d..6e460aa8a3a 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -1,21 +1,21 @@
-# How to use enabled by in the tool
+# How to use enabled by in the tool package
 ## Introduction
-This guide will instruct you on how to use the "enabled by" feature in the tool. The "enabled by" feature is designed to display which inputs are enabled when a customer uses a specific input type or input value. This feature is particularly beneficial if you wish to vary your inputs in response to different demands.
+This guide will instruct you on how to use the "enabled by" feature in the tool package. The "enabled by" feature is designed to display which inputs are enabled when a customer uses a specific input type or input value. This feature is particularly useful if you need to adapt your inputs based on varying requirements.
 
 We introduce parameter "enabled_by" in the tool yaml to determine which input is enabled by which other input.
-Concurrently, we support enabling an input by another input type or input value, Hence, we introduce two other parameters: "enabled_by_type" and "enabled_by_value".
+Concurrently, we support enabling an input by another input type or input value, Hence, we introduce two additional parameters: "enabled_by_type" and "enabled_by_value".
 
-> Note: We don't recommend you to use the "enabled_by_type" and "enabled_by_value" at the same time. if you use them at the same time, the "enabled_by_type" will be ignored.
+> Note: We do not recommend using 'enabled_by_type' and 'enabled_by_value' simultaneously. If both are used, 'enabled_by_type' will be ignored.
 
 ## Prerequisites
 To proceed, it's crucial for you to understand the process of developing a tool and generating a tool yaml. For thorough insights and instructions, please refer to [Create and Use Tool Package](create-and-use-tool-package.md). 
 
 ## How to support enabled by
-Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" type. When the "connection" type is AzureOpenAIConnection, the "deployment_name" input is enabled and displayed. When the "connection" type is OpenAIConnection, the "model" input is enabled and displayed. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml:
+Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" type. When the "connection" type is AzureOpenAIConnection, the "deployment_name" input is enabled and displayed. When the "connection" type is OpenAIConnection, the "model" input is enabled and displayed. You need to support enable by in two part: tool and tool yaml. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml.
 
 
-### Step 1: Support "enabled by" in the tool package
-All inputs will be passed to the tool, allowing you to define your own set of rules to determine which input to use. Here is an example of how you can support the "enabled by" feature in your tool package:
+### Step 1: Support "enabled by" in the tool
+All inputs will be passed to the tool, allowing you to define your own set of rules to determine which input to use. Here is an example of how you can support the "enabled by" feature in your tool:
 
 
 ```python
@@ -38,14 +38,14 @@ class EmbeddingModel(str, Enum):
 @tool
 def embedding(connection: Union[AzureOpenAIConnection, OpenAIConnection], input: str, deployment_name: str = "", model: EmbeddingModel = EmbeddingModel.TEXT_EMBEDDING_ADA_002):
     connection_dict = dict(connection)
-    # if the connection type is AzureOpenAIConnection, use the deployment_name input.
+    # If the connection type is AzureOpenAIConnection, use the deployment_name input.
     if isinstance(connection, AzureOpenAIConnection):
         return openai.Embedding.create(
             input=input,
             engine=deployment_name,
             **connection_dict,
         )["data"][0]["embedding"]
-    # if the connection type is OpenAIConnection, use the model input.
+    # If the connection type is OpenAIConnection, use the model input.
     elif isinstance(connection, OpenAIConnection):
         return openai.Embedding.create(
             input=input,
@@ -89,7 +89,7 @@ promptflow.tools.embedding.embedding:
     model:
       type:
       - string
-      # the input model is enabled by connection
+      # The input model is enabled by connection
       enabled_by: connection
       # When the connection type is OpenAIConnection, model is enabled and displayed.
       enabled_by_type: [OpenAIConnection]
@@ -104,3 +104,6 @@ promptflow.tools.embedding.embedding:
 
 > Note: Both "enabled_by_type" and "enabled_by_value" are list types, which means you can use multiple inputs to enable a single input. For instance, if "enabled_by_type" is [AzureOpenAIConnection, OpenAIConnection], the input will be enabled when the connection type is either AzureOpenAIConnection or OpenAIConnection.
 
+After you build and share the tool package generated with the above steps, you can use your tool from VSCode Extension. When you select a connection with azure openai type, only deployment_name input is enabled and displayed.
+
+![enabled_by_type.png](../../media/how-to-guides/develop-a-tool/enabled_by_type.png)
diff --git a/docs/media/how-to-guides/develop-a-tool/enabled_by_type.png b/docs/media/how-to-guides/develop-a-tool/enabled_by_type.png
new file mode 100644
index 0000000000000000000000000000000000000000..955b3311adb5412423410c1f1d803ae429f801bc
GIT binary patch
literal 16095
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

literal 0
HcmV?d00001


From df107636ba711cd7235415a1682675673bcdf609 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Wed, 18 Oct 2023 16:27:54 +0800
Subject: [PATCH 03/10] add more details

---
 docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index 6e460aa8a3a..97f4ad42c26 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -104,6 +104,8 @@ promptflow.tools.embedding.embedding:
 
 > Note: Both "enabled_by_type" and "enabled_by_value" are list types, which means you can use multiple inputs to enable a single input. For instance, if "enabled_by_type" is [AzureOpenAIConnection, OpenAIConnection], the input will be enabled when the connection type is either AzureOpenAIConnection or OpenAIConnection.
 
-After you build and share the tool package generated with the above steps, you can use your tool from VSCode Extension. When you select a connection with azure openai type, only deployment_name input is enabled and displayed.
+After you build and share the tool package with "enabled_by" feature, you can use your tool from VSCode Extension. When you select a connection with "AzureOpenAIConnection" type, only "deployment_name" input is enabled and displayed.
 
 ![enabled_by_type.png](../../media/how-to-guides/develop-a-tool/enabled_by_type.png)
+
+> Note: "enabled_by_value" is similar to "enabled_by_type", but it enables an input by a specific input value. For instance, if "enabled_by_value" is ["azure-openai-connection", "openai-connection"], the input will be enabled when the connection value is either "azure-openai-connection" or "openai-connection".

From c24a9ed72598369a69e70a5418435e8deea71636 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Fri, 20 Oct 2023 14:32:23 +0800
Subject: [PATCH 04/10] fix conflict

---
 docs/how-to-guides/develop-a-tool/index.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/how-to-guides/develop-a-tool/index.md b/docs/how-to-guides/develop-a-tool/index.md
index 2ce25b44c90..ffd7b77da60 100644
--- a/docs/how-to-guides/develop-a-tool/index.md
+++ b/docs/how-to-guides/develop-a-tool/index.md
@@ -7,9 +7,6 @@ We provide guides on how to develop a tool and use it.
 
 create-and-use-tool-package
 add-a-tool-icon
-<<<<<<< HEAD
-how-to-use-enabled-by
-=======
 add-category-and-tags-for-tool
->>>>>>> main
+how-to-use-enabled-by
 ```
\ No newline at end of file

From 9e0d421bd28ff17546365ad9f7eb9e803ef3419d Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Fri, 20 Oct 2023 14:35:26 +0800
Subject: [PATCH 05/10] fix conflict

---
 .../develop-a-tool/create-and-use-tool-package.md         | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
index 3a427e8205c..047fa4f5aee 100644
--- a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
+++ b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
@@ -162,10 +162,6 @@ Alternatively, you can test your tool package using the script below to ensure t
 * If you encounter a `403 Forbidden Error`, it's likely due to a naming conflict with an existing package. You will need to choose a different name. Package names must be unique on PyPI to avoid confusion and conflicts among users. Before creating a new package, it's recommended to search PyPI (https://pypi.org/) to verify that your chosen name is not already taken. If the name you want is unavailable, consider selecting an alternative name or a variation that clearly differentiates your package from the existing one.
 
 ## Advanced features
-<<<<<<< HEAD
-[Customize your tool icon](add-a-tool-icon.md)
-[How to use enabled by in the tool](how-to-use-enabled-by.md)
-=======
-[Customize your tool icon](add-a-tool-icon.md)  
+[Customize your tool icon](add-a-tool-icon.md)    
 [Add category and tags for tool](add-category-and-tags-for-tool.md)  
->>>>>>> main
+[How to use enabled by in the tool package](how-to-use-enabled-by.md)

From 94f7113397f5adc6f92b53ff9b7d648e1d10c1f3 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Fri, 20 Oct 2023 14:41:51 +0800
Subject: [PATCH 06/10] fix comments

---
 .../develop-a-tool/how-to-use-enabled-by.md        | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index 382b63c3d77..62e610be058 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -10,7 +10,7 @@ Concurrently, we support enabling an input by another input type or input value,
 ## Prerequisites
 To proceed, it's crucial for you to understand the process of developing a tool and generating a tool yaml. For thorough insights and instructions, please refer to [Create and Use Tool Package](create-and-use-tool-package.md). 
 
-## How to use 'enabled_by_type'
+## How to use "enabled_by_type"
 Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" type. When the "connection" type is AzureOpenAIConnection, the "deployment_name" input is enabled and displayed. When the "connection" type is OpenAIConnection, the "model" input is enabled and displayed. You need to support enable by in two part: tool and tool yaml. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml.
 
 
@@ -63,7 +63,7 @@ def embedding(connection: Union[AzureOpenAIConnection, OpenAIConnection], input:
 ```
 
 ### Step 2: Support "enabled_by_type" in the tool yaml
-Once you have generated a tool yaml, you can incorporate the 'enabled by' feature into it. Here is an example showcasing the use of 'enabled_by_type' in the tool yaml:
+Once you have generated a tool yaml, you can incorporate the "enabled_by_type" into it. Here is an example showcasing the use of 'enabled_by_type' in the tool yaml:
 
 ```yaml
 promptflow.tools.embedding.embedding:
@@ -108,7 +108,7 @@ promptflow.tools.embedding.embedding:
 
 
 
-## How to use 'enabled_by_value'
+## How to use "enabled_by_value"
 Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" value. When the "connection" value is "azure-open-ai-connection", the "deployment_name" input is enabled and displayed. When the "connection" value is "open-ai-connection", the "model" input is enabled and displayed. You need to support enable by in two part: tool and tool yaml. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml.
 
 
@@ -140,14 +140,14 @@ class ConnectionName(str, Enum):
 @tool
 def embedding(connection: Enum, input: str, deployment_name: str = "", model: EmbeddingModel = EmbeddingModel.TEXT_EMBEDDING_ADA_002):
     connection_dict = dict(connection)
-    # If the connection type is AzureOpenAIConnection, use the deployment_name input.
+    # If the connection value is azure-open-ai-connection, use the deployment_name input.
     if connection == ConnectionName.Azure_Open_AI_CONNECTION:
         return openai.Embedding.create(
             input=input,
             engine=deployment_name,
             **connection_dict,
         )["data"][0]["embedding"]
-    # If the connection type is OpenAIConnection, use the model input.
+    # If the connection type is open-ai-connection, use the model input.
     elif connection == ConnectionName.OPEN_AI_CONNECTION:
         return openai.Embedding.create(
             input=input,
@@ -182,7 +182,7 @@ promptflow.tools.embedding.embedding:
       - string
       # The input deployment_name is enabled by connection
       enabled_by: connection
-      # When the connection type is AzureOpenAIConnection, deployment_name is enabled and displayed.
+      # When the connection value is azure-open-ai-connection, deployment_name is enabled and displayed.
       enabled_by_value: [azure-open-ai-connection]
       capabilities:
         completion: false
@@ -197,7 +197,7 @@ promptflow.tools.embedding.embedding:
       - string
       # The input model is enabled by connection
       enabled_by: connection
-      # When the connection type is OpenAIConnection, model is enabled and displayed.
+      # When the connection value is open-ai-connection, model is enabled and displayed.
       enabled_by_value: [open-ai-connection]
       enum:
       - text-embedding-ada-002

From 974364ed27a9ca0008112cb8c7c49999125422b3 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Fri, 20 Oct 2023 14:44:41 +0800
Subject: [PATCH 07/10] refine the doc

---
 .../how-to-guides/develop-a-tool/how-to-use-enabled-by.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index 62e610be058..e51b69baeab 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -5,7 +5,9 @@ This guide will instruct you on how to use the "enabled by" feature in the tool
 We introduce parameter "enabled_by" in the tool yaml to determine which input is enabled by which other input.
 Concurrently, we support enabling an input by another input type or input value, Hence, we introduce two additional parameters: "enabled_by_type" and "enabled_by_value".
 
-> Note: We do not recommend using "enabled_by_type" and "enabled_by_value" simultaneously. If both are used, "enabled_by_type" will be ignored.
+> Note 1: We do not recommend using "enabled_by_type" and "enabled_by_value" simultaneously. If both are used, "enabled_by_type" will be ignored.
+
+> Note 2: Both "enabled_by_type" and "enabled_by_value" in tool yaml are list types, which means you can use multiple inputs to enable a single input. For instance, if "enabled_by_type" is [AzureOpenAIConnection, OpenAIConnection], the input will be enabled when the connection type is either AzureOpenAIConnection or OpenAIConnection.
 
 ## Prerequisites
 To proceed, it's crucial for you to understand the process of developing a tool and generating a tool yaml. For thorough insights and instructions, please refer to [Create and Use Tool Package](create-and-use-tool-package.md). 
@@ -63,7 +65,7 @@ def embedding(connection: Union[AzureOpenAIConnection, OpenAIConnection], input:
 ```
 
 ### Step 2: Support "enabled_by_type" in the tool yaml
-Once you have generated a tool yaml, you can incorporate the "enabled_by_type" into it. Here is an example showcasing the use of 'enabled_by_type' in the tool yaml:
+Once you have generated a tool yaml, you can incorporate the "enabled_by_type" into it. Here is an example showcasing the use of "enabled_by_type" in the tool yaml:
 
 ```yaml
 promptflow.tools.embedding.embedding:
@@ -208,8 +210,6 @@ promptflow.tools.embedding.embedding:
       - string
 ```
 
-> Note: Both "enabled_by_type" and "enabled_by_value" in tool yaml are list types, which means you can use multiple inputs to enable a single input. For instance, if "enabled_by_type" is [AzureOpenAIConnection, OpenAIConnection], the input will be enabled when the connection type is either AzureOpenAIConnection or OpenAIConnection.
-
 ## Use the tool from VSCode Extension
 After you build and share the tool package with "enabled_by" feature, you can use your tool from VSCode Extension according to [Create and Use Tool Package](create-and-use-tool-package.md). For instance, when you select a connection with "AzureOpenAIConnection" type, only "deployment_name" input is enabled and displayed for "enabled_by_type" example.
 

From ed8dccfb567174a8c20b1c1d8b5857133f14a0c8 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Mon, 23 Oct 2023 15:06:30 +0800
Subject: [PATCH 08/10] fix comments

---
 .../create-and-use-tool-package.md            |  2 +-
 .../develop-a-tool/how-to-use-enabled-by.md   | 25 +++++++++----------
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
index 047fa4f5aee..dce803d9226 100644
--- a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
+++ b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
@@ -164,4 +164,4 @@ Alternatively, you can test your tool package using the script below to ensure t
 ## Advanced features
 [Customize your tool icon](add-a-tool-icon.md)    
 [Add category and tags for tool](add-category-and-tags-for-tool.md)  
-[How to use enabled by in the tool package](how-to-use-enabled-by.md)
+[Use Enabled_By to Support Cascading Settings between Inputs for Tool](how-to-use-enabled-by.md)
diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index e51b69baeab..daca68a2564 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -1,20 +1,19 @@
-# How to use enabled by in the tool package
+# Use Enabled_By to Support Cascading Settings between Inputs for Tool
 
-This guide will instruct you on how to use the "enabled by" feature in the tool package. The "enabled by" feature is designed to display which inputs are enabled when a customer uses a specific input type or input value. This feature is particularly useful if you need to adapt your inputs based on varying requirements.
-
-We introduce parameter "enabled_by" in the tool yaml to determine which input is enabled by which other input.
-Concurrently, we support enabling an input by another input type or input value, Hence, we introduce two additional parameters: "enabled_by_type" and "enabled_by_value".
-
-> Note 1: We do not recommend using "enabled_by_type" and "enabled_by_value" simultaneously. If both are used, "enabled_by_type" will be ignored.
-
-> Note 2: Both "enabled_by_type" and "enabled_by_value" in tool yaml are list types, which means you can use multiple inputs to enable a single input. For instance, if "enabled_by_type" is [AzureOpenAIConnection, OpenAIConnection], the input will be enabled when the connection type is either AzureOpenAIConnection or OpenAIConnection.
+This guide will instruct you on how to use the "enabled by" feature in the tool package. The "enabled by" feature is designed to support cascading settings between inputs for tool. 
+Cascading settings between inputs are frequently used in situations where the selection in one input field determines what sebsequent inputs should be shown. 
+This approach help in creating a more efficient, user-friendly, and error-free input process. To support cascading settings between tool inputs, we've introduced following two configurations:
+* "enabled_by + enabled_by_type": This setting enabled the current input based on the value type of the input shown in "enabled_by" field.
+* "enabled_by + enabled_by_value": This setting enabled the current input based on the actual value of the input shown in "enabled_by" field.
 
+> Note: The "enabled_by_type" and "enabled_by_value" configurations should not be used simultaneously for the same input. Both enabled_by_type and enabled_by_value in the tool yaml are of list type, implying that a single input can be enabled by multiple values from the dependent input.
 ## Prerequisites
 To proceed, it's crucial for you to understand the process of developing a tool and generating a tool yaml. For thorough insights and instructions, please refer to [Create and Use Tool Package](create-and-use-tool-package.md). 
 
-## How to use "enabled_by_type"
-Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" type. When the "connection" type is AzureOpenAIConnection, the "deployment_name" input is enabled and displayed. When the "connection" type is OpenAIConnection, the "model" input is enabled and displayed. You need to support enable by in two part: tool and tool yaml. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml.
-
+## Use "enabled_by + enabled_by_type" in tool
+Here we take [this existing tool](https://github.com/microsoft/promptflow/blob/eeb1df65e55d93e1a6fe30f58adda1e9d241db61/src/promptflow-tools/promptflow/tools/embedding.py) as example, this tool has four inputs: "connection", "input", "deployment_name", and "model". 
+The "deployment_name" and "model" are enabled by the type of input "connection". When the type of "connection" input is AzureOpenAIConnection, the "deployment_name" input is enabled and displayed. When the type of "connection" input is OpenAIConnection, the "model" input is enabled and displayed. 
+Below shows how to support this cascading setting in both tool code and tool yaml.
 
 ### Step 1: How to define the rules in the tool
 All inputs will be passed to the tool, allowing you to define your own set of rules to determine which input to use. You need to pay attention to some key points:
@@ -110,7 +109,7 @@ promptflow.tools.embedding.embedding:
 
 
 
-## How to use "enabled_by_value"
+## Use "enabled_by + enabled_by_value" in tool
 Assume you want to develop a tool with four inputs: "connection", "input", "deployment_name", and "model". The "deployment_name" and "model" are enabled by "connection" value. When the "connection" value is "azure-open-ai-connection", the "deployment_name" input is enabled and displayed. When the "connection" value is "open-ai-connection", the "model" input is enabled and displayed. You need to support enable by in two part: tool and tool yaml. Here is an example of how you can support the "enabled by" feature in your tool and tool yaml.
 
 

From 24db4e1427b1819e2631f64e2ca3ff4afcd5f942 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Mon, 23 Oct 2023 15:11:03 +0800
Subject: [PATCH 09/10] fix typos

---
 docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index daca68a2564..758224e8049 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -1,7 +1,7 @@
 # Use Enabled_By to Support Cascading Settings between Inputs for Tool
 
 This guide will instruct you on how to use the "enabled by" feature in the tool package. The "enabled by" feature is designed to support cascading settings between inputs for tool. 
-Cascading settings between inputs are frequently used in situations where the selection in one input field determines what sebsequent inputs should be shown. 
+Cascading settings between inputs are frequently used in situations where the selection in one input field determines what subsequent inputs should be shown. 
 This approach help in creating a more efficient, user-friendly, and error-free input process. To support cascading settings between tool inputs, we've introduced following two configurations:
 * "enabled_by + enabled_by_type": This setting enabled the current input based on the value type of the input shown in "enabled_by" field.
 * "enabled_by + enabled_by_value": This setting enabled the current input based on the actual value of the input shown in "enabled_by" field.

From db3de835ddc8a464fa7a1ec0821d53e35b64b9e2 Mon Sep 17 00:00:00 2001
From: cs_lucky <si.chen@microsoft.com>
Date: Mon, 23 Oct 2023 15:13:03 +0800
Subject: [PATCH 10/10] fix typos

---
 .../how-to-guides/develop-a-tool/create-and-use-tool-package.md | 2 +-
 docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
index dce803d9226..13999926918 100644
--- a/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
+++ b/docs/how-to-guides/develop-a-tool/create-and-use-tool-package.md
@@ -164,4 +164,4 @@ Alternatively, you can test your tool package using the script below to ensure t
 ## Advanced features
 [Customize your tool icon](add-a-tool-icon.md)    
 [Add category and tags for tool](add-category-and-tags-for-tool.md)  
-[Use Enabled_By to Support Cascading Settings between Inputs for Tool](how-to-use-enabled-by.md)
+[Use Enabled By to Support Cascading Settings between Inputs for Tool](how-to-use-enabled-by.md)
diff --git a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
index 758224e8049..c18c4dd12f7 100644
--- a/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
+++ b/docs/how-to-guides/develop-a-tool/how-to-use-enabled-by.md
@@ -1,4 +1,4 @@
-# Use Enabled_By to Support Cascading Settings between Inputs for Tool
+# Use Enabled By to Support Cascading Settings between Inputs for Tool
 
 This guide will instruct you on how to use the "enabled by" feature in the tool package. The "enabled by" feature is designed to support cascading settings between inputs for tool. 
 Cascading settings between inputs are frequently used in situations where the selection in one input field determines what subsequent inputs should be shown.