AWS amazonq documentation change
Summary
Updated documentation for Amazon Q chat interface including new console experience, navigation changes, conversation management updates, chat panel controls, and expanded example prompts with visualization support
Security assessment
The changes primarily focus on UI/UX improvements and feature enhancements without addressing security vulnerabilities or introducing new security controls. While there are updates about resource queries (e.g., 'List RDS databases without CloudWatch alarms'), these are example prompts rather than security documentation. The 90-day conversation retention policy update relates to data management rather than security remediation.
Diff
diff --git a/amazonq/latest/qdeveloper-ug/chat-with-q.md b/amazonq/latest/qdeveloper-ug/chat-with-q.md index 7132c3333..b3293c122 100644 --- a//amazonq/latest/qdeveloper-ug/chat-with-q.md +++ b//amazonq/latest/qdeveloper-ug/chat-with-q.md @@ -5 +5 @@ -Add permissionsStart a conversationManage conversations in the consoleSet chat settingsExample questions +Add permissionsStart a conversationManage conversations in the consoleNavigate the Amazon Q chat panelChat settingsExample prompts @@ -8,0 +9,4 @@ Add permissionsStart a conversationManage conversations in the consoleSet chat s +###### Introducing a new Amazon Q in the AWS Management Console experience + +Amazon Q Developer in the console now offers an enhanced experience. The Q icon has been relocated to the navigation bar. The Q chat panel now opens on the left side. Amazon Q can now provide answers to questions with table and chart visualizations. A prompt library makes it easier to find example prompts. + @@ -16,0 +21,2 @@ The following topics describe how to use Amazon Q chat and topics you can chat a + * [Using Q artifacts in Amazon Q](./chat-artifacts.html) + @@ -23 +29 @@ The following topics describe how to use Amazon Q chat and topics you can chat a - * Set chat settings + * Navigate the Amazon Q chat panel @@ -25 +31,3 @@ The following topics describe how to use Amazon Q chat and topics you can chat a - * Example questions + * Chat settings + + * Example prompts @@ -48 +56 @@ For an IAM policy that grants permissions needed for chatting with Amazon Q, see -To open up the Amazon Q chat panel in the AWS Management Console, choose the Amazon Q icon in the right sidebar. To open up the panel on the AWS website or any AWS service’s documentation page, choose the Amazon Q icon in the bottom right corner. +To open up the Amazon Q chat panel in the AWS Management Console, choose the Amazon Q icon in the top left in the Unified Navigation bar. To open up the panel on the AWS website or any AWS service’s documentation page, choose the Amazon Q icon in the bottom right corner. @@ -56,3 +64 @@ After you receive a response, you can optionally leave feedback by using the thu - 1. From the welcome screen, choose **New conversation** at the bottom of the chat panel. - - 2. From an active conversation, you can start a new conversation by choosing the plus icon in the top right corner of the chat panel. From the welcome screen, choose **New conversation** at the bottom of the chat panel. + 1. You can start a new conversation by choosing the plus icon in the top right corner of the chat panel. @@ -60 +66 @@ After you receive a response, you can optionally leave feedback by using the thu - 3. To name or rename a conversation, choose the text at the top of the chat panel and enter your conversation name. + 2. To name or rename a conversation, choose the text at the top of the chat panel and enter your conversation name. @@ -66,0 +73,2 @@ After you receive a response, you can optionally leave feedback by using the thu +You can view, switch to, and delete your past conversations in Amazon Q. + @@ -69 +77 @@ Amazon Q maintains the history of previously asked questions and responses withi -When you start a conversation, it’s automatically saved as a new conversation. You can title the conversation, or Amazon Q will generate a title based on the first few questions in the conversation. +When you start a conversation, it’s automatically saved as a new conversation. You can title the conversation, or Amazon Q will generate a title based on the example prompt you select or the first few questions in the conversation. @@ -71 +79 @@ When you start a conversation, it’s automatically saved as a new conversation. -You can switch between conversations to continue chatting with Amazon Q about previous topics you’ve asked about. Inactive conversations, in which you don’t ask a new question, will be deleted after 90 days. Messages older than 90 days will be deleted, even if a conversation is still active. +You can switch between conversations to continue chatting with Amazon Q about previous topics. Inactive conversations, in which you don’t ask a new question, will be deleted after 90 days of inactivity. Messages older than 90 days will be deleted, even if a conversation is still active. @@ -75 +83 @@ You can switch between conversations to continue chatting with Amazon Q about pr - 1. Choose the menu icon on the top left of the chat panel. The **Conversations** page opens in the chat panel. + 1. Choose the clock icon on the top right of the chat panel. The **Conversations** pop-up opens. @@ -77 +85 @@ You can switch between conversations to continue chatting with Amazon Q about pr - 2. Choose the name of the conversation you want to resume. You are redirected to the chat panel where you can continue chatting with Amazon Q. + 2. Choose the name of the conversation you want to resume. All previous messages from that conversation appear in the chat panel where you can continue chatting with Amazon Q. @@ -84 +92 @@ You can switch between conversations to continue chatting with Amazon Q about pr - 1. Choose the menu icon on the top left of the chat panel. The **Conversations** page opens in the chat panel. + 1. Choose the clock icon on the top right of the chat panel. The **Conversations** pop-up opens. @@ -86 +94 @@ You can switch between conversations to continue chatting with Amazon Q about pr - 2. Choose the delete icon next to the name of the conversation you want to delete. Confirm you want to delete the conversation by choosing **Delete** on the pop-up that appears. + 2. Choose the delete icon next to the name of the conversation you want to delete. @@ -93 +101,9 @@ If you’re using Amazon Q in the console, your current conversation and associa -## Set chat settings +## Navigate the Amazon Q chat panel + +Note: You can switch between the Amazon Q chat panel and service consoles at any time: + + 1. To expand the Q chat panel in full-screen mode, choose the maximize icon in the top-right corner. To toggle full-screen mode, choose the resize icon. + + 2. To close the Q chat panel, choose < in the top-right corner. To close the panel with visualizations, choose X in the top-right corner. + + 3. To adjust the chat panel size, use the divider. @@ -95 +111 @@ If you’re using Amazon Q in the console, your current conversation and associa -To update your chat settings in Amazon Q, choose the gear icon in the top right corner of the chat panel. + 4. To reopen the chat panel, choose the Q icon in the Unified Navigation bar. @@ -97 +113,8 @@ To update your chat settings in Amazon Q, choose the gear icon in the top right -You can specify the following settings: + 5. Your work is automatically saved when switching between views. + + + + +## Chat settings + +To view your chat settings in Amazon Q, choose the gear icon in the top right of the chat panel. @@ -104 +127 @@ You can specify the following settings: -## Example questions +## Example prompts @@ -106 +129 @@ You can specify the following settings: -You can ask Amazon Q questions about AWS and AWS services, such as finding the right service or understanding best practices. +You can ask Amazon Q questions about AWS and AWS services, such as finding the right service, understanding best practices or reviewing the state of your resources. If Amazon Q determines a visual interface would be helpful, it automatically displays a new panel with either a table or chart visualization. @@ -111,0 +135,2 @@ The following are example questions that demonstrate how Amazon Q can help you b + * List RDS databases without CloudWatch alarms + @@ -115,0 +141,6 @@ The following are example questions that demonstrate how Amazon Q can help you b + * List S3 buckets with tag value `<tag value>` + + * Create a chart showing my cost per GB for different S3 storage classes + + * Graph EC2 cost per vCPU hour over the last 3 weeks + @@ -118 +149 @@ The following are example questions that demonstrate how Amazon Q can help you b - * How do I list my Amazon S3 buckets? + * Show me a bar chart of potential savings by optimization recommendation @@ -120 +150,0 @@ The following are example questions that demonstrate how Amazon Q can help you b - * How do I create and host a website on AWS? @@ -123,0 +154 @@ The following are example questions that demonstrate how Amazon Q can help you b +To help you get started, Q recommends prompts when you start a new conversation. You can also view the list of supported prompts in the prompt library. To view prompts in the prompt library, choose the book icon in the top right of the chat panel. @@ -133 +164 @@ On AWS -Chatting about your resources +Using Q artifacts in Amazon Q