AWS amazonq: Q artifacts doc: visualize tables/charts/dashboards; add example prompts
Summary
Removes the 'What you can do' section and the cross-service jobs preview text, broadens the artifacts description to include dashboards and pagination/filtering/sorting, and adds new example prompts covering resource detail, time-series charts, permissions/security, and troubleshooting diagnostics.
Security assessment
The change is a documentation rewrite of Amazon Q artifacts capabilities and example prompts. One new example prompt touches security ('instances ... open to the world?'), but it only illustrates a query the assistant can answer via visualization; no vulnerability, fix, or security control is documented.
Evidence
+ * **Permissions/Security** – Which instances across all regions are open to the world?
Diff
diff --git a/amazonq/latest/qdeveloper-ug/chat-artifacts.md b/amazonq/latest/qdeveloper-ug/chat-artifacts.md index dd72bac72..7527bbb29 100644 --- a//amazonq/latest/qdeveloper-ug/chat-artifacts.md +++ b//amazonq/latest/qdeveloper-ug/chat-artifacts.md @@ -7 +7 @@ -What you can doPrerequisitesHow it worksExample prompts +PrerequisitesHow it worksExample prompts @@ -11 +11 @@ What you can doPrerequisitesHow it worksExample prompts -Amazon Q artifacts enable Amazon Q to deliver responses enriched with table and chart visualizations. When you ask natural language questions about your resources, Amazon Q may display an artifact that helps you quickly understand your resources at a glance. +Amazon Q artifacts enable Amazon Q to deliver responses enriched with visualizations such as tables, charts, and dashboards. When you ask natural language questions about your resources, Amazon Q may display an artifact that helps you quickly understand your resources at a glance. You can paginate, filter, and sort results directly within the response. @@ -17,11 +16,0 @@ To get started, ensure you have the required permissions, and then review the ex -## What you can do - -With Amazon Q artifacts, you can: - - * **Generate visualizations for your AWS resources:** When you ask a question about your resources, Amazon Q creates visualizations like tables and charts so you can quickly understand the state of your account resources. - - * **Complete cross-service jobs (preview):** Amazon Q artifacts are available for jobs for most common AWS services such as EC2, RDS, Lambda, and others, to guide you through the steps for provisioning infrastructure, connecting services, and securing applications. For example, when you enter "Connect EC2 instance to an S3 bucket", the retrieved Q artifact enables you to grant permissions to an S3 bucket in your EC2 instance profile and make appropriate bucket policy changes. The permissions needed to use Amazon Q artifacts are described in the example IAM policy [Allow users to use Q artifacts in Amazon Q](./id-based-policy-examples-users.html#id-based-policy-examples-allow-artifacts). - - - - @@ -72,0 +62,8 @@ The following categories and associated prompts are examples of the types of tas + * **Resource detail** – Show me the configuration details for my EC2 instance i-xxxx. + + * **Time-series charts** – Graph network utilization for my EC2 instances over 12 hours across all regions. + + * **Permissions/Security** – Which instances across all regions are open to the world? + + * **Troubleshooting diagnostics** – Why is my ECS task failing in cluster my-ecs-cluster? +