Merge pull request #9764 from MicrosoftDocs/users/guco/CuaScreenshotTsg

AB#7582: Cua: Add screenshot error TSG

Author: haywoodsloan

support/power-platform/copilot-studio/actions/computer-use-screenshot-error.md

@@ -0,0 +1,50 @@
+---
+title: Troubleshoot FailedToTakeScreenshot Errors During Computer Use Actions
+description: Learn how to resolve a "FailedToTakeScreenshot" error that occurs during computer use actions in Microsoft Copilot Studio.
+ms.date: 09/22/2025
+ms.reviewer: guco, v-shaywood
+ms.custom: sap:Actions\AI actions
+
+#customer intent: As a developer, I want to resolve FailedToTakeScreenshot errors that might occur during computer use actions. These errors are preventing me from using computer use actions with my Copilot agents.
+---
+
+# "FailedToTakeScreenshot" error during computer use action
+
+This article provides troubleshooting guidance for "FailedToTakeScreenshot" errors that might occur during [computer use actions](/microsoft-copilot-studio/computer-use) for Microsoft Copilot Studio agents. The computer use model requires screenshots to interact with the desktop. If the screenshot process fails, the computer use action ends.
+
+## Symptoms
+
+During a computer use action, a "FailedToTakeScreenshot" error code is returned to the [agent transcript](/microsoft-copilot-studio/analytics-transcripts-studio#download-agent-session-transcripts). When the screenshot process fails, the computer use action ends.
+
+## Cause 1: UAC prompt is displayed
+
+If Windows displays a [User Account Control](/windows/security/application-security/application-control/user-account-control/) (UAC) prompt, the prompt blocks the desktop, and the system or application can't capture a screen image.
+
+### Solution
+
+- Make sure that a UAC prompt isn't displayed when you open a new Remote Desktop session to another computer.
+- Verify that the [UAC level](/windows/security/application-security/application-control/user-account-control/architecture#system) isn't set to **Always notify**. That setting can cause UAC prompts to be displayed during session startup.
+
+## Cause 2: Windows OOBE experience is displayed
+
+The first time that a user signs in to the remote computer, Windows starts the [Out Of Box Experience](/windows-hardware/customize/desktop/customize-oobe-in-windows-11) (OOBE). At startup, the OOBE typically displays the message, "Getting things ready." If the OOBE image is displayed during the computer use action, the screen capture action fails.
+
+### Solution
+
+The OOBE is displayed only the first time that a new user signs in to the remote computer. Make sure that you manually sign in the user at least one time before they use a computer use action.
+
+## Cause 3: Remote Desktop session isn't visible
+
+A screen capture fails if the Remote Desktop session isn't visible. This issue might occur in the following situations:
+
+- If you use an existing Remote Desktop session in a web browser (for example, when you connect to a Power Automate-hosted computer), screen capturing fails if the Remote Desktop tab isn't focused.
+- If you use a Remote Desktop session in [Windows App](/windows-app/overview), screen capturing fails if the application window is minimized.
+
+### Solution
+
+Before you start a computer use action, make sure that the Remote Desktop session is focused and visible on the screen.
+
+## Related content
+
+- [Hosted machines](/power-automate/desktop-flows/hosted-machines)
+- [Automate web and desktop apps with computer use](/microsoft-copilot-studio/computer-use)

support/power-platform/copilot-studio/actions/toc.yml

@@ -1,3 +1,5 @@
 items:
 - name: Connector request failures
-  href: connector-request-failure.md
+  href: connector-request-failure.md
+- name: FailedToTakeScreenshot errors during computer use actions
+  href: computer-use-screenshot-error.md