AWS quick documentation change
Summary
Updated documentation for creating flows in Amazon Quick Flows with revised instructions, clarified flow creation methods (natural language, visual editor, duplication, chat conversion), simplified prerequisites section, and updated UI terminology/logic.
Security assessment
The changes primarily involve documentation restructuring, UI terminology updates (e.g., changing _Flows_ to **Flows**), and clarifications about flow creation methods. There are no specific mentions of security vulnerabilities, patches, or security incidents. While authentication for action connectors is briefly mentioned in the duplication section, this is presented as standard operational guidance rather than security remediation.
Diff
diff --git a/quick/latest/userguide/creating-flows.md b/quick/latest/userguide/creating-flows.md index b4d89909e..98b77e6e6 100644 --- a//quick/latest/userguide/creating-flows.md +++ b//quick/latest/userguide/creating-flows.md @@ -9 +9 @@ Prerequisites for creating flowsCreating a flow using natural language prompt (N -After enabling Amazon Quick Flows in the Amazon Quick management console, users with creator permissions and an appropriate Amazon Quick license can create flows using several different methods. This section describes the various ways to create a flow and the requirements for each method. +You can create flows using natural language, the visual editor, by duplicating an existing flow, or from a chat agent conversation. @@ -13,10 +13 @@ After enabling Amazon Quick Flows in the Amazon Quick management console, users -Before you can create a flow, ensure that you have: - - * Creator permissions in Quick. - - * Access to the Amazon Quick Flows feature, which must be enabled by your administrator. - - * A supported web browser. For more information about browser requirements, see [Browser requirements](./prerequisites-for-quick-flows.html#browser-requirements). - - - +Before creating a flow, ensure that you meet the requirements described in [Prerequisites for Quick Flows](./prerequisites-for-quick-flows.html). @@ -26 +17 @@ Before you can create a flow, ensure that you have: -The natural language prompt method allows you to describe your desired flow in plain language, and Amazon Quick Flows will generate a flow based on your description. +The natural language prompt method lets you describe your desired flow in plain language, and Amazon Quick Flows generates a flow based on your description. @@ -30 +21 @@ The natural language prompt method allows you to describe your desired flow in p - 2. In the navigation pane, choose _Flows_. + 2. In the navigation pane, choose **Flows**. @@ -32 +23 @@ The natural language prompt method allows you to describe your desired flow in p - 3. Choose _Create Flow_. Once you select creating a flow, you see a page where you can enter a natural language prompt or use a sample prompt. + 3. Choose **Create Flow**. You see a page where you can enter a natural language prompt or use a sample prompt. @@ -42 +33 @@ The natural language prompt method allows you to describe your desired flow in p - * The outputs or actions it should produce + * The outputs it should produce @@ -44 +35,3 @@ The natural language prompt method allows you to describe your desired flow in p - 5. Choose _Generate Flow_. + * The actions it should take + + 5. Choose **Generate Flow**. @@ -48 +41 @@ The natural language prompt method allows you to describe your desired flow in p - 7. Preview the flow to test its functionality and ensure it works as expected. If the flow is ready for use, you can share or publish it with individuals, groups, or all users who have appropriate access permissions. + 7. Switch to **Run mode** to test your flow. If the flow is ready for use, you can share or publish it. @@ -55 +48 @@ The natural language prompt method allows you to describe your desired flow in p -The quality of the generated flow depends on the clarity and specificity of your natural language prompt. You may need to refine your prompt or make manual adjustments to the flow to achieve your desired outcome. +The quality of the generated flow depends on the clarity and specificity of your prompt. You may need to refine your prompt or make manual adjustments to achieve your desired outcome. @@ -63 +56 @@ Creating a flow from scratch gives you complete control over the design and func - 2. In the navigation pane, choose _Flows_. + 2. In the navigation pane, choose **Flows**. @@ -65 +58 @@ Creating a flow from scratch gives you complete control over the design and func - 3. Choose _Create Flow_. + 3. Choose **Create Flow**. @@ -73 +66 @@ Creating a flow from scratch gives you complete control over the design and func - * Add input steps to collect information from users. + * Add user input steps to collect text or files from users. @@ -75 +68 @@ Creating a flow from scratch gives you complete control over the design and func - * Add reasoning groups to process information using AI models. + * Add AI response steps to generate content from chat agents, web search, general knowledge, or image generation. @@ -77 +70 @@ Creating a flow from scratch gives you complete control over the design and func - * Add output steps to get AI-generated responses from Quick data, Quick Sight dashboards and topics, Web search, UI Agent, or General knowledge. + * Add data insight steps to get responses from Quick data or dashboards and topics. @@ -79 +72 @@ Creating a flow from scratch gives you complete control over the design and func - * Add action steps to perform operations in connected systems. + * Add reasoning groups to control how steps run with conditions, loops, or validation. @@ -81 +74 @@ Creating a flow from scratch gives you complete control over the design and func - * Add image step to generate professional grade content from text and image inputs. + * Add action steps to read or write to connected applications. @@ -83 +76 @@ Creating a flow from scratch gives you complete control over the design and func - 7. Choose _Save_ to save your flow. + 7. Choose **Save** to save your flow. @@ -92 +85 @@ For more information about the different components you can use in a flow, see [ -Duplicating a flow allows you to copy an existing flow. This helps users to understand how the flow was created and easily create flows based on others' ideas. +Duplicating a flow creates a copy that you can modify for your own purposes. @@ -96 +89 @@ Duplicating a flow allows you to copy an existing flow. This helps users to unde - 2. In the navigation pane, choose _Flows_. + 2. In the navigation pane, choose **Flows**. @@ -100 +93 @@ Duplicating a flow allows you to copy an existing flow. This helps users to unde - 4. Choose the ellipsis (⋮) next to the flow name, then choose _Duplicate_. + 4. Choose the ellipsis (⋮) next to the flow name, then choose **Duplicate**. @@ -102 +95 @@ Duplicating a flow allows you to copy an existing flow. This helps users to unde - 5. Enter a name and optional description for the new flow. + 5. Modify the name and optionally the description for your purposes. @@ -104 +97 @@ Duplicating a flow allows you to copy an existing flow. This helps users to unde - 6. Make any necessary modifications to the duplicated flow. + 6. Make any necessary modifications to the flow. @@ -106 +99 @@ Duplicating a flow allows you to copy an existing flow. This helps users to unde - 7. Choose _Save_ to save your flow. + 7. Choose **Save** to save your flow. @@ -113 +106 @@ Duplicating a flow allows you to copy an existing flow. This helps users to unde -When you duplicate a flow, all components, connections, and configurations are copied to the new flow. However, you may need to reconfigure certain settings, such as authentication for action connectors. +When you duplicate a flow, all components, connections, and configurations are copied. However, you may need to reconfigure certain settings, such as authentication for action connectors. @@ -117 +110 @@ When you duplicate a flow, all components, connections, and configurations are c -You can create a flow directly from a conversation with Amazon Q by using the Quick Flows icon in the chat bar. +You can create a flow from a conversation with a chat agent. For example, if you have been working through a task like reading an email, augmenting it with internal or web knowledge, and drafting a response, you can convert that conversation into a reusable flow. @@ -121 +114 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 2. Start a conversation with Amazon Quick Agent in the chat interface. + 2. Start a conversation with a chat agent. @@ -123 +116 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 3. Discuss the flow you want to create, including its purpose, inputs, processing, and outputs. + 3. Work through the task you want to automate. @@ -125 +118 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 4. When you're ready to create the flow, click the Quick Flows icon in the chat bar. + 4. Choose the Quick Flows icon in the chat bar. @@ -127 +120 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 5. Choose _Create Flow from conversation_. + 5. Choose **Create Flow from conversation**. Amazon Quick Flows interprets the interactions in your conversation and brings you to the Create flow screen with a generated natural language prompt, name, and description. @@ -129 +122 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 6. Enter a name and optional description for the flow. + 6. Review and edit the prompt, name, and description as needed. @@ -131 +124 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 7. Choose _Create_. + 7. Choose **Generate Flow**. @@ -135,2 +128 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu - 9. Choose _Save_ to save your flow. - + 9. Choose **Save** to save your flow. @@ -140 +131,0 @@ You can create a flow directly from a conversation with Amazon Q by using the Qu -This method is particularly useful when you want to explore ideas and possibilities through conversation before creating a flow. @@ -154 +145 @@ Flow components -A valid flow must have at least one input step and one output step or action step. +A valid flow must have at least one output step or action step. @@ -170 +161 @@ After creating a flow, you can: - * Test your flow to ensure it works as expected. . + * Test your flow to ensure it works as expected. @@ -172 +163 @@ After creating a flow, you can: - * Publish your flow to make it available to users. See [Publishing your flow](./versioning.html#publishing-your-flow). + * Publish your flow to make it available to users. See [Publishing changes](./versioning.html#publishing-your-flow). @@ -176 +167 @@ After creating a flow, you can: - * Monitor your flow's usage and performance. See [What is a progress tracker?](./interacting-with-flows-in-runtime-mode.html#progress-tracker). + * Monitor your flow's usage and performance. See [Progress tracker](./interacting-with-flows-in-runtime-mode.html#progress-tracker).