Merge pull request #295906 from dlepow/cop

[APIM] Copilot features

Author: JillGrant615

articles/api-management/set-edit-policies.md

@@ -6,7 +6,7 @@ author: dlepow
 
 ms.service: azure-api-management
 ms.topic: how-to
-ms.date: 10/18/2023
+ms.date: 03/06/2025
 ms.author: danlep
 ---
 

articles/api-management/transform-api.md

@@ -155,6 +155,8 @@ The rest of this section tests policy transformations that you set in this artic
 
 1. Wait for 15 seconds or more and then select **Send** again. This time you should get a **200 OK** response.
 
+[!INCLUDE [api-management-policies-azure-copilot](../../includes/api-management-policies-azure-copilot.md)]
+
 ## Summary
 
 In this tutorial, you learned how to:

includes/api-management-policies-azure-copilot.md

@@ -2,12 +2,20 @@
 author: dlepow
 ms.service: azure-api-management
 ms.topic: include
-ms.date: 05/20/2024
+ms.date: 03/06/2025
 ms.author: danlep
 ---
-## Get assistance creating policies using Microsoft Copilot in Azure (preview)
+## Get Copilot assistance
 
+Get AI assistance from Copilot to create and edit your API Management policy definitions. With Copilot, create and update policies that match your specific requirements without needing to know the XML syntax, and get explanations of existing policies. Copilot can also help you translate policies you might have configured in other API management solutions.
 
-[Microsoft Copilot in Azure](/azure/copilot/overview) (preview) provides policy authoring capabilities for Azure API Management. Use Copilot in Azure in the context of API Management's policy editor to create policies that match your specific requirements without knowing the syntax, or have already configured policies explained to you. 
+* [Microsoft Copilot in Azure](/azure/copilot/author-api-management-policies?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=%2Fazure%2Fapi-management%2Fbreadcrumb%2Ftoc.json) (preview) - Offers policy authoring assistance with natural language prompts in the Azure portal. Author policies in API Management's policy editor, and ask Copilot to explain policy sections.
+* [GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/overview) - Provides policy authoring assistance in Visual Studio Code, accelerating policy configuration when you use the [Azure API Management Extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-apimanagement&ssr=false#overview). Prompt Copilot Chat or Copilot Edits (preview) with natural language to create and refine policy definitions in place.
 
-You can prompt Copilot in Azure to generate policy definitions, then copy the results into the policy editor and make any necessary adjustments. Ask questions to gain insights into different options, modify the provided policy, or clarify the policy you already have. [Learn more](/azure/copilot/author-api-management-policies?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=%2Fazure%2Fapi-management%2Fbreadcrumb%2Ftoc.json)
+Example prompt:
+
+```copilot-prompt
+Generate a policy that adds an Authorization header to the request with a Bearer token.
+```
+ 
+Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot general use FAQs](https://aka.ms/copilot-general-use-faqs).