Merge branch 'main' into gausekha-kb-python-examples

Author: beqqrry-aws

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -1001,9 +1001,9 @@ bedrock-runtime_InvokeModel_CohereCommandR:
     bedrock-runtime: {InvokeModel}
 
 bedrock-runtime_InvokeModel_MetaLlama3:
-  title: Invoke Meta Llama 3 on &BR; using the Invoke Model API
-  title_abbrev: "InvokeModel: Llama 3"
-  synopsis: send a text message to Meta Llama 3, using the Invoke Model API.
+  title: Invoke Meta Llama on &BR; using the Invoke Model API
+  title_abbrev: "InvokeModel"
+  synopsis: send a text message to Meta Llama, using the Invoke Model API.
   category: Meta Llama
   languages:
     Java:
@@ -1233,9 +1233,9 @@ bedrock-runtime_InvokeModelWithResponseStream_CohereCommandR:
     bedrock-runtime: {InvokeModel}
 
 bedrock-runtime_InvokeModelWithResponseStream_MetaLlama3:
-  title: Invoke Meta Llama 3 on &BR; using the Invoke Model API with a response stream
-  title_abbrev: "InvokeModelWithResponseStream: Llama 3"
-  synopsis: send a text message to Meta Llama 3, using the Invoke Model API, and print the response stream.
+  title: Invoke Meta Llama on &BR; using the Invoke Model API with a response stream
+  title_abbrev: "InvokeModelWithResponseStream"
+  synopsis: send a text message to Meta Llama, using the Invoke Model API, and print the response stream.
   category: Meta Llama
   languages:
     Java:
@@ -1522,6 +1522,109 @@ bedrock-runtime_InvokeModelWithResponseStream_TitanTextEmbeddings:
   services:
     bedrock-runtime: {InvokeModel}
 
+# Document understanding
+bedrock-runtime_DocumentUnderstanding_AmazonNova:
+  title: Send and process a document with Amazon Nova on &BR;
+  title_abbrev: "Document understanding"
+  synopsis: send and process a document with Amazon Nova on &BR;.
+  category: Amazon Nova
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send and process a document with Amazon Nova on &BR;.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.DocumentUnderstanding_AmazonNovaText
+  services:
+    bedrock-runtime: {Converse}
+
+bedrock-runtime_DocumentUnderstanding_AnthropicClaude:
+  title: Send and process a document with Anthropic Claude on &BR;
+  title_abbrev: "Document understanding"
+  synopsis: send and process a document with Anthropic Claude on &BR;.
+  category: Anthropic Claude
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send and process a document with Anthropic Claude on &BR;.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.DocumentUnderstanding_AnthropicClaude
+  services:
+    bedrock-runtime: {Converse}
+
+bedrock-runtime_DocumentUnderstanding_CohereCommand:
+  title: Send and process a document with Cohere Command models on &BR;
+  title_abbrev: "Document understanding"
+  synopsis: send and process a document with Cohere Command models on &BR;.
+  category: Cohere Command
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send and process a document with Cohere Command models on &BR;.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.DocumentUnderstanding_CohereCommand
+  services:
+    bedrock-runtime: {Converse}
+
+bedrock-runtime_DocumentUnderstanding_DeepSeek:
+  title: Send and process a document with DeepSeek on &BR;
+  title_abbrev: "Document understanding"
+  synopsis: send and process a document with DeepSeek on &BR;.
+  category: DeepSeek
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send and process a document with DeepSeek on &BR;.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.DocumentUnderstanding_DeepSeek
+  services:
+    bedrock-runtime: {Converse}
+
+bedrock-runtime_DocumentUnderstanding_MetaLlama:
+  title: Send and process a document with Llama on &BR;
+  title_abbrev: "Document understanding"
+  synopsis: send and process a document with Llama on &BR;.
+  category: Meta Llama
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send and process a document with Llama on &BR;.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.DocumentUnderstanding_MetaLlama
+  services:
+    bedrock-runtime: {Converse}
+
+bedrock-runtime_DocumentUnderstanding_Mistral:
+  title: Send and process a document with Mistral models on &BR;
+  title_abbrev: "Document understanding"
+  synopsis: send and process a document with Mistral models on &BR;.
+  category: Mistral AI
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send and process a document with Mistral models on &BR;.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.DocumentUnderstanding_Mistral
+  services:
+    bedrock-runtime: {Converse}
+
 # Tool use scenarios
 bedrock-runtime_Scenario_ToolUseDemo_AmazonNova:
   title: "A tool use demo illustrating how to connect AI models on &BR; with a custom tool or API"

