Skip to content

Commit 9f8d888

Browse files
authored
Refine troubleshooting article for screenshot errors
Updated troubleshooting guidance for 'FailedToTakeScreenshot' errors, clarifying symptoms and causes, and improving wording for clarity.
1 parent 533ce03 commit 9f8d888

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,32 +10,32 @@ ms.custom: sap:Actions\AI actions
1010

1111
# "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 Microsoft Copilot Studio agents. The computer use model requires screenshots to interact with the desktop. If the screenshot process fails, a "FailedToTakeScreenshot" error is returned, 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, the computer use action ends.
1414

1515
## Symptoms
1616

17-
During a computer use action, a "FailedToTakeScreenshot" error occurs, and the screenshot capture action fails.
17+
During a computer use action, a "FailedToTakeScreenshot" error message is returned. When the screenshot process fails, the computer use action ends.
1818

19-
## Cause 1: UAC prompt is displayed
19+
## Cause 1: a UAC prompt is displayed
2020

2121
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

2525
- 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](/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.
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

28-
## Cause 2: Windows OOBE experience is displayed
28+
## Cause 2: the Windows OOBE experience is displayed
2929

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

3232
### Solution
3333

34-
The OOBE is displayed only the first time that a new user signs in to the remote computer. Make sure that you manually log the user on at least one time before they use a computer use action.
34+
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.
3535

36-
## Cause 3: Remote Desktop session isn't visible
36+
## Cause 3: the Remote Desktop session isn't displayed
3737

38-
A screen capture fails if the Remote Desktop session isn't visible. This issue might occur in the following situations:
38+
A screen capture fails if the Remote Desktop session isn't displayed. This issue might occur in the following situations:
3939

4040
- 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.
4141
- If you use a Remote Desktop session in [Windows App](/windows-app/overview), screen capturing fails if the application window is minimized.

0 commit comments

Comments
 (0)