Merge branch 'main' into nova/javascript

awsdocs · Feb 25, 2025 · de0b00d · de0b00d
2 parents 6079449 + f36435d
commit de0b00d
Show file tree

Hide file tree

Showing 112 changed files with 3,626 additions and 196 deletions.
diff --git a/.doc_gen/metadata/batch_metadata.yaml b/.doc_gen/metadata/batch_metadata.yaml
@@ -174,8 +174,6 @@ batch_CreateComputeEnvironment:
   services:
     batch: {CreateComputeEnvironment}
 batch_Scenario:
-  title: Learn core operations for'&BATCHlong; using an &AWS; SDK
-  title_abbrev: Learn &BATCH; core operations
   synopsis_list:
     - Create an &BATCH; compute environment.
     - Check the status of the compute environment.
@@ -185,7 +183,7 @@ batch_Scenario:
     - Get a list of jobs applicable to the job queue.
     - Check the status of job.
     - Delete &BATCH; resources.
-  category: Scenarios
+  category: Basics
   languages:
     Java:
       versions:

diff --git a/.doc_gen/metadata/bedrock-runtime_metadata.yaml b/.doc_gen/metadata/bedrock-runtime_metadata.yaml
@@ -21,6 +21,20 @@ bedrock-runtime_Hello:
             - description:
               snippet_files:
                 - javascriptv3/example_code/bedrock-runtime/hello.js
+
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          sdkguide:
+          excerpts:
+            - description: Send a prompt to a model with the InvokeModel operation.
+              snippet_tags:
+                - bedrock-runtime.example_code.hello_bedrock_invoke.complete
+            - description: Send a user message to a model with the Converse operation.
+              snippet_tags:
+                - bedrock-runtime.example_code.hello_bedrock_converse.complete
+
   services:
     bedrock-runtime: {InvokeModel}
 
@@ -94,6 +108,26 @@ bedrock-runtime_Converse_AmazonNovaText:
             - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
               snippet_tags:
                 - javascript.v3.bedrock-runtime.Converse_AmazonTitanText
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
+              snippet_tags:
+                - BedrockRuntime.dotnetv3.Converse_AmazonNovaText
+            - description: Send a conversation of messages to Amazon Nova using Bedrock's Converse API with a tool configuration.
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.Converse_AmazonNovaText
   services:
     bedrock-runtime: {Converse}
 
@@ -141,6 +175,60 @@ bedrock-runtime_Converse_AmazonTitanText:
   services:
     bedrock-runtime: {Converse}
 
+bedrock-runtime_Scenario_ToolUse:
+  title: "A tool use example illustrating how to connect AI models on &BR; with a custom tool or API"
+  title_abbrev: "Tool use with the Converse API"
+  synopsis: "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."
+  category: Scenarios
+  languages:
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario
+          excerpts:
+            - description: "The primary execution of the scenario flow. This scenario orchestrates the conversation between the user, the &BR; Converse API, and a weather tool."
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.Scenario
+            - description: "The weather tool used by the demo. This file defines the tool specification and implements the logic to retrieve weather data using from the Open-Meteo API."
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.WeatherTool
+            - description: "The Converse API action with a tool configuration."
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: "The primary execution script of the demo. This script orchestrates the conversation between the user, the &BR; Converse API, and a weather tool."
+              snippet_files:
+                - python/example_code/bedrock-runtime/cross-model-scenarios/tool_use_demo/tool_use_demo.py
+            - description: "The weather tool used by the demo. This script defines the tool specification and implements the logic to retrieve weather data using from the Open-Meteo API."
+              snippet_files:
+                - python/example_code/bedrock-runtime/cross-model-scenarios/tool_use_demo/weather_tool.py
+    Rust:
+      versions:
+        - sdk_version: 1
+          github: rustv1/examples/bedrock-runtime
+          excerpts:
+            - description: "The primary scenario and logic for the demo. This orchestrates the conversation between the user, the &BR; Converse API, and a weather tool."
+              snippet_tags:
+                - rust.bedrock-runtime.Converse_AnthropicClaude.tool-use
+            - description: "The weather tool used by the demo. This script defines the tool specification and implements the logic to retrieve weather data using from the Open-Meteo API."
+              snippet_tags:
+                - rust.bedrock-runtime.Converse_AnthropicClaude.tool-use.weather-tool
+            - description: "Utilities to print the Message Content Blocks."
+              snippet_tags:
+                - rust.bedrock-runtime.Converse_AnthropicClaude.tool-use.user-interface
+            - description: "Use statements, Error utility, and constants."
+              snippet_tags:
+                - rust.bedrock-runtime.Converse_AnthropicClaude.tool-use.supporting
+  services:
+    bedrock-runtime: {Converse}
+
 bedrock-runtime_Converse_AnthropicClaude:
   title: Invoke Anthropic Claude on &BR; using Bedrock's Converse API
   title_abbrev: "Converse"
