added the Bedrock converse example

Author: scmacdon

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -189,6 +189,22 @@ bedrock-runtime_Scenario_ToolUse:
   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:
+    Java:
+      versions:
+        - sdk_version: 2
+          github: javav2/example_code/bedrock-runtime
+          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."
+              snippet_tags:
+                - bedrock.converseTool.javav2.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.javav2.weathertool
+            - description: "The Converse API action with a tool configuration."
+              genai: some
+              snippet_tags:
+                - bedrockruntime.java2.converse.main   
     .NET:
       versions:
         - sdk_version: 3

javav2/example_code/bedrock-runtime/src/main/java/com/example/bedrockruntime/scenario/BedrockActions.java

@@ -1,34 +1,22 @@
 package com.example.bedrockruntime.scenario;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
-import org.json.JSONArray;
-import org.json.JSONObject;
+
 import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration;
-import software.amazon.awssdk.core.document.Document;
 import software.amazon.awssdk.core.retry.RetryMode;
 import software.amazon.awssdk.http.async.SdkAsyncHttpClient;
 import software.amazon.awssdk.http.nio.netty.NettyNioAsyncHttpClient;
 import software.amazon.awssdk.regions.Region;
 import software.amazon.awssdk.services.bedrockruntime.BedrockRuntimeAsyncClient;
-import software.amazon.awssdk.services.bedrockruntime.BedrockRuntimeClient;
-import software.amazon.awssdk.services.bedrockruntime.model.BedrockRuntimeException;
-import software.amazon.awssdk.services.bedrockruntime.model.ContentBlock;
 import software.amazon.awssdk.services.bedrockruntime.model.ConverseRequest;
 import software.amazon.awssdk.services.bedrockruntime.model.ConverseResponse;
 import software.amazon.awssdk.services.bedrockruntime.model.Message;
 import software.amazon.awssdk.services.bedrockruntime.model.SystemContentBlock;
 import software.amazon.awssdk.services.bedrockruntime.model.Tool;
 import software.amazon.awssdk.services.bedrockruntime.model.ToolConfiguration;
-import software.amazon.awssdk.services.bedrockruntime.model.ToolInputSchema;
 import software.amazon.awssdk.services.bedrockruntime.model.ToolSpecification;
-
 import java.time.Duration;
 import java.util.ArrayList;
-import java.util.HashMap;
 import java.util.List;
-import java.util.Map;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import java.util.concurrent.CompletableFuture;
 
 public class BedrockActions {
 
@@ -65,6 +53,7 @@ private BedrockRuntimeAsyncClient getClient() {
         return bedrockRuntimeClient;
     }
 
+    // snippet-start:[bedrockruntime.java2.converse.main]
     /**
      * Sends an asynchronous converse request to the AI model.
      *
@@ -107,6 +96,7 @@ public ConverseResponse sendConverseRequestAsync(String modelId, String systemPr
 
         return null;
     }
+    // snippet-end:[bedrockruntime.java2.converse.main]
 }
 
 

javav2/example_code/bedrock-runtime/src/main/java/com/example/bedrockruntime/scenario/BedrockScenario.java

@@ -4,26 +4,22 @@
 package com.example.bedrockruntime.scenario;
 
 import java.util.ArrayList;
-import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 import java.util.Scanner;
-import java.util.concurrent.CompletableFuture;
-
 import software.amazon.awssdk.core.document.Document;
 import software.amazon.awssdk.services.bedrockruntime.model.ContentBlock;
 import software.amazon.awssdk.services.bedrockruntime.model.ConversationRole;
 import software.amazon.awssdk.services.bedrockruntime.model.ConverseOutput;
 import software.amazon.awssdk.services.bedrockruntime.model.ConverseResponse;
-import software.amazon.awssdk.services.bedrockruntime.model.DocumentBlock;
 import software.amazon.awssdk.services.bedrockruntime.model.Message;
-import software.amazon.awssdk.services.bedrockruntime.model.StopReason;
 import software.amazon.awssdk.services.bedrockruntime.model.ToolResultBlock;
 import software.amazon.awssdk.services.bedrockruntime.model.ToolResultContentBlock;
 import software.amazon.awssdk.services.bedrockruntime.model.ToolSpecification;
 import software.amazon.awssdk.services.bedrockruntime.model.ToolUseBlock;
 
+// snippet-start:[bedrock.converseTool.javav2.scenario]
 /*
  This demo illustrates a tool use scenario using Amazon Bedrock's Converse API and a weather tool.
  The program interacts with a foundation model on Amazon Bedrock to provide weather information based on user
@@ -58,7 +54,6 @@ public class BedrockScenario {
         - Complete the entire process until you have all required data before sending the complete response.
         """;
 
-
     public static void main(String[] args) {
         Scanner scanner = new Scanner(System.in);
         System.out.println("""
@@ -95,7 +90,6 @@ public static void main(String[] args) {
         System.out.println(DASHES);
     }
 
-
     /**
      Starts the conversation with the user and handles the interaction with Bedrock.
      */
@@ -241,16 +235,6 @@ private static ToolResponse invokeTool(ToolUseBlock payload) {
         } else {
             String errorMessage = "The requested tool with name "+toolName +" does not exist.";
             System.out.println(errorMessage);
-            /*
-            Map<String, Object> content = new HashMap<>();
-            content.put("error", true);
-            content.put("message", errorMessage);
-
-            ToolResponse toolResponse = new ToolResponse();
-            toolResponse.setContent(content);
-            toolResponse.setToolUseId(payload.toolUseId());
-
-             */
             return null;
         }
     }
@@ -327,4 +311,5 @@ public static void printFooter()
         =================================================
         """);
     }
-}
+}
+// snippet-end:[bedrock.converseTool.javav2.scenario]

javav2/example_code/bedrock-runtime/src/main/java/com/example/bedrockruntime/scenario/WeatherTool.java

@@ -27,6 +27,7 @@
 
 import org.json.JSONObject;
 
+// snippet-start:[bedrock.converseTool.javav2.weathertool]
 public class WeatherTool {
 
     private static final Logger logger = LoggerFactory.getLogger(WeatherTool.class);
@@ -159,5 +160,5 @@ private static Document convertToDocument(Object value) {
         }
         return Document.fromNull(); // Handle null values safely
     }
-
 }
+// snippet-end:[bedrock.converseTool.javav2.weathertool]