Skip to content

Commit 2504e34

Browse files
authored
Update computer-use-screenshot-error.md
Edit review per CI 7582
1 parent 698c7d9 commit 2504e34

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,50 @@
11
---
22
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.
44
ms.date: 09/22/2025
55
ms.reviewer: guco, v-shaywood
66
ms.custom: sap:Actions\AI actions
77

88
#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.
99
---
1010

11-
# FailedToTakeScreenshot error during computer use action
11+
# "FailedToTakeScreenshot" error during computer use action
1212

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.
1414

1515
## Symptoms
1616

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.
1818

1919
## Cause 1: a UAC prompt is displayed
2020

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.
2222

2323
### Solution
2424

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.
2727

2828
## Cause 2: the Windows OOBE experience is displayed
2929

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.
3131

3232
### Solution
3333

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.
3535

3636
## Cause 3: the Remote Desktop session isn't displayed
3737

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:
3939

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.
4242

4343
### Solution
4444

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.
4646

4747
## Related content
4848

4949
- [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

Comments
 (0)