Merge pull request #5051 from MicrosoftDocs/alvinashcraft-main-powertoys-advanced-ai-paste-087

Add Advanced AI info to Advanced Paste docs

Author: alvinashcraft

hub/powertoys/advanced-paste.md

@@ -1,7 +1,7 @@
 ---
 title: PowerToys Advanced Paste for Windows
 description: A tool that enables you to paste the text from your clipboard into any format needed. It can be enhanced with an AI-powered option that is 100% opt-in and requires an OpenAI key.
-ms.date: 11/19/2024
+ms.date: 12/13/2024
 ms.topic: concept-article
 no-loc: [PowerToys, Windows, Paste as Plain Text, Advanced Paste, Win]
 # Customer intent: Learn how to use the Advanced Paste feature in PowerToys to paste text from your clipboard into any format needed.
@@ -27,7 +27,8 @@ From the Settings menu, the following options can be configured:
 
 | Setting | Description |
 | :--- | :--- |
-| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/)). |
+| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/)). See [Paste text with AI](#paste-text-with-ai) for more information. |
+| Enable advanced AI | Enables the Advanced AI feature which allows [Semantic Kernel](/semantic-kernel/overview/) to be used to define a chain of actions to be performed when using "Paste with AI". See [Paste with Advanced AI](#paste-with-advanced-ai) for more information.<br/><br/>This setting is off and disabled when Enable Paste with AI is disabled. When enabling Enable Paste with AI, Enable advanced AI is also enabled by default, allowing users immediate access to the feature. |
 | Custom format preview | Enable to preview the output of the custom format before pasting. |
 | Clipboard history | Enable to automatically save clipboard history. |
 | Open Advanced Paste shortcut | The customizable keyboard command to open the **Advanced Paste** window. |
@@ -157,6 +158,27 @@ AI output when prompting to "Format the text as if it were written by Mark Twain
 > [!NOTE]
 > As with any AI tool, the quality of the output is dependent on the quality of the input. The more context you provide, the better the AI will be able to understand and respond to your request. Be sure to carefully review the output before using it. Please see OpenAI's [privacy](https://openai.com/policies/privacy-policy) and [terms](https://openai.com/policies/terms-of-use) pages for more info on AI usage in this feature.
 
+### Paste with Advanced AI
+
+This feature uses [Semantic Kernel](/semantic-kernel/overview/) to allow you to define a chain of actions to be performed when using "Paste with AI". Using this feature you can:
+
+- Work with non-text input such as images.
+- Produce non-text output like files.
+- Chain multiple actions together and execute them in sequence. For example, Image to text --> Text to JSON text --> JSON text to .txt file.
+- Produce meaningful AI-generated error messages.
+
+For these example commands, assume there is an image in the clipboard that contains some text that you would like to save to a text file in another language. You can phrase multiple steps explicitly:
+
+```
+Convert this image to text using OCR, translate the text to French, and then save the text as a .txt file.
+```
+
+Or you can phrase the steps to be more implicit:
+
+```
+Translate to French and save as a .txt file.
+```
+
 ## Advanced image paste
 
 Advanced Paste includes several image-based paste options. These options are available in the **Advanced Paste** window, which can be opened using the activation shortcut. You can optionally set a quick key shortcut in settings.