AWS connect documentation change
Summary
Rebranded 'Amazon Q in Connect' to 'Connect AI agents' throughout the documentation. Added new AI agent use cases (Orchestration, Note Taking, Agent Assistance, Case Summarization), updated navigation references, modified CLI command placeholders, and updated image descriptions.
Security assessment
The changes are primarily branding updates and feature additions without any mention of security vulnerabilities, patches, or security-specific configurations. No security-related terminology (CVE, vulnerability, exploit, etc.) appears in the diff. Permission changes ('Amazon Q' to 'AI agent designer') are routine updates reflecting product renaming.
Diff
diff --git a/connect/latest/adminguide/create-ai-agents.md b/connect/latest/adminguide/create-ai-agents.md index 906b2d5e6..c25fe02c0 100644 --- a//connect/latest/adminguide/create-ai-agents.md +++ b//connect/latest/adminguide/create-ai-agents.md @@ -9 +9 @@ How to create AI agentsAssociate an AI agent with a flowSample CLI commands -An _AI agent_ is an Amazon Q in Connect resource that configures and customizes the end-to-end Amazon Q in Connect experience. For example, the AI agent tells the AI Assistant how to handle a manual search: which AI prompts and AI guardrails it should use, and which locale to use for the response. +An _AI agent_ is a resource that configures and customizes the end-to-end AI agent experience. For example, the AI agent tells the AI Assistant how to handle a manual search: which AI prompts and AI guardrails it should use, and which locale to use for the response. @@ -11 +11 @@ An _AI agent_ is an Amazon Q in Connect resource that configures and customizes -Amazon Q in Connect provides a system AI agent for each use case: +Amazon Connect provides the following out of the box system AI agents: @@ -13 +13 @@ Amazon Q in Connect provides a system AI agent for each use case: - * Answer recommendation + * Orchestration @@ -15 +15 @@ Amazon Q in Connect provides a system AI agent for each use case: - * Manual search + * Answer Recommendation @@ -17 +17 @@ Amazon Q in Connect provides a system AI agent for each use case: - * Self service + * Manual Search @@ -19 +19 @@ Amazon Q in Connect provides a system AI agent for each use case: - * Email overview + * Self Service @@ -21 +21 @@ Amazon Q in Connect provides a system AI agent for each use case: - * Email generative answer + * Email Response @@ -22,0 +23 @@ Amazon Q in Connect provides a system AI agent for each use case: + * Email Overview @@ -23,0 +25 @@ Amazon Q in Connect provides a system AI agent for each use case: + * Email Generative Answer @@ -24,0 +27 @@ Amazon Q in Connect provides a system AI agent for each use case: + * Note Taking @@ -26 +29 @@ Amazon Q in Connect provides a system AI agent for each use case: -The system AI agents are populated with the default AI prompts for each use case. + * Agent Assistance @@ -28 +31 @@ The system AI agents are populated with the default AI prompts for each use case -For example, the following image shows an Amazon Q in Connect experience that is configured to use customized AI agents for answer recommendations and manual searches, but uses the system default AI agent for self service use cases. + * Case Summarization @@ -30 +33,8 @@ For example, the following image shows an Amazon Q in Connect experience that is - + + + +Each use case is configured to use a default AI system agent. This can also be customized. + +For example, the following image shows a Connect AI agents experience that is configured to use a customized AI agent for the Agent Assistance use case and uses the system default AI agents for the rest. + + @@ -40 +50 @@ Here's how customized AI agents work: - * Most use cases—**Answer recommendation** , **Self service** , **Email response** , and **Email generative answer** —support two types of AI prompts. If you choose to create a new AI prompt for one type but not the other, then the AI agent continues using the system default for the AI prompt you didn't override. This way you can choose to override only specific parts of the default Amazon Q in Connect experience. + * Most use cases—**Answer recommendation** , **Self service** , **Email response** , and **Email generative answer** —support two types of AI prompts. If you choose to create a new AI prompt for one type but not the other, then the AI agent continues using the system default for the AI prompt you didn't override. This way you can choose to override only specific parts of the default Connect AI agents experience. @@ -47 +57 @@ Here's how customized AI agents work: - 1. Log in to the Amazon Connect admin website at https://`instance name`.my.connect.aws/. Use an admin account, or an account with **Amazon Q** \- **AI agents** \- **Create** permission in it's security profile. + 1. Log in to the Amazon Connect admin website at https://`instance name`.my.connect.aws/. Use an admin account, or an account with **AI agent designer** \- **AI agents** \- **Create** permission in it's security profile. @@ -49 +59 @@ Here's how customized AI agents work: - 2. On the navigation menu, choose **Amazon Q** , **AI agents**. + 2. On the navigation menu, choose **AI agent designer** , **AI agents**. @@ -54,0 +65,2 @@ Here's how customized AI agents work: + * **Orchestration** : An AI agent with agentic capabilities that orchestrates different use cases per customer needs. It can engage in multi-turn conversation and invoke pre-configured tools. It uses the **Orchestration** type of AI prompt. + @@ -75 +87 @@ Here's how customized AI agents work: -**Answer recommendation** and **Self service** support two types of AI prompts. If you choose to create a new AI prompt for one type but not the other, then the AI agent continues using the system default for the one you didn't replace. This way you can choose to override only specific parts of the default Amazon Q in Connect experience. +**Answer recommendation** and **Self service** support two types of AI prompts. If you choose to create a new AI prompt for one type but not the other, then the AI agent continues using the system default for the one you didn't replace. This way you can choose to override only specific parts of the default Connect AI agents experience. @@ -77 +89 @@ Here's how customized AI agents work: - 5. On the **Agent builder** page, you can specify the locale to use for the response. For a list of supported locales, see [Supported locale codes](./configure-language-support-for-q-in-connect.html#supported-locale-codes-q). + 5. On the **Agent builder** page, you can specify the locale to use for the response. For a list of supported locales, see [Supported locale codes](./ai-agent-configure-language-support.html#supported-locale-codes-q). @@ -79 +91 @@ Here's how customized AI agents work: -You can choose the locale for **Answer recommendation** , **Manual search** , **Email response** , **Email overview** , and **Email generative answer** types of AI agents. You cannot choose the locale for **Self-service** ; only English is supported. +You can choose the locale for **Orchestration** , **Answer recommendation** , **Manual search** , **Email response** , **Email overview** , and **Email generative answer** types of AI agents. You cannot choose the locale for **Self-service** ; only English is supported. @@ -96 +108 @@ If you don't specifically override a default AI prompt with a customized one, th -To use the default out-of-the-box Amazon Q in Connect functionality, you add a [Amazon Q in Connect](./q-block.html) block to your flows. This block associates the Assistant and the default mapping of AI agents. +To use the default out-of-the-box Connect AI agents functionality, you add a [Connect assistant](./connect-assistant-block.html) block to your flows. This block associates the Assistant and the default mapping of AI agents. @@ -116 +128 @@ This section provides several sample AWS CLI commands to help you create and man - * Set AI agents for use with Amazon Q in Connect + * Set AI agents for use with Connect AI agents @@ -125 +137 @@ This section provides several sample AWS CLI commands to help you create and man -Amazon Q in Connect uses the AI prompt version for its functionality if one is specified for an AI agent. Otherwise it defaults to the system behavior. +Connect AI agents uses the AI prompt version for its functionality if one is specified for an AI agent. Otherwise it defaults to the system behavior. @@ -131 +143 @@ Use the following sample AWS CLI command to create an AI agent that uses every c - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -151 +163 @@ Use the following sample AWS CLI command to create an answer recommendation AI a - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -169 +181 @@ Use the following sample AWS CLI command to specify an AI prompt version for man - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -181 +193 @@ Use the following sample AWS CLI command to specify an AI prompt version for man -You can use AI agents to configure which assistant associations Amazon Q in Connect should use and how it should use them. The association supported for customization is the knowledge base which supports: +You can use AI agents to configure which assistant associations Connect AI agents should use and how it should use them. The association supported for customization is the knowledge base which supports: @@ -198 +210 @@ For example, use the following AWS CLI command to create an AI agent with a cust - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -225 +237 @@ For example, use the following AWS CLI command to create an AI agent with a cust -Just like AI prompts, after an AI agent has been created, you can create a version which is an immutable instance of the AI agent that can be used by Amazon Q in Connect at runtime. +Just like AI prompts, after an AI agent has been created, you can create a version which is an immutable instance of the AI agent that can be used by Connect AI agents at runtime. @@ -231 +243 @@ Use the following sample AWS CLI command to create an AI agent version. - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -239 +251 @@ After a version has been created, the Id of the AI agent can be qualified by usi -### Set AI agents for use with Amazon Q in Connect +### Set AI agents for use with Connect AI agents @@ -241 +253 @@ After a version has been created, the Id of the AI agent can be qualified by usi -After you have created AI prompt versions and AI agent versions for your use case, you can set them for use with Amazon Q in Connect. +After you have created AI prompt versions and AI agent versions for your use case, you can set them for use with Connect AI agents. @@ -243 +255 @@ After you have created AI prompt versions and AI agent versions for your use cas -#### Set AI agent versions in the Amazon Q in Connect Assistant +#### Set AI agent versions in the Connect AI agents Assistant @@ -245 +257 @@ After you have created AI prompt versions and AI agent versions for your use cas -You can set an AI agent version as the default to be used in the Amazon Q in Connect Assistant. +You can set an AI agent version as the default to be used in the Connect AI agents Assistant. @@ -247 +259 @@ You can set an AI agent version as the default to be used in the Amazon Q in Con -Use the following sample AWS CLI command to set the AI agent version as the default. After the AI agent version is set, it will be used when the next Amazon Connect contact and associated Amazon Q in Connect session are created. +Use the following sample AWS CLI command to set the AI agent version as the default. After the AI agent version is set, it will be used when the next Amazon Connect contact and associated Connect AI agents session are created. @@ -251 +263 @@ Use the following sample AWS CLI command to set the AI agent version as the defa - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -257 +269 @@ Use the following sample AWS CLI command to set the AI agent version as the defa -#### Set AI agent versions in Amazon Q in Connect sessions +#### Set AI agent versions in Connect AI agents sessions @@ -259 +271 @@ Use the following sample AWS CLI command to set the AI agent version as the defa -You can also set an AI agent version for every distinct Amazon Q in Connect session when creating or updating a session. +You can also set an AI agent version for every distinct Connect AI agents session when creating or updating a session. @@ -265,2 +277,2 @@ Use the following sample AWS CLI command to set the AI agent version for every d - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ - --session-id <YOUR_Q_IN_CONNECT_SESSION_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ + --session-id <YOUR_CONNECT_AI_AGENT_SESSION_ID> \ @@ -272 +284 @@ Use the following sample AWS CLI command to set the AI agent version for every d -AI agent versions set on sessions take precedence over those set at the level of the Amazon Q in Connect Assistant, which in turn takes precedence over system defaults. This order of precedence can be used to set AI agent versions on sessions created for particular contact center business segments. For example, by using flows to automate the setting of AI agent versions for particular Amazon Connect queues [using a Lambda flow block](./connect-lambda-functions.html). +AI agent versions set on sessions take precedence over those set at the level of the Connect AI agents Assistant, which in turn takes precedence over system defaults. This order of precedence can be used to set AI agent versions on sessions created for particular contact center business segments. For example, by using flows to automate the setting of AI agent versions for particular Amazon Connect queues [using a Lambda flow block](./connect-lambda-functions.html). @@ -282 +294 @@ Use the following sample AWS CLI command to list AI agent versions and revert to - --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \ + --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \ @@ -287 +299 @@ Use the following sample AWS CLI command to list AI agent versions and revert to -`--origin SYSTEM` is specified as an argument to fetch the system AI agent versions. Without this argument, your customized AI agent versions will be listed. After the AI agent versions are listed, use them to reset to the default Amazon Q in Connect experience at the level of the Amazon Q in Connect Assistant or session; use the CLI command described in Set AI agents for use with Amazon Q in Connect. +`--origin SYSTEM` is specified as an argument to fetch the system AI agent versions. Without this argument, your customized AI agent versions will be listed. After the AI agent versions are listed, use them to reset to the default Connect AI agents experience at the level of the Connect AI agents Assistant or session; use the CLI command described in Set AI agents for use with Connect AI agents. @@ -297 +309 @@ Create AI guardrails -Set the language for Amazon Q in Connect +Set the language for Connect AI agents