AWS connect documentation change
Summary
Updated documentation for configuring multi-language support in Amazon Q in Connect, including restructuring content, adding configuration steps for locale settings in AI agents, and clarifying language limitations for contact transcript-based recommendations.
Security assessment
The changes focus on language configuration procedures and operational limitations (e.g., English-only support for transcript-based recommendations). There is no mention of security vulnerabilities, access controls, or data protection measures. The updates are functional/documentation improvements rather than security-related.
Diff
diff --git a/connect/latest/adminguide/configure-language-support-for-q-in-connect.md b/connect/latest/adminguide/configure-language-support-for-q-in-connect.md index cd081e39b..375bd7a50 100644 --- a/connect/latest/adminguide/configure-language-support-for-q-in-connect.md +++ b/connect/latest/adminguide/configure-language-support-for-q-in-connect.md @@ -5 +5 @@ -CLI command to set the localeSupported locale codes +Configuration StepsSupported locale codes: @@ -7 +7 @@ CLI command to set the localeSupported locale codes -# Set the language for Amazon Q in Connect +# Configure Language Support for Amazon Q in Connect @@ -9 +9 @@ CLI command to set the localeSupported locale codes -You can set up Amazon Q in Connect so agents can ask Q for assistance in the language of your choice. Amazon Q in Connect then provides answers and recommended step-by-step guides in that language. +Amazon Q in Connect enables agents to ask Q for assistance in multiple languages and Q will provide answers and recommended step-by-step guides in those languages. Q's default language is English (United States) and you can switch this by setting the "locale" configuration on the [AI Agent](./customize-q.html#ai-agents-customize-q). @@ -11 +11 @@ You can set up Amazon Q in Connect so agents can ask Q for assistance in the lan -By default Amazon Q in Connect provides support in English (United States). Recommendations triggered by contact transcripts for agent assistance use cases only work for English (United States, United Kingdom, Australia). +For the full list of supported locales, see Supported locales. @@ -13 +13 @@ By default Amazon Q in Connect provides support in English (United States). Reco -Before setting your locale: +To learn more about AI agent configuration, see [Setting AI Agent versions in the Amazon Q in Connect assistant](./customize-q.html#setting-ai-agents-for-use-customize-q). @@ -15 +15 @@ Before setting your locale: - * Ensure that the language of the knowledge contents matches the locale you're going to set in the AI agent. +## Configuration Steps @@ -17 +17 @@ Before setting your locale: - * Ensure that the language of `QueryAssistantRequest.queryInputData.queryTextInputData.text ` matches the locale you're going to set in the AI agent. +**To switch Amazon Q in Connect's language for agent assistance, follow these steps:** @@ -18,0 +19 @@ Before setting your locale: + 1. When creating or updating an AI agent, set the **locale** property under **configuration** as seen in the following example. The type of AI agent should be `MANUAL_SEARCH` (The system AI Agent cannot be updated) @@ -22 +22,0 @@ Before setting your locale: -###### To set the locale @@ -24 +23,0 @@ Before setting your locale: - 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** or **Edit** permission in it's security profile. @@ -26 +25,10 @@ Before setting your locale: - 2. On the navigation menu, choose **Amazon Q** , **AI agents**. + { + ... + "configuration": { + "manualSearchAIAgentConfiguration**"** : { + ... + "locale": "es_ES" + } + }, + ... + } @@ -28 +36 @@ Before setting your locale: - 3. On the **AI Agents** page, choose **Create AI Agent** and choose **Answer recommendation** or **Manual search** for the AI agent type. Or choose an existing customized manual AI agent you want to edit. + 1. For instructions on how to create/edit an AI agent and associate it to an Amazon Q in Connect domain or session, see [Setting AI Agents for use with Amazon Q in Connect](./customize-q.html#setting-ai-agents-for-use-customize-q). @@ -30 +37,0 @@ Before setting your locale: - 4. On the AI agent builder page, use the _Locale_ dropdown menu to choose your locale. @@ -32 +38,0 @@ Before setting your locale: - 5. Choose **Save** , and then choose **Publish** to create a version of the AI agent. @@ -34 +39,0 @@ Before setting your locale: - 6. In the **Defaults** section of the page, choose the new AI agent version as a default for the appropriate use case. @@ -35,0 +41 @@ Before setting your locale: +###### Important @@ -36,0 +43 @@ Before setting your locale: + * Recommendations triggered by contact transcripts for agent assistance use cases only work for English (United States, United Kingdom, Australia). @@ -37,0 +45 @@ Before setting your locale: + * For optimal performance, ensure that the language of the knowledge contents matches the locale set in the AI Agent. @@ -39 +47 @@ Before setting your locale: -## CLI command to set the locale + * For optimal performance, ensure that the language of `QueryAssistantRequest.queryInputData.queryTextInputData.text ` matches the locale set in the AI Agent. @@ -41 +48,0 @@ Before setting your locale: -Use the following sample AWS CLI command to set the locale of a **Manual search** AI agent. @@ -44,10 +50,0 @@ Use the following sample AWS CLI command to set the locale of a **Manual search* - { - ... - "configuration": { - "manualSearchAIAgentConfiguration**"** : { - ... - "locale": "es_ES" - } - }, - ... - } @@ -55 +52 @@ Use the following sample AWS CLI command to set the locale of a **Manual search* -## Supported locale codes +## Supported locale codes: @@ -57 +54 @@ Use the following sample AWS CLI command to set the locale of a **Manual search* -Amazon Q in Connect supports agent assistance uses cases in the following locales: +###### Languages supported for Amazon Q in Connect agent assistance use cases: @@ -198 +195 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Create AI agents +Assign permissions @@ -200 +197 @@ Create AI agents -Add custom data to an Amazon Q in Connect session +Access Amazon Q in Connect in the agent application