Adding scenario files.

Author: rlhagerm

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -138,6 +138,9 @@ bedrock-runtime_Converse_AnthropicClaude:
             - description: Send a text message to Anthropic Claude, using Bedrock's Converse API.
               snippet_tags:
                 - BedrockRuntime.dotnetv3.Converse_AnthropicClaude
+            - description: Send a conversation of messages to Anthropic Claude, using Bedrock's Converse API with a tool configuration.
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
     Python:
       versions:
         - sdk_version: 3
@@ -1197,6 +1200,20 @@ bedrock-runtime_Scenario_ToolUseDemo_AnthropicClaude:
   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: Anthropic Claude
   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."
+              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."
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.WeatherTool
+            - description: "The Converse API action with a tool configuration."
+              snippet_tags:
+                - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
     Python:
       versions:
         - sdk_version: 3

dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario/BedrockActionsWrapper.cs

@@ -7,6 +7,8 @@
 
 namespace ConverseToolScenario;
 
+// snippet-start:[Bedrock.ConverseTool.dotnetv3.SendConverseRequest]
+
 /// <summary>
 /// Wrapper class for interacting with the Amazon Bedrock Converse API.
 /// </summary>
@@ -26,7 +28,6 @@ public BedrockActionsWrapper(IAmazonBedrockRuntime bedrockClient, ILogger<Bedroc
         _logger = logger;
     }
 
-
     /// <summary>
     /// Sends a Converse request to the Amazon Bedrock Converse API.
     /// </summary>
@@ -66,10 +67,16 @@ public async Task<ConverseResponse> SendConverseRequestAsync(string modelId, str
 
             return response;
         }
+        catch (ModelNotReadyException ex)
+        {
+            _logger.LogError(ex, "Model not ready, please wait and try again.");
+            throw;
+        }
         catch (AmazonBedrockRuntimeException ex)
         {
             _logger.LogError(ex, "Error occurred while sending Converse request.");
             throw;
         }
     }
-}
+}
+// snippet-end:[Bedrock.ConverseTool.dotnetv3.SendConverseRequest]

dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario/ConverseToolScenario.cs

@@ -1,6 +1,8 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. 
 // SPDX-License-Identifier: Apache-2.0
 
+// snippet-start:[Bedrock.ConverseTool.dotnetv3.Scenario]
+
 using Amazon.BedrockRuntime;
 using Amazon.BedrockRuntime.Model;
 using Amazon.Runtime.Documents;
@@ -352,5 +354,5 @@ public static void PrintModelResponse(string message)
         Console.WriteLine(message);
         Console.WriteLine();
     }
-
-}
+}
+// snippet-end:[Bedrock.ConverseTool.dotnetv3.Scenario]

dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario/README.md

