AWS connect documentation change
Summary
Added detailed configuration guidance for Amazon Polly voice settings including engine requirements, voice/style compatibility, and error scenarios.
Security assessment
Documentation update focuses on proper voice configuration and error handling. While misconfiguration could lead to service errors, there's no evidence of addressing security vulnerabilities or adding security features.
Diff
diff --git a/connect/latest/adminguide/set-voice.md b/connect/latest/adminguide/set-voice.md index bcd9a2ce9..befc3989e 100644 --- a//connect/latest/adminguide/set-voice.md +++ b//connect/latest/adminguide/set-voice.md @@ -5 +5 @@ -DescriptionSupported channelsFlow typesPropertiesUse an Amazon Lex V2 bot with Amazon ConnectConfiguration tipsConfigured blockScenarios +DescriptionSupported channelsFlow typesPropertiesConfigurationUse an Amazon Lex V2 bot with Amazon ConnectConfiguration tipsConfigured blockScenarios @@ -75,0 +76,36 @@ You can also set language, voice, engine and style dynamically. There are a few +## Configuration + +For a list of valid language codes, voices, and supported engines, see [Available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html) in the Amazon Polly Developer Guide . + +###### Note + +Amazon Connect supports standard and neural engines, so you can pass either standard or neural as values into the engine parameter. + +To set the language attribute, pass in the specific language code into the parameter (for example, en-US or ar-AE). For the voice, simply pass the name of the voice (for example, Joanna or Hala). + +Amazon Connect also supports speaking styles, which can be defined as None, Conversational, or Newscaster. The Newscaster and Conversational styles are both available for the following voices in the neural engine: + + * Matthew (en-US) + + * Joanna (en-US) + + * Lupe (es-US) + + * Amy (en-GB) + + + + +###### Note + +If you don't specify an engine, the standard engine is used by default. However, some voices, such as Ruth (en-US), don't support the standard engine. For these voices, you must specify a supported engine. If you don't, the operation fails because Ruth doesn't support the standard engine. + +The following table contains some examples on configurations and their results: + +Configuration Examples Language Code | Voice | Engine | Speaking style | Result + Reasoning +---|---|---|---|--- +en-US | Ruth | N/D | N/D | **Error branch:** engine is not specified, thus it defaults to standard. Ruth does not support standard engine, which results in error branch being taken. +en-US | Ruth | neural | none | **Success branch:** Ruth supports neural engine +en-US | Ruth | neural | conversational | **Success branch:** Even though Ruth does not support conversational speech style, the block does not take the error branch. Instead, when the voice is synthesized, it just uses no speaking style. +ar-AE | Ruth | neural | none | **Success branch:** This block does not do validation on language code. Only the voice is used to synthesize speech. However, language code being incorrect may result in erroneous behavior when used with Lex V2 bots. +