.github/workflows/validate-doc-metadata.yml

@@ -16,7 +16,7 @@ jobs:
       - name: checkout repo content
         uses: actions/checkout@v4
       - name: validate metadata
-        uses: awsdocs/aws-doc-sdk-examples-tools@2025.18.0
+        uses: awsdocs/aws-doc-sdk-examples-tools@2025.20.1
         with:
           doc_gen_only: "False"
           strict_titles: "True"

.gitignore

@@ -37,3 +37,4 @@ kotlin/services/**/gradle/
 kotlin/services/**/gradlew
 kotlin/services/**/gradlew.bat
 kotlin/services/**/.kotlin/
+/.local/

dotnetv3/Bedrock-runtime/README.md

@@ -77,8 +77,8 @@ functions within the same service.
 
 - [Converse](Models/MetaLlama/Converse/Converse.cs#L4)
 - [ConverseStream](Models/MetaLlama/ConverseStream/ConverseStream.cs#L4)
-- [InvokeModel: Llama 3](Models/MetaLlama/Llama3_InvokeModel/InvokeModel.cs#L4)
-- [InvokeModelWithResponseStream: Llama 3](Models/MetaLlama/Llama3_InvokeModelWithResponseStream/InvokeModelWithResponseStream.cs#L4)
+- [InvokeModel](Models/MetaLlama/Llama3_InvokeModel/InvokeModel.cs#L4)
+- [InvokeModelWithResponseStream](Models/MetaLlama/Llama3_InvokeModelWithResponseStream/InvokeModelWithResponseStream.cs#L4)
 
 ### Mistral AI
 

javascriptv3/example_code/bedrock-runtime/README.md

@@ -46,11 +46,6 @@ functions within the same service.
 - [Invoke multiple foundation models on Amazon Bedrock](scenarios/cli_text_playground.js)
 - [Tool use with the Converse API](scenarios/converse_tool_scenario/converse-tool-scenario.js)
 
-### AI21 Labs Jurassic-2
-
-- [Converse](models/ai21LabsJurassic2/converse.js#L4)
-- [InvokeModel](models/ai21LabsJurassic2/invoke_model.js)
-
 ### Amazon Nova
 
 - [Converse](models/amazonNovaText/converse.js#L4)
@@ -83,8 +78,8 @@ functions within the same service.
 
 - [Converse](models/metaLlama/converse.js#L4)
 - [ConverseStream](models/metaLlama/converseStream.js#L4)
-- [InvokeModel: Llama 3](models/metaLlama/llama3/invoke_model_quickstart.js#L4)
-- [InvokeModelWithResponseStream: Llama 3](models/metaLlama/llama3/invoke_model_with_response_stream_quickstart.js#L4)
+- [InvokeModel](models/metaLlama/llama3/invoke_model_quickstart.js#L4)
+- [InvokeModelWithResponseStream](models/metaLlama/llama3/invoke_model_with_response_stream_quickstart.js#L4)
 
 ### Mistral AI
 

javav2/example_code/bedrock-runtime/README.md

@@ -34,6 +34,15 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javav
 > see [Model access](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html).
 >
 <!--custom.prerequisites.end-->
+
+### Scenarios
+
+Code examples that show you how to accomplish a specific task by calling multiple
+functions within the same service.
+
+- [Generate videos from text prompts using Amazon Bedrock](../../usecases/video_generation_bedrock_nova_reel/src/main/java/com/example/novareel/VideoGenerationService.java)
+- [Tool use with the Converse API](src/main/java/com/example/bedrockruntime/scenario/BedrockScenario.java)
+
 ### AI21 Labs Jurassic-2
 
 - [Converse](src/main/java/com/example/bedrockruntime/models/ai21LabsJurassic2/Converse.java#L6)
@@ -43,6 +52,7 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javav
 
 - [Converse](src/main/java/com/example/bedrockruntime/models/amazon/nova/text/ConverseAsync.java#L6)
 - [ConverseStream](src/main/java/com/example/bedrockruntime/models/amazon/nova/text/ConverseStream.java#L6)
+- [Scenario: Tool use with the Converse API](src/main/java/com/example/bedrockruntime/scenario/BedrockScenario.java#L15)
 
 ### Amazon Nova Canvas
 
@@ -85,8 +95,8 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javav
 
 - [Converse](src/main/java/com/example/bedrockruntime/models/metaLlama/Converse.java#L6)
 - [ConverseStream](src/main/java/com/example/bedrockruntime/models/metaLlama/ConverseStream.java#L6)
-- [InvokeModel: Llama 3](src/main/java/com/example/bedrockruntime/models/metaLlama/Llama3_InvokeModel.java#L6)
-- [InvokeModelWithResponseStream: Llama 3](src/main/java/com/example/bedrockruntime/models/metaLlama/Llama3_InvokeModelWithResponseStream.java#L6)
+- [InvokeModel](src/main/java/com/example/bedrockruntime/models/metaLlama/Llama3_InvokeModel.java#L6)
+- [InvokeModelWithResponseStream](src/main/java/com/example/bedrockruntime/models/metaLlama/Llama3_InvokeModelWithResponseStream.java#L6)
 
 ### Mistral AI
 
@@ -111,7 +121,32 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javav
 <!--custom.instructions.start-->
 <!--custom.instructions.end-->
 
+#### Generate videos from text prompts using Amazon Bedrock
+
+This example shows you how to a Spring Boot app that generates videos from text prompts using Amazon Bedrock and the
+Nova-Reel model.
+
+
+<!--custom.scenario_prereqs.bedrock-runtime_Scenario_GenerateVideos_NovaReel.start-->
+<!--custom.scenario_prereqs.bedrock-runtime_Scenario_GenerateVideos_NovaReel.end-->
+
+
+<!--custom.scenarios.bedrock-runtime_Scenario_GenerateVideos_NovaReel.start-->
+<!--custom.scenarios.bedrock-runtime_Scenario_GenerateVideos_NovaReel.end-->
+
+#### Tool use with the Converse API
+
+This example shows you how to build a typical interaction between an application, a generative AI model, and connected
+tools or APIs to mediate interactions between the AI and the outside world. It uses the example of connecting an
+external weather API to the AI model so it can provide real-time weather information based on user input.
+
+
+<!--custom.scenario_prereqs.bedrock-runtime_Scenario_ToolUse.start-->
+<!--custom.scenario_prereqs.bedrock-runtime_Scenario_ToolUse.end-->
+
 
+<!--custom.scenarios.bedrock-runtime_Scenario_ToolUse.start-->
+<!--custom.scenarios.bedrock-runtime_Scenario_ToolUse.end-->
 
 ### Tests
 

kotlin/services/bedrock-runtime/README.md

@@ -35,10 +35,6 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `kotli
 - [Converse](src/main/kotlin/com/example/bedrockruntime/models/amazon/nova/text/Converse.kt#L6)
 - [ConverseStream](src/main/kotlin/com/example/bedrockruntime/models/amazon/nova/text/ConverseStream.kt#L6)
 
-### Amazon Nova Canvas
-
-- [InvokeModel](src/main/kotlin/com/example/bedrockruntime/models/amazon/nova/canvas/InvokeModel.kt#L6)
-
 ### Amazon Titan Text
 
 - [InvokeModel](src/main/kotlin/com/example/bedrockruntime/models/amazon/titan/text/InvokeModel.kt#L6)

python/example_code/bedrock-runtime/README.md

@@ -60,6 +60,7 @@ functions within the same service.
 
 - [Converse](models/amazon_nova/amazon_nova_text/converse.py#L4)
 - [ConverseStream](models/amazon_nova/amazon_nova_text/converse_stream.py#L4)
+- [Document understanding](models/amazon_nova/amazon_nova_text/document_understanding.py#L4)
 
 ### Amazon Nova Canvas
 
@@ -88,6 +89,7 @@ functions within the same service.
 
 - [Converse](models/anthropic_claude/converse.py#L4)
 - [ConverseStream](models/anthropic_claude/converse_stream.py#L4)
+- [Document understanding](models/anthropic_claude/document_understanding.py#L4)
 - [InvokeModel](models/anthropic_claude/invoke_model.py#L4)
 - [InvokeModelWithResponseStream](models/anthropic_claude/invoke_model_with_response_stream.py#L4)
 - [Scenario: Tool use with the Converse API](cross-model-scenarios/tool_use_demo/tool_use_demo.py)
@@ -96,23 +98,30 @@ functions within the same service.
 
 - [Converse](models/cohere_command/converse.py#L4)
 - [ConverseStream](models/cohere_command/converse_stream.py#L4)
+- [Document understanding](models/cohere_command/document_understanding.py#L4)
 - [InvokeModel: Command R and R+](models/cohere_command/command_r_invoke_model.py#L4)
 - [InvokeModel: Command and Command Light](models/cohere_command/command_invoke_model.py#L4)
 - [InvokeModelWithResponseStream: Command R and R+](models/cohere_command/command_r_invoke_model_with_response_stream.py#L4)
 - [InvokeModelWithResponseStream: Command and Command Light](models/cohere_command/command_invoke_model_with_response_stream.py#L4)
 - [Scenario: Tool use with the Converse API](cross-model-scenarios/tool_use_demo/tool_use_demo.py)
 
+### DeepSeek
+
+- [Document understanding](models/deepseek/document_understanding.py#L4)
+
 ### Meta Llama
 
 - [Converse](models/meta_llama/converse.py#L4)
 - [ConverseStream](models/meta_llama/converse_stream.py#L4)
-- [InvokeModel: Llama 3](models/meta_llama/llama3_invoke_model.py#L4)
-- [InvokeModelWithResponseStream: Llama 3](models/meta_llama/llama3_invoke_model_with_response_stream.py#L4)
+- [Document understanding](models/meta_llama/document_understanding.py#L4)
+- [InvokeModel](models/meta_llama/llama3_invoke_model.py#L4)
+- [InvokeModelWithResponseStream](models/meta_llama/llama3_invoke_model_with_response_stream.py#L4)
 
 ### Mistral AI
 
 - [Converse](models/mistral_ai/converse.py#L4)
 - [ConverseStream](models/mistral_ai/converse_stream.py#L4)
+- [Document understanding](models/mistral_ai/document_understanding.py#L4)
 - [InvokeModel](models/mistral_ai/invoke_model.py#L4)
 - [InvokeModelWithResponseStream](models/mistral_ai/invoke_model_with_response_stream.py#L4)
 
@@ -154,6 +163,26 @@ This example shows you how to get started using Amazon Bedrock Runtime.
 python hello/hello_bedrock_runtime_invoke.py
 ```
 
+#### Create and invoke a managed prompt
+
+This example shows you how to do the following:
+
+- Create a managed prompt.
+- Create a version of the prompt.
+- Invoke the prompt using the version.
+- Clean up resources (optional).
+
+<!--custom.scenario_prereqs.bedrock-agent_GettingStartedWithBedrockPrompts.start-->
+<!--custom.scenario_prereqs.bedrock-agent_GettingStartedWithBedrockPrompts.end-->
+
+Start the example by running the following at a command prompt:
+
+```
+python ../bedrock-agent/prompts/scenario_get_started_with_prompts.py
+```
+
+<!--custom.scenarios.bedrock-agent_GettingStartedWithBedrockPrompts.start-->
+<!--custom.scenarios.bedrock-agent_GettingStartedWithBedrockPrompts.end-->
 
 #### Create and invoke a managed prompt
 

python/example_code/bedrock-runtime/example-data/amazon-nova-service-cards.pdf

@@ -0,0 +1,54 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+# snippet-start:[python.example_code.bedrock-runtime.DocumentUnderstanding_AmazonNovaText]
+# Send and process a document with Amazon Nova on Amazon Bedrock.
+
+import boto3
+from botocore.exceptions import ClientError
+
+# Create a Bedrock Runtime client in the AWS Region you want to use.
+client = boto3.client("bedrock-runtime", region_name="us-east-1")
+
+# Set the model ID, e.g. Amazon Nova Lite.
+model_id = "amazon.nova-lite-v1:0"
+
+# Load the document
+with open("example-data/amazon-nova-service-cards.pdf", "rb") as file:
+    document_bytes = file.read()
+
+# Start a conversation with a user message and the document
+conversation = [
+    {
+        "role": "user",
+        "content": [
+            {"text": "Briefly compare the models described in this document"},
+            {
+                "document": {
+                    # Available formats: html, md, pdf, doc/docx, xls/xlsx, csv, and txt
+                    "format": "pdf",
+                    "name": "Amazon Nova Service Cards",
+                    "source": {"bytes": document_bytes},
+                }
+            },
+        ],
+    }
+]
+
+try:
+    # Send the message to the model, using a basic inference configuration.
+    response = client.converse(
+        modelId=model_id,
+        messages=conversation,
+        inferenceConfig={"maxTokens": 500, "temperature": 0.3},
+    )
+
+    # Extract and print the response text.
+    response_text = response["output"]["message"]["content"][0]["text"]
+    print(response_text)
+
+except (ClientError, Exception) as e:
+    print(f"ERROR: Can't invoke '{model_id}'. Reason: {e}")
+    exit(1)
+
+# snippet-end:[python.example_code.bedrock-runtime.DocumentUnderstanding_AmazonNovaText]