Merge pull request #258704 from dlepow/polcop

[APIM] Policy copilot

Author: v-regandowner

articles/api-management/TOC.yml

@@ -246,6 +246,8 @@
     href: api-management-howto-policies.md
   - name: Set or edit policies
     href: set-edit-policies.md
+  - name: Author policies using Microsoft Copilot for Azure
+    href: ../copilot/author-api-management-policies.md?toc=/azure/api-management/&bc=/azure/api-management/breadcrumb/toc.json
   - name: Debug policies in VS Code
     href: api-management-debug-policies.md
   - name: Policy expressions

articles/api-management/breadcrumb/TOC.yml

@@ -23,4 +23,7 @@ items:
       topicHref: /azure/api-management/index
     - name: API Management
       tocHref: /semantic-kernel/
+      topicHref: /azure/api-management/index
+    - name: API Management
+      tocHref: /azure/copilot/
       topicHref: /azure/api-management/index

articles/api-management/context/context.yml

@@ -0,0 +1,4 @@
+### YamlMime: ContextObject
+brand: azure
+breadcrumb_path: ../breadcrumb/toc.yml
+toc_rel: ../toc.yml

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

@@ -114,6 +114,16 @@ To configure a policy:
     The **ip-filter** policy now appears in the **Inbound processing** section.
 ---
 
+## Get assistance creating policies using Microsoft Copilot for Azure (preview)
+
+
+[Microsoft Copilot for Azure](../copilot/overview.md) (preview) provides policy authoring capabilities for Azure API Management. Using Copilot for Azure in the context of API Management's policy editor, you can create policies that match your specific requirements without knowing the syntax or have already configured policies explained to you. This proves particularly useful for handling complex policies with multiple requirements. 
+
+You can prompt Copilot for 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](../copilot/author-api-management-policies.md) about this capability.
+
+> [!NOTE]
+> Microsoft Copilot for Azure requires [registration](../copilot/limited-access.md#registration-process) (preview) and is currently only available to approved enterprise customers and partners. 
+
 ## Configure policies at different scopes
 
 API Management gives you flexibility to configure policy definitions at multiple [scopes](api-management-howto-policies.md#scopes), in each of the policy sections.