@@ -0,0 +1,59 @@
+# Bedrock Runtime Converse API with Tool Feature Scenario
+
+## Overview
+
+This example shows how to use AWS SDKs and the Amazon Bedrock Converse API to call a custom tool from a large language model (LLM) as part of a multistep conversation. The example creates a weather tool that leverages the Open-Meteo API to retrieve current weather information based on user input.
+
+[Bedrock Converse API with Tool Definition](https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use-inference-call.html).
+
+## ⚠ Important
+
+* Running this code might result in charges to your AWS account.
+* Running the tests might result in charges to your AWS account.
+* We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see [Grant least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege).
+* This code is not tested in every AWS Region. For more information, see [AWS Regional Services](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services).
+
+## Scenario
+
+This example illustrates a typical interaction between a generative AI model, an application, and connected tools or APIs to solve a problem or achieve a specific goal. The scenario follows these steps:
+
+1. Set up the system prompt and tool configuration. 
+2. Specify the AI model to be used (e.g., Anthropic Claude 3 Sonnet). 
+3. Create a client to interact with Amazon Bedrock. 
+4. Prompt the user for their weather request. 
+5. Send the user input including the conversation history to the model.
+6. The model processes the input and determines if a connected tool or API needs to be used. If this is the case, the model returns a tool use request with specific parameters needed to invoke the tool, and a unique tool use ID to correlate tool responses to the request.
+7. The scenario application invokes the tool to fetch weather data, and append the response and tool use ID to the conversation.
+8. The model uses the tool response to generate a final response. If additional tool requests are needed, the process is repeated.
+9. Once the final response is received and printed, the application returns to the prompt.
+
+### Prerequisites
+
+For general prerequisites, see the [README](../../../README.md) in the `dotnetv3` folder.
+
+### Resources
+
+No additional resources are needed for this scenario.
+
+### Instructions
+
+After the example compiles, you can run it from the command line. To do so, navigate to
+the folder that contains the .sln file and run the following command:
+
+```
+dotnet run
+```
+
+Alternatively, you can run the example from within your IDE.
+
+This starts an interactive scenario that walks you through exploring conditional requests for read, write, and copy operations.
+
+## Additional resources
+
+- [Documentation: The Amazon Bedrock User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html)
+- [Tutorials: A developer's guide to Bedrock's new Converse API](https://community.aws/content/2dtauBCeDa703x7fDS9Q30MJoBA/amazon-bedrock-converse-api-developer-guide)
+- [More examples: Amazon Bedrock code examples and scenarios in multiple programming languages](https://docs.aws.amazon.com/bedrock/latest/userguide/service_code_examples.html)
+
+---
+
+Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0

dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario/ToolResponse.cs

@@ -1,6 +1,8 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. 
 // SPDX-License-Identifier: Apache-2.0
 
+// snippet-start:[Bedrock.ConverseTool.dotnetv3.ToolResponse]
+
 namespace ConverseToolScenario;
 
 /// <summary>
@@ -10,4 +12,5 @@ public class ToolResponse
 {
     public string ToolUseId { get; set; } = null!;
     public dynamic Content { get; set; } = null!;
-}
+}
+// snippet-end:[Bedrock.ConverseTool.dotnetv3.ToolResponse]

dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario/ToolSpec.json

@@ -1,6 +1,8 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. 
 // SPDX-License-Identifier: Apache-2.0
 
+// snippet-start:[Bedrock.ConverseTool.dotnetv3.WeatherTool]
+
 using Amazon.BedrockRuntime.Model;
 using Amazon.Runtime.Documents;
 using Microsoft.Extensions.Logging;
@@ -92,4 +94,5 @@ public async Task<Document> FetchWeatherDataAsync(string latitude, string longit
             throw;
         }
     }
-}
+}
+// snippet-end:[Bedrock.ConverseTool.dotnetv3.WeatherTool]

dotnetv3/Bedrock-runtime/Scenarios/ConverseToolScenario/WeatherTool.cs

@@ -11,10 +11,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Tests", "Tests", "{898AFE57
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "BedrockTests", "Tests\BedrockTests.csproj", "{5486426B-A8E8-4C6A-BEE2-83DD7CDB68A6}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Scenarios", "Scenarios", "{A3F7526C-B026-497B-A9A5-D503BB53EF72}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ConverseToolScenario", "Scenarios\ConverseToolScenario\ConverseToolScenario.csproj", "{1CF238B1-BCA5-4615-9F43-36BC2D61E7C6}"
-EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -29,18 +25,13 @@ Global
 		{5486426B-A8E8-4C6A-BEE2-83DD7CDB68A6}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{5486426B-A8E8-4C6A-BEE2-83DD7CDB68A6}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{5486426B-A8E8-4C6A-BEE2-83DD7CDB68A6}.Release|Any CPU.Build.0 = Release|Any CPU
-		{1CF238B1-BCA5-4615-9F43-36BC2D61E7C6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{1CF238B1-BCA5-4615-9F43-36BC2D61E7C6}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{1CF238B1-BCA5-4615-9F43-36BC2D61E7C6}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{1CF238B1-BCA5-4615-9F43-36BC2D61E7C6}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
 	GlobalSection(NestedProjects) = preSolution
 		{C47E3B3E-0040-4CB6-AB92-EF4395C1EB83} = {0DD1E95E-9EF2-4E43-86B3-F636736BE054}
 		{5486426B-A8E8-4C6A-BEE2-83DD7CDB68A6} = {898AFE57-24C6-4D79-81C2-614873B38F62}
-		{1CF238B1-BCA5-4615-9F43-36BC2D61E7C6} = {A3F7526C-B026-497B-A9A5-D503BB53EF72}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {3D82D9F6-BE3C-40F1-9224-B8E4D746FC2E}