AWS workspaces: WorkSpaces Advisor: describe issue, PII warning, optional scan
Summary
Rewrites the WorkSpaces Advisor docs to add a user-provided problem description step, makes it optional (broad scan fallback), removes the issue severity-levels section, and adds a warning not to include personally identifiable or confidential information in the description.
Security assessment
The change is primarily a UX/documentation update for the AI-powered Advisor feature. The only security-relevant content is the added guidance to avoid entering personally identifiable or confidential information into the investigation description, which is a data-handling/privacy best practice rather than a fix for a specific vulnerability or incident.
Evidence
+To start an investigation, select a WorkSpace and choose **Investigate**. On the **Investigate with Advisor** screen, describe the problem you're experiencing, for example, the symptoms or any error messages observed, so WorkSpaces Advisor can focus its investigation. Do not include personally identifiable or confidential information. When you choose **Investigate** , WorkSpaces Advisor deploys AI agents to analyze data from the selected WorkSpace. The analysis typically completes in under 60 seconds.
Diff
diff --git a/workspaces/latest/adminguide/workspaces-advisor.md b/workspaces/latest/adminguide/workspaces-advisor.md index 64281669d..01691d3d5 100644 --- a//workspaces/latest/adminguide/workspaces-advisor.md +++ b//workspaces/latest/adminguide/workspaces-advisor.md @@ -11 +11 @@ How investigations workInvestigate a WorkSpaceRequired permissionsCross-Region I -Amazon WorkSpaces Advisor is an AI-powered feature that helps you identify and resolve issues impacting your WorkSpaces Personal resources. WorkSpaces Advisor reviews telemetry, knowledge bases, and best practices to surface issues with recommended remediation actions — directly in the Amazon WorkSpaces console. +Amazon WorkSpaces Advisor is an AI-powered feature that helps you identify and resolve issues impacting your WorkSpaces Personal resources. You start an investigation by describing the problem you're experiencing in your own words. WorkSpaces Advisor then reviews telemetry, knowledge bases, and best practices, anchored to your description. It surfaces the most relevant issues, along with recommended remediation actions, directly in the Amazon WorkSpaces console. @@ -15 +15,3 @@ With WorkSpaces Advisor, you can: - * Investigate a WorkSpace and receive a list of identified issues + * Describe the issue you're experiencing so Advisor can focus its investigation + + * Investigate a WorkSpace and receive the issues most relevant to what you described @@ -47 +49,3 @@ WorkSpaces Advisor is available in all AWS Regions that support Amazon WorkSpace -When you initiate an investigation, WorkSpaces Advisor deploys AI agents to analyze data from the selected WorkSpace over the past 3 days. The analysis typically completes in under 60 seconds. +To start an investigation, select a WorkSpace and choose **Investigate**. On the **Investigate with Advisor** screen, describe the problem you're experiencing, for example, the symptoms or any error messages observed, so WorkSpaces Advisor can focus its investigation. Do not include personally identifiable or confidential information. When you choose **Investigate** , WorkSpaces Advisor deploys AI agents to analyze data from the selected WorkSpace. The analysis typically completes in under 60 seconds. + +WorkSpaces Advisor returns the issues most relevant to what you reported. For each issue, WorkSpaces Advisor provides at least one recommended action, describes the risk and impact to your resources, and might offer alternative actions. @@ -49 +53 @@ When you initiate an investigation, WorkSpaces Advisor deploys AI agents to anal -WorkSpaces Advisor returns a list of identified issues ordered by severity. For each issue, WorkSpaces Advisor provides at least one recommended action along with alternatives. Each action includes a severity level (Critical, High, Medium, or Low) and describes the risk and impact to your resources. +Describing the issue is optional. If you leave the description blank, WorkSpaces Advisor runs a broad scan of the WorkSpace instead. @@ -51 +55 @@ WorkSpaces Advisor returns a list of identified issues ordered by severity. For -If WorkSpaces Advisor does not identify your issue, you can provide feedback through the console or create a support case with AWS Support. +If WorkSpaces Advisor cannot identify your issue, it tells you the issue needs a specialist and offers to create an AWS Support case pre-populated with the investigation context. You can also provide feedback through the console. @@ -60,15 +63,0 @@ If WorkSpaces Advisor does not identify your issue, you can provide feedback thr -### Issue severity levels - -WorkSpaces Advisor categorizes issues by the following severity levels (for example): - - * **Critical** — The user cannot connect to the WorkSpace or the WorkSpace is unresponsive. - - * **High** — The user experience is significantly degraded (for example, high latency or frequent disconnections). - - * **Medium** — The WorkSpace is functional but performance is below optimal levels (for example, elevated CPU or memory usage). - - * **Low** — A potential issue or configuration gap that may not currently affect the user. - - - - @@ -102 +91,5 @@ WorkSpaces Advisor accesses the following data to perform investigations: - 5. Review the list of identified issues. Choose an issue to view details, including supporting telemetry and recommended actions. + 5. On the **Investigate with Advisor** screen, describe the issue you're experiencing. Include any symptoms or error messages observed so WorkSpaces Advisor can focus its investigation. Do not include personally identifiable or confidential information. (This step is optional; leave it blank to run a broad scan.) + + 6. Choose **Investigate** to start the investigation. + + 7. Review the identified issues, which are focused on what you described. Choose an issue to view details, including supporting telemetry and the recommended action. @@ -104 +97 @@ WorkSpaces Advisor accesses the following data to perform investigations: - 6. Review the risk and impact information for the recommended action, then choose the action to initiate it. + 8. Review the risk and impact information for the recommended action, then choose the action to initiate it.