|
1 | 1 | --- |
2 | 2 | title: Troubleshoot FailedToTakeScreenshot Errors During Computer Use Actions |
3 | | -description: Learn how to resolve FailedToTakeScreenshot errors that occur during computer use actions in Microsoft Copilot Studio. |
| 3 | +description: Learn how to resolve a "FailedToTakeScreenshot" error that occurs during computer use actions in Microsoft Copilot Studio. |
4 | 4 | ms.date: 09/22/2025 |
5 | 5 | ms.reviewer: guco, v-shaywood |
6 | 6 | ms.custom: sap:Actions\AI actions |
7 | 7 |
|
8 | 8 | #customer intent: As a developer, I want to resolve FailedToTakeScreenshot errors that occur during computer use actions. These errors are preventing me from using computer use actions with my Copilot agents. |
9 | 9 | --- |
10 | 10 |
|
11 | | -# FailedToTakeScreenshot error during computer use action |
| 11 | +# "FailedToTakeScreenshot" error during computer use action |
12 | 12 |
|
13 | | -This article provides troubleshooting guidance for "FailedToTakeScreenshot" errors that occur during [computer use actions](/microsoft-copilot-studio/computer-use) for Copilot Studio agents. The computer use model requires screenshots to interact with the desktop. If capturing a screenshot fails, a "FailedToTakeScreenshot" error is given and the computer use action ends. |
| 13 | +This article provides troubleshooting guidance for "FailedToTakeScreenshot" errors that 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, a "FailedToTakeScreenshot" error is given and the computer use action ends. |
14 | 14 |
|
15 | 15 | ## Symptoms |
16 | 16 |
|
17 | | -During a computer use action, a "FailedToTakeScreenshot" error occurs and the action ends in failure. |
| 17 | +During a computer use action, a "FailedToTakeScreenshot" error occurs, and the screenshot capture action fails. |
18 | 18 |
|
19 | 19 | ## Cause 1: a UAC prompt is displayed |
20 | 20 |
|
21 | | -If Windows displays a [User Account Control](/windows/security/application-security/application-control/user-account-control/) (UAC) prompt, the prompt blocks the desktop and capturing the screen fails. |
| 21 | +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. |
22 | 22 |
|
23 | 23 | ### Solution |
24 | 24 |
|
25 | | -- Ensure that a UAC prompt isn't displayed when you open a new Remote Desktop session to the machine. |
26 | | -- Verify that the [UAC level](https://support.microsoft.com/windows/user-account-control-settings-d5b2046b-dcb8-54eb-f732-059f321afe18) isn't set to **Always notify** as that can cause UAC prompts to be displayed during session startup. |
| 25 | +- Make sure that a UAC prompt isn't displayed when you open a new Remote Desktop session to another computer. |
| 26 | +- Verify that the [UAC level](https://support.microsoft.com/windows/user-account-control-settings-d5b2046b-dcb8-54eb-f732-059f321afe18) isn't set to **Always notify**. That setting can cause UAC prompts to be displayed during session startup. |
27 | 27 |
|
28 | 28 | ## Cause 2: the Windows OOBE experience is displayed |
29 | 29 |
|
30 | | -The first time a user logs into the machine, Windows displays the [Out Of Box Experience](/windows-hardware/customize/desktop/customize-oobe-in-windows-11) (OOBE). This experience usually starts by displaying the message "Getting things ready." If the OOBE is displayed during the computer use action, capturing the screen fails. |
| 30 | +The first time that a user logs on 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. |
31 | 31 |
|
32 | 32 | ### Solution |
33 | 33 |
|
34 | | -The OOBE is only displayed the first time a new user logs into the machine. Make sure to manually log the user into the machine at least once before using computer use actions. |
| 34 | +The OOBE is displayed only the first time that a new user logs on to the remote computer. Make sure that you manually log the user on at least one time before they use a computer use action. |
35 | 35 |
|
36 | 36 | ## Cause 3: the Remote Desktop session isn't displayed |
37 | 37 |
|
38 | | -Capturing the screen fails if the Remote Desktop session isn't displayed. This issue can occur in the following cases: |
| 38 | +A screen capture fails if the Remote Desktop session isn't displayed. This issue might occur in the following situations: |
39 | 39 |
|
40 | | -- When you use an existing Remote Desktop session in the browser (for example connecting to a Power Automate Hosted machine), screen capturing fails if the Remote Desktop tab isn't focused. |
41 | | -- When you use a Remote Desktop session in the [Windows Application](/windows-app/overview), screen capturing fails if the application window is minimized. |
| 40 | +- 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. |
| 41 | +- If you use a Remote Desktop session in [Windows App](/windows-app/overview), screen capturing fails if the application window is minimized. |
42 | 42 |
|
43 | 43 | ### Solution |
44 | 44 |
|
45 | | -Before starting a compute use action, ensure that the Remote Desktop session is focused and visible on the screen. |
| 45 | +Before you start a computer use action, make sure that the Remote Desktop session is focused and visible on the screen. |
46 | 46 |
|
47 | 47 | ## Related content |
48 | 48 |
|
49 | 49 | - [Hosted machines](/power-automate/desktop-flows/hosted-machines) |
50 | | -- [Automate web and desktop apps with computer use](/microsoft-copilot-studio/computer-use) |
| 50 | +- [Automate web and desktop apps with computer use](/microsoft-copilot-studio/computer-use) |
0 commit comments