AWS code-library documentation change

Service: code-library · 2025-03-23 · Documentation low

File: code-library/latest/ug/bedrock-runtime_example_bedrock-runtime_Converse_AmazonNovaText_section.md

Summary

Added Kotlin SDK example for text generation with Amazon Nova via Bedrock's Converse API

Security assessment

Routine code example addition showing basic API usage. No security configurations, vulnerability mitigations, or security feature documentation present in the added content.

Diff

diff --git a/code-library/latest/ug/bedrock-runtime_example_bedrock-runtime_Converse_AmazonNovaText_section.md b/code-library/latest/ug/bedrock-runtime_example_bedrock-runtime_Converse_AmazonNovaText_section.md
index 872275aea..ed6dd6d23 100644
--- a/code-library/latest/ug/bedrock-runtime_example_bedrock-runtime_Converse_AmazonNovaText_section.md
+++ b/code-library/latest/ug/bedrock-runtime_example_bedrock-runtime_Converse_AmazonNovaText_section.md
@@ -431,0 +432,75 @@ Send a text message to Amazon Nova, using Bedrock's Converse API.
+Kotlin
+    
+
+**SDK for Kotlin**
+    
+
+###### Note
+
+There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/bedrock-runtime#code-examples). 
+
+Send a text message to Amazon Nova, using Bedrock's Converse API.
+    
+    
+    import aws.sdk.kotlin.services.bedrockruntime.BedrockRuntimeClient
+    import aws.sdk.kotlin.services.bedrockruntime.model.ContentBlock
+    import aws.sdk.kotlin.services.bedrockruntime.model.ConversationRole
+    import aws.sdk.kotlin.services.bedrockruntime.model.ConverseRequest
+    import aws.sdk.kotlin.services.bedrockruntime.model.Message
+    
+    /**
+     * This example demonstrates how to use the Amazon Nova foundation models to generate text.
+     * It shows how to:
+     * - Set up the Amazon Bedrock runtime client
+     * - Create a message
+     * - Configure and send a request
+     * - Process the response
+     */
+    suspend fun main() {
+        converse().also { println(it) }
+    }
+    
+    suspend fun converse(): String {
+        // Create and configure the Bedrock runtime client
+        BedrockRuntimeClient { region = "us-east-1" }.use { client ->
+    
+            // Specify the model ID. For the latest available models, see:
+            // https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html
+            val modelId = "amazon.nova-lite-v1:0"
+    
+            // Create the message with the user's prompt
+            val prompt = "Describe the purpose of a 'hello world' program in one line."
+            val message = Message {
+                role = ConversationRole.User
+                content = listOf(ContentBlock.Text(prompt))
+            }
+    
+            // Configure the request with optional model parameters
+            val request = ConverseRequest {
+                this.modelId = modelId
+                messages = listOf(message)
+                inferenceConfig {
+                    maxTokens = 500 // Maximum response length
+                    temperature = 0.5F // Lower values: more focused output
+                    // topP = 0.8F // Alternative to temperature
+                }
+            }
+    
+            // Send the request and process the model's response
+            runCatching {
+                val response = client.converse(request)
+                return response.output!!.asMessage().content.first().asText()
+            }.getOrElse { error ->
+                error.message?.let { e -> System.err.println("ERROR: Can't invoke '$modelId'. Reason: $e") }
+                throw RuntimeException("Failed to generate text with model $modelId", error)
+            }
+        }
+    }
+    
+    
+
+  * For API details, see [Converse](https://sdk.amazonaws.com/kotlin/api/latest/index.html) in _AWS SDK for Kotlin API reference_. 
+
+
+
+