AWS devopsagent documentation change
Summary
Added documentation for new 'Generating artifacts' feature in AWS DevOps Agent Chat, updated UI references from chat icon to left panel, and changed context references from 'DevOps Center' to 'Topology'.
Security assessment
The changes are feature enhancements and UI updates. There is no mention of security vulnerabilities, patches, or security incidents. The changes introduce artifact generation capabilities and update navigation elements without addressing security weaknesses or adding security-specific documentation.
Diff
diff --git a/devopsagent/latest/userguide/working-with-devops-agent-on-demand-devops-tasks.md b/devopsagent/latest/userguide/working-with-devops-agent-on-demand-devops-tasks.md index d34b1ffe8..2d55b2d2c 100644 --- a//devopsagent/latest/userguide/working-with-devops-agent-on-demand-devops-tasks.md +++ b//devopsagent/latest/userguide/working-with-devops-agent-on-demand-devops-tasks.md @@ -5 +5 @@ -Tasks capabilitiesAccessing ChatContext-aware responsesManaging conversationsSample queriesEnabling Chat in your Agent Space +Tasks capabilitiesAccessing ChatContext-aware responsesManaging conversationsGenerating artifactsSample queriesEnabling Chat in your Agent Space @@ -24,0 +25,2 @@ AWS DevOps Agent On Demand Tasks provides comprehensive capabilities to help you +**Chat artifacts** – Generate structured reports and documents, such as operational health summaries, error reports, and incident analyses. Artifacts appear in a dedicated panel and support versioned editing within the conversation. + @@ -29 +31 @@ AWS DevOps Agent On Demand Tasks provides comprehensive capabilities to help you -To access Chat, click the chat icon in the bottom right corner of any page within the DevOps Agent Space web app. The chat interface opens as a persistent panel that remains accessible as you navigate between pages. +Chat is available as a persistent panel on the left side of the DevOps Agent Space web app. The left sidebar includes a **\+ New chat** button, a **Pages** section for navigating to Incidents, Ops Backlog, and Topology, and a **Chats** section that displays your recent conversations. Choose **View all** to see your full conversation history. @@ -33 +35 @@ Chat provides context-aware responses based on where you access it: -**DevOps Center** – Ask general questions about your Agent Space resources, architecture, and operational health. Chat has full visibility into all connected accounts and services. From this context, you can query resource configurations, deployment history, topology information, and observability tool integrations. +**Topology** – Ask general questions about your Agent Space resources, architecture, and operational health. Chat has full visibility into all connected accounts and services. From this context, you can query resource configurations, deployment history, topology information, and observability tool integrations. @@ -51 +53 @@ On the prevention page, Chat understands you are interested in incident preventi -When accessing Chat from the DevOps Center, Chat provides broad visibility across all resources, metrics, and historical data in your Agent Space. You can ask about any resource, service, or operational concern without specifying the investigation or recommendation context. +When accessing Chat from the Topology page, Chat provides broad visibility across all resources, metrics, and historical data in your Agent Space. You can ask about any resource, service, or operational concern without specifying the investigation or recommendation context. @@ -59 +61 @@ Chat maintains conversation history to enable you to continue previous discussio -**Creating new conversations** – Click the "New Chat" button in the chat interface to start a fresh conversation without prior context. New conversations do not carry over information from previous chats, allowing you to ask unrelated questions without confusion. +**Creating new conversations** – Click the "New session" button in the chat panel to start a fresh conversation without prior context. New conversations do not carry over information from previous chats, allowing you to ask unrelated questions without confusion. @@ -61 +63 @@ Chat maintains conversation history to enable you to continue previous discussio -**Accessing conversation history** – Click "Chat History" to view all previous conversations within your Agent Space. Conversations are organized chronologically with timestamps and preview text. Conversation history is retained for 90 days and is private to your user account within the Agent Space. +**Accessing conversation history** – Click "History" to view all previous conversations within your Agent Space. Conversations are organized chronologically with timestamps and preview text. Conversation history is retained for 90 days and is private to your user account within the Agent Space. @@ -66,0 +69,16 @@ Note that conversation history is isolated within each Agent Space. Conversation +## Generating artifacts + +AWS DevOps Agent supports chat artifacts — structured, versioned documents generated by the agent during a conversation. Artifacts provide a dedicated, interactive panel in the chat UI for reviewing and editing AI-generated content, such as operational reports, error summaries, and health assessments. + +You can request artifacts from any page in the DevOps Agent Space web app. Chat uses the current page context to scope the artifact content. + +### How artifacts work + +When you ask Chat to create or update content, Chat generates an artifact — typically a formatted document — and displays it in the artifact panel alongside the conversation. + +**Generate** – Send a natural language request to create a report or document. For example, ask "Generate a weekly operational health report for my Agent Space" or "Show me a report for my 4xx errors from last week". + +**Review** – The artifact appears in a dedicated panel alongside the conversation. You can review the full content while continuing to interact with Chat. + +**Edit** – Request changes to the artifact through Chat. For example, ask "Add a section on Lambda cold starts" or "Update the report to include last month's data". Chat creates a new version of the artifact with your requested changes. + @@ -70,0 +89,19 @@ The following examples demonstrate the types of questions you can ask Chat. Thes +### Artifact generation queries + +From any page in the DevOps Agent Space web app: + + * Generate a weekly operational health summary for my Agent Space + + * Create a report of all 4xx errors from last week + + * Build an incident summary report for the last 30 days + + * Create a summary of alarm activity for the payment service this week + + * Generate a deployment history report for the last 7 days + + * Summarize all open recommendations into a report + + + + @@ -94 +131 @@ From any page in the DevOps Agent Space web app: -From DevOps Center or Incident Response pages: +From Topology or Incident Response pages: @@ -117 +154 @@ From DevOps Center or Incident Response pages: -From DevOps Center: +From Topology: @@ -218 +255 @@ Chat is available in all DevOps Agent Space web apps. The setup process depends -Chat is **automatically enabled** when you create a new Agent Space. No additional configuration or IAM permissions setup is required. After you configure your DevOps Agent Space web app, Chat is immediately available through the chat icon in the bottom right corner of any page. +Chat is **automatically enabled** when you create a new Agent Space. No additional configuration or IAM permissions setup is required. After you configure your DevOps Agent Space web app, Chat is immediately available as a persistent panel on the left side of any page. @@ -251 +288 @@ Navigate to the AWS IAM console, locate your DevOps Agent operator role, and add -After completing either option, refresh your DevOps Agent Space web app and the chat icon appears in the bottom right corner. +After completing either option, refresh your DevOps Agent Space web app and the chat panel appears on the left side of any page.