AWS code-library documentation change

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

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

Summary

Added JavaScript code example for using Bedrock's Converse API with Amazon Titan Text model

Security assessment

The change adds a code example demonstrating API usage but does not address security vulnerabilities or introduce security features

Diff

diff --git a/code-library/latest/ug/bedrock-runtime_example_bedrock-runtime_Converse_AmazonNovaText_section.md
index 4b8ad8fc8..4d0043379 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
@@ -347,0 +348,63 @@ Send a text message to Amazon Nova, using Bedrock's Converse API.
+JavaScript
+    
+
+**SDK for JavaScript (v3)**
+    
+
+###### 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/javascriptv3/example_code/bedrock-runtime#code-examples). 
+
+Send a text message to Amazon Nova, using Bedrock's Converse API.
+    
+    
+    // Use the Conversation API to send a text message to Amazon Titan Text.
+    
+    import {
+      BedrockRuntimeClient,
+      ConverseCommand,
+    } from "@aws-sdk/client-bedrock-runtime";
+    
+    // Create a Bedrock Runtime client in the AWS Region you want to use.
+    const client = new BedrockRuntimeClient({ region: "us-east-1" });
+    
+    // Set the model ID, e.g., Titan Text Premier.
+    const modelId = "amazon.titan-text-premier-v1:0";
+    
+    // Start a conversation with the user message.
+    const userMessage =
+      "Describe the purpose of a 'hello world' program in one line.";
+    const conversation = [
+      {
+        role: "user",
+        content: [{ text: userMessage }],
+      },
+    ];
+    
+    // Create a command with the model ID, the message, and a basic configuration.
+    const command = new ConverseCommand({
+      modelId,
+      messages: conversation,
+      inferenceConfig: { maxTokens: 512, temperature: 0.5, topP: 0.9 },
+    });
+    
+    try {
+      // Send the command to the model and wait for the response
+      const response = await client.send(command);
+    
+      // Extract and print the response text.
+      const responseText = response.output.message.content[0].text;
+      console.log(responseText);
+    } catch (err) {
+      console.log(`ERROR: Can't invoke '${modelId}'. Reason: ${err}`);
+      process.exit(1);
+    }
+    
+    
+    
+
+  * For API details, see [Converse](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-runtime/command/ConverseCommand) in _AWS SDK for JavaScript API Reference_. 
+
+
+
+