AWS nova documentation change
Summary
Expanded documentation for turn-taking configuration including JSON configuration example, sensitivity level details, and added pause duration reference table
Security assessment
Changes focus on improving documentation of conversation flow tuning parameters (response timing and pause durations) without mentioning security vulnerabilities, access controls, or data protection mechanisms. The endpointingSensitivity parameter optimization relates to user experience rather than security controls.
Diff
diff --git a/nova/latest/nova2-userguide/sonic-turn-taking.md b/nova/latest/nova2-userguide/sonic-turn-taking.md index 88201c70a..55eb1013f 100644 --- a//nova/latest/nova2-userguide/sonic-turn-taking.md +++ b//nova/latest/nova2-userguide/sonic-turn-taking.md @@ -5 +5 @@ -API configurationSensitivity levels +API configurationSensitivity levelsPause duration reference @@ -9 +9 @@ API configurationSensitivity levels -Use turn-taking controllability to adjust how Amazon Nova 2 Sonic detects when a user has finished speaking. This feature helps optimize the conversational experience for different use cases and user speaking patterns. +Turn-taking is a fundamental aspect of natural conversation. Amazon Nova 2 Sonic provides fine-grained control over when the AI takes its turn to speak through the turnDetectionConfiguration parameter. This allows you to optimize the conversation flow for different use cases, balancing responsiveness with accuracy. The endpointingSensitivity parameter controls how quickly Amazon Nova 2 Sonic detects the end of a user's turn and begins responding. This setting affects both the latency of responses and the likelihood of interrupting users who are still speaking. @@ -13 +13,18 @@ Use turn-taking controllability to adjust how Amazon Nova 2 Sonic detects when a -The `endpointingSensitivity` parameter controls how quickly Nova Sonic detects when a user has finished speaking. This parameter is set in the `RequestStartEvent` during session initialization. +Configure turn detection sensitivity in the sessionStart event: + + + { + "event": { + "sessionStart": { + "inferenceConfiguration": { + "maxTokens": 1000, + "topP": 0.9, + "temperature": 0.7 + }, + "turnDetectionConfiguration": { + "endpointingSensitivity": "HIGH" | "MEDIUM" | "LOW" + } + } + } + } + @@ -16,0 +34,2 @@ The `endpointingSensitivity` parameter controls how quickly Nova Sonic detects w +The endpointingSensitivity parameter accepts three values: HIGH, MEDIUM, and LOW. Each level balances response speed against the risk of interrupting users who are still speaking. + @@ -20 +39 @@ HIGH -Detects pauses quickly, enabling faster responses but may cut off slower speakers +Fastest response time, optimized for latency. Nova Sonic responds as quickly as possible after detecting the end of speech. Pause duration: 1.5 seconds. Best for quick Q and A, command-and-control applications, and time-sensitive interactions. @@ -25 +44 @@ MEDIUM -Balanced sensitivity for most conversational scenarios (recommended default) +Balanced approach with moderate response time. Reduces false positives while maintaining responsiveness. Pause duration: 1.75 seconds. Best for general conversations, customer service with complex queries, and multi-turn discussions. @@ -30 +49,9 @@ LOW -Waits longer before detecting end of speech, better for thoughtful or hesitant speakers +Slowest response time with maximum patience. Nova Sonic waits the longest before responding, minimizing interruptions of users who pause while thinking. Pause duration: 2 seconds. Best for thoughtful conversations, elderly or speech-impaired users, and complex problem-solving. + +## Pause duration reference + +Sensitivity level | Pause duration (seconds) +---|--- +High (fast) | 1.5 +Medium | 1.75 +Low (slow) | ~2.0