Add Pipelines Copilot: AI-generated deployment notes and RAI documentation to Power Platform ALM docs

power-platform/alm/TOC.yml

@@ -78,6 +78,8 @@
                   href: extend-pipelines-github-export.md
             - name: Run pipelines
               href: run-pipeline.md
+            - name: Use Copilot to generate deployment notes in pipelines (preview)
+              href: copilot-deployment-notes-pipelines.md
     - name: ALM for developers
       href: alm-for-developers.md
       items:
@@ -160,3 +162,9 @@
           href: when-edit-customization-file.md
         - name: Pipeline table reference
           href: ../developer/pipelines/table-reference.md
+    - name: Responsible AI
+      items:
+        - name: Overview
+          href: responsible-AI-overview.md
+        - name: FAQ for using Copilot to generate deployment notes in pipelines
+          href: faqs-ai-deployment-notes-pipelines.md

power-platform/alm/copilot-deployment-notes-pipelines.md

@@ -0,0 +1,50 @@
+---
+title: Use Copilot to generate deployment notes in pipelines (preview)
+description: Learn how to use Copilot to generate deployment notes during pipeline deployments.
+author: ASheehi1
+ms.author: matp
+ms.topic: how-to
+ms.date: 07/31/2023
+contributors:
+   - ASheehi1
+ms.custom: template-how-to
+---
+# Use Copilot to generate deployment notes in pipelines (preview)
+
+[This article is prerelease documentation and is subject to change.]
+
+When deploying solutions in a pipeline, makers are now able to [deploy with notes](run-pipeline.md#run-a-pipeline). However, makers will spend time and energy noting what is included in their deployed solution to give enough context for any admin approving (triggered via [extensibility](extend-pipelines.md)) their deployment requests or viewing their pipeline deployment record. With AI-generated deployment notes, in just seconds, a solution summary can be generated for the maker and applied to deployment notes, giving anyone viewing the deployment request or record enough context to understand what the solution does and what it contains.
+
+:::image type="content" source="media/pipeline-AI-deployment-notes.gif" alt-text="GIF of deployment notes being generated by AI, containing a solution description and component overview":::
+
+Solutions can become complex, often containing dozens of components that are difficult to partition and summarize. In the case of pipeline deployments, admins and deployment approvers will have to open the solutions themselves to gain an understanding of what’s included unless that information is provided in deployment notes. By helping makers generate useful solution descriptions with AI, Copilot can save valuable time and provide better, more accurate information than makers could within the generation time. These descriptions can then be added with a simple click of the **Apply** button.
+
+## Requirements
+
+- One or more pipelines must already be created and associated with the environment that's used for development.
+- You must have access to run a pipeline. More information: [Grant access to edit or run pipelines](set-up-pipelines.md#grant-access-to-edit-or-run-pipelines)
+- Your pipeline, and all of its linked environments, must be in the **United States** to participate in this preview.
+- The setting for "AI deployment notes" must be set to **Enabled** in the Deployment Pipeline Configuration app for each pipeline you want to preview this feature with.
+
+## Disable AI-generated deployment notes
+
+1. Go to the **Deployment Pipeline Configuration** app in the pipelines Host environment.
+2. Select **Pipelines** in the left navigation bar.
+3. Click the pipeline that you would like to disable AI for.
+4. Set "AI deployment notes" to **Disabled** via the dropdown.
+5. Go **Back to solutions** in the maker experience, if still running, and refresh to ensure the change was made.
+
+
+> [!IMPORTANT]
+> - Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
+> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
+> - This capability is powered by [ Azure OpenAI Service](/azure/cognitive-services/openai/overview).
+> - Learn more about our [transparency for Copilot data security and privacy in Power Platform](/dynamics365/transparency-note-copilot-data-security-privacy.md).
+> - This capability is in process of rolling out, and may not be available in your region yet.
+> - This capability  may be subject to usage limits or capacity throttling.
+
+### See also
+
+[FAQ for using Copilot to generate deployment notes in pipelines](faqs-ai-deployment-notes-pipelines.md)
+
+[Transparency notes for Power Apps](/power-apps/maker/common/transparency-note.md)

power-platform/alm/faqs-AI-deployment-notes-pipelines.md

@@ -0,0 +1,68 @@
+---
+title: FAQ for use Copilot to generate deployment notes in pipelines
+description: FAQ that discusses using Copilot to generate deployment notes in pipelines and the key considerations for making use of this technology responsibly.
+ms.date: 7/31/2023
+ms.custom: 
+  - responsible-ai-faqs
+ms.topic: article
+author: ASheehi1
+ms.author: matp
+---
+
+# FAQ for use Copilot to generate deployment notes in pipelines
+
+These frequently asked questions (FAQ) describe the AI impact of use Copilot to generate deployment notes in pipelines.
+
+## What is use Copilot to generate deployment notes in pipelines? 
+
+AI-generated deployment notes is a feature in pipelines for Power Platform that allows you to seamlessly generate deployment notes to provide more context to your deployment record. The only steps are to review what AI has generated for you, and click **Apply** at the last summary page of the deployment configuration.
+
+## What are the system’s capabilities? 
+
+This capability is powered by [Azure OpenAI Service](/azure/cognitive-services/openai/overview), which uses powerful language models. These language models generate new text in English that looks and sounds like text written by humans.  
+
+Using Azure OpenAI service as a foundation, deployment notes will be generated in the form of a solution overview, providing a concise solution description and an overview of its components. These notes are based on component metadata such as name, description, and type.
+
+## What is the system’s intended use? 
+
+AI-generated deployment notes help admins approve and manage deployments in their organization, providing insight into what a solution contains and its purpose. AI-generated content may have mistakes. Make sure it's accurate and appropriate before using it. For more information, read the full [preview terms](https://powerplatform.microsoft.com/en-us/legaldocs/supp-powerplatform-preview).
+
+
+## How was use Copilot to generate deployment notes in pipelines evaluated? What metrics are used to measure performance? 
+
+Use Copilot to generate deployment notes in pipelines underwent substantial testing before the feature was released in preview. If you encounter issues with the content being generated, please submit feedback. Your feedback will be used to improve Microsoft products and services. IT admins for your organization will be able to view and manage your feedback data. 
+
+For more information, see: [Data, privacy, and security for Azure OpenAI Service](/legal/cognitive-services/openai/data-privacy)
+
+## What are the limitations of use Copilot to generate deployment notes in pipelines? How can users minimize the impact of the AI-generated deployment notes in pipelines limitations when using the system? 
+
+Preview features aren’t meant for production use and may have restricted functionality.These features are available before an official release so that customers can get early access and provide feedback. 
+
+This capability is in the process of rolling out, and may not be available in your region yet. 
+
+This capability may be subject to usage limits or capacity throttling. 
+
+The following are requirements to access the waitlist for this preview: 
+
+- Your pipeline environments must be in the United States region. 
+
+- Your account must have English (United States) as the browser language.
+
+- AI deployment notes must be enabled for your pipeline to use the Copilot leveraging AI models: 
+
+    1. Go to your pipelines Host environment > run **Deployment Pipeline Configuration** > **Pipelines** > select desired pipeline. 
+
+    3. On the **General** settings page, under **Pipeline Details**, enable or disable **AI deployment notes**. 
+
+For more information, see [Use Copilot to generate deployment notes in pipelines (preview)](copilot-deployment-notes-pipelines.md). 
+
+## What operational factors and settings allow for effective and responsible use of the system? 
+
+Follow these procedures to make the most of the feature: 
+
+- Name your solution components accurately.
+- Add descriptions to your solution components to give them more context.
+
+## See also 
+- [Use Copilot to generate deployment notes in pipelines (preview)](copilot-deployment-notes-pipelines.md)
+

power-platform/alm/responsible-AI-overview.md

@@ -0,0 +1,22 @@
+---
+title: Responsible AI FAQs for Power Platform ALM
+description: Responsible AI FAQs discusses AI technology in Power Platform ALM and the key considerations for making use of this technology responsibly.
+ms.date: 7/31/2023
+ms.custom: 
+  - responsible-ai-faqs
+ms.topic: article
+author: ASheehi1
+ms.author: matp
+---
+
+# Responsible AI FAQs for Power Platform ALM
+
+An AI system includes not only the technology, but also the people who use it, the people affected by it, and the environment in which it's deployed. Microsoft's Responsible AI FAQs are intended to help you understand how AI technology works, the choices system owners and users can make that influence system performance and behavior, and the importance of thinking about the whole system, including the technology, the people, and the environment. You can use Responsible AI FAQs to better understand specific AI systems and features that Microsoft develops.
+
+Responsible AI FAQs are part of a broader effort to put Microsoft's AI principles into practice. To find out more, see [Microsoft AI principles](https://www.microsoft.com/ai/responsible-ai).
+
+## AI-driven features in Power Platform ALM
+This is a growing list of AI-driven features. To learn about the capabilities and impact of specific features, select a feature name from the list.
+
+- [FAQ for Use Copilot to generate deployment notes in pipelines](faqs-ai-deployment-notes-pipelines.md)
+- [Use Copilot to generate deployment notes in pipelines (preview)](copilot-deployment-notes-pipelines.md)