@@ -351,6 +439,22 @@ bedrock-runtime_ConverseStream_AmazonNovaText:
             - description: Send a text message to Amazon Nova using Bedrock's Converse API and process the response stream in real-time.
               snippet_tags:
                 - javascript.v3.bedrock-runtime.Converse_Mistral
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova, using Bedrock's Converse API and process the response stream in real-time.
+              snippet_tags:
+                - BedrockRuntime.dotnetv3.ConverseStream_AmazonNovaText
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova, using Bedrock's Converse API and process the response stream in real-time.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.ConverseStream_AmazonNovaText
   services:
     bedrock-runtime: {ConverseStream}
 
@@ -643,6 +747,14 @@ bedrock-runtime_InvokeModel_TitanText:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
                 - bedrock-runtime.java2.InvokeModel_AmazonTitanText
+    Kotlin:
+      versions:
+        - sdk_version: 1
+          github: kotlin/services/bedrock-runtime
+          excerpts:
+            - description: Use the Invoke Model API to generate a short story.
+              snippet_tags:
+                - bedrock-runtime.kotlin.InvokeModel_AmazonTitanText
     .NET:
       versions:
         - sdk_version: 3
@@ -1147,6 +1259,22 @@ bedrock-runtime_InvokeModel_AmazonNovaImageGeneration:
             - description: Create an image with Amazon Nova Canvas.
               snippet_tags:
                 - javascript.v3.bedrock-runtime.InvokeModel_AmazonNovaImageGeneration
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Bedrock-runtime
+          excerpts:
+            - description: Create an image with Amazon Nova Canvas.
+              snippet_tags:
+                - BedrockRuntime.dotnetv3.InvokeModel_AmazonNovaImageGeneration
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-runtime
+          excerpts:
+            - description: Create an image with the Amazon Nova Canvas.
+              snippet_tags:
+                - python.example_code.bedrock-runtime.InvokeModel_AmazonNovaImageGeneration
   services:
     bedrock-runtime: {InvokeModel}
 
@@ -1269,6 +1397,32 @@ bedrock-runtime_InvokeModelWithResponseStream_TitanTextEmbeddings:
     bedrock-runtime: {InvokeModel}
 
 # 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"
+  title_abbrev: "Scenario: Tool use with the Converse API"
+  synopsis: "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."
+  category: Amazon Nova
+  languages:
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario
+          excerpts:
+            - description: "The primary execution of the scenario flow. This scenario orchestrates the conversation between the user, the &BR; Converse API, and a weather tool."
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.Scenario
+            - description: "The weather tool used by the demo. This file defines the tool specification and implements the logic to retrieve weather data using from the Open-Meteo API."
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.WeatherTool
+            - description: "The Converse API action with a tool configuration."
+              genai: some
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
+  services:
+    bedrock-runtime: {Converse}
+
 bedrock-runtime_Scenario_ToolUseDemo_AnthropicClaude:
   title: "A tool use demo illustrating how to connect AI models on &BR; with a custom tool or API"
   title_abbrev: "Scenario: Tool use with the Converse API"
@@ -1303,7 +1457,6 @@ bedrock-runtime_Scenario_ToolUseDemo_AnthropicClaude:
             - description: "Use statements, Error utility, and constants."
               snippet_tags:
                 - rust.bedrock-runtime.Converse_AnthropicClaude.tool-use.supporting
-
   services:
     bedrock-runtime: {Converse}