Merge pull request #8344 from MicrosoftDocs/users/jukullam/ai-tip

Add guidance for using AI to identify variable syntax issues

Author: prmerger-automator[bot]

docs/pipelines/process/runs.md

@@ -6,6 +6,8 @@ ms.custom: devx-track-azurecli, ai-assisted
 ms.assetid: 0d207cb2-fcef-49f8-b2bf-ddb4fcf5c47a
 ms.date: 06/09/2025
 monikerRange: "<=azure-devops"
+ms.collection: 
+  - ce-skilling-ai-copilot
 ---
 
 # Pipeline runs
@@ -223,6 +225,40 @@ Delete a tag from a pipeline run in your project using the [az pipelines runs ta
 ```azurecli 
 az pipelines runs tag delete --run-id 123 --tag YAML
 ```
+## Manage runs with the Azure DevOps MCP Server
+
+You can manage pipeline runs in Copilot with the Azure DevOps MCP server. To get started, see [Enable AI assistance with Azure DevOps MCP Server](../../mcp-server/mcp-server-overview.md).
+
+### List pipeline runs
+
+List the pipeline runs for a particular pipeline.
+
+```copilot-prompt
+Show the three most recent runs for the Tailspin pipeline.
+```
+
+This prompt lists the last three pipeline runs with a link to view each run.
+
+### Show pipeline run details
+
+Fetch the status of a specific build.
+
+```copilot-prompt
+Show the status and details for build 12345678.9.
+```
+
+This prompt returns returns the status, result, start/finish time, and summary for a build. 
+
+### Start a new pipeline run
+
+Begin a new run of a pipeline.
+
+```copilot-prompt
+Start the Tailspin pipeline and provide a direct link to the run, including the project name in the URL.
+```
+
+This prompt starts your pipeline and and provides a link to the pipeline run.
+
 
 ::: moniker-end
 

docs/pipelines/process/variables.md

@@ -6,6 +6,8 @@ ms.topic: conceptual
 ms.assetid: 4751564b-aa99-41a0-97e9-3ef0c0fce32a
 ms.date: 10/03/2024
 ai-usage: ai-assisted
+ms.collection: 
+  - ce-skilling-ai-copilot
 ---
 
 # Define variables
@@ -149,6 +151,22 @@ Choose a runtime expression if you're working with [conditions](conditions.md) a
 
 Typically a template variable is the standard to use. By leveraging template variables, your pipeline will fully inject the variable value into your pipeline at pipeline compilation. This is helpful when attempting to debug pipelines. You can download the log files and evaluate the fully expanded value that is being substituted in. Since the variable is substituted in, you shouldn't leverage template syntax for sensitive values.
 
+### Use AI to identify variable syntax issues
+
+This is an example prompt for Copilot Chat that identifies what types of variables are used in a pipeline and when the variables will resolve. Highlight your YAML code and then enter the following Copilot Chat prompt.
+
+```copilot-prompt
+What types of Azure DevOps variables are used in this YAML pipeline? Give specific examples.
+When does each variable process in the pipeline? 
+How will each variable render when not found? 
+What stages and jobs will the variables be available for? 
+```
+
+Customize your prompt to add specifics as needed. 
+
+> [!TIP]  
+> Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs). 
+
 ## Set variables in pipeline
 
 #### [YAML](#tab/yaml/)