Merge branch 'main' into swift-bedrock

Author: beqqrry-aws

.doc_gen/metadata/bedrock-agent_metadata.yaml

@@ -185,6 +185,8 @@ bedrock-agent_PrepareAgent:
                 - python.example_code.bedrock-agent.PrepareAgent
   services:
     bedrock-agent: {PrepareAgent}
+
+
 bedrock-agent_GettingStartedWithBedrockAgents:
   title: An end-to-end example showing how to create and invoke &BRA; using an &AWS; SDK
   title_abbrev: Create and invoke an agent
@@ -209,3 +211,225 @@ bedrock-agent_GettingStartedWithBedrockAgents:
   services:
     bedrock-agent: {CreateAgent, CreateAgentActionGroup, CreateAgentAlias, DeleteAgent, DeleteAgentAlias, GetAgent, ListAgentActionGroups,
                     ListAgents, ListAgentKnowledgeBases, PrepareAgent}
+    
+
+
+bedrock-agent_GettingStartedWithBedrockFlows:
+  title: An end-to-end example showing how to create and invoke an Amazon Bedrock flow using an &AWS; SDK
+  title_abbrev: Create and invoke a flow
+  synopsis_list:
+    - Create an execution role for the flow.
+    - Create the flow.
+    - Deploy the fully configured flow.
+    - Invoke the flow with user-provided prompts.
+    - Delete all created resources.
+  category: Scenarios
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Generates a music playlist based on user-specified genre and number of songs.
+              snippet_tags:
+                - python.example_code.bedrock-agent-runtime.Scenario_GettingStartedBedrockFlows
+                - python.example_code.bedrock-agent-runtime.flow_invoke_flow
+                - python.example_code.bedrock-agent-runtime.run_playlist_flow
+                - python.example_code.bedrock-agent-runtime.Scenario_GettingStartedBedrockFlows_iam_role
+
+  services:
+    bedrock-agent: {CreateFlow, CreateFlowAlias, CreateFlowVersion, DeleteFlow, DeleteFlowVersion, DeleteFlowAlias, GetFlow, GetFlowAlias,
+                    GetFlowVersion, PrepareFlow}
+    bedrock-agent-runtime: {InvokeFlow}
+
+
+bedrock-agent_CreateFlow:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Create an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.create_flow
+  services:
+    bedrock-agent: {CreateFlow}
+
+bedrock-agent_PrepareFlow:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Prepare an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.prepare_flow
+  services:
+    bedrock-agent: {PrepareFlow}
+
+bedrock-agent_UpdateFlow:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Update an Amazon Bedrock Flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.update_flow
+  services:
+    bedrock-agent: {UpdateFlow}
+
+bedrock-agent_DeleteFlow:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Delete an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.delete_flow
+  services:
+    bedrock-agent: {DeleteFlow}
+
+bedrock-agent_GetFlow:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Get an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.get_flow
+  services:
+    bedrock-agent: {GetFlow}
+
+bedrock-agent_ListFlows:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: List Amazon Bedrock flows.
+              snippet_tags:
+                - python.example_code.bedrock-agent.list_flows
+
+  services:
+    bedrock-agent: {ListFlows}
+
+bedrock-agent_CreateFlowAlias:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Create an alias for an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.create_flow_alias
+
+  services:
+    bedrock-agent: {CreateFlowAlias}
+
+bedrock-agent_UpdateFlowAlias:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Update an alias for an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.update_flow_alias
+
+  services:
+    bedrock-agent: {UpdateFlowAlias}
+
+bedrock-agent_DeleteFlowAlias:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Delete an alias for an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.delete_flow_alias
+
+  services:
+    bedrock-agent: {DeleteFlowAlias}
+
+bedrock-agent_ListFlowAliases:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: List the aliases for an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.list_flow_aliases
+
+  services:
+    bedrock-agent: {ListFlowAliases}
+
+bedrock-agent_CreateFlowVersion:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Create a version of an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.create_flow_version
+
+  services:
+    bedrock-agent: {CreateFlowVersion}
+
+bedrock-agent_GetFlowVersion:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Get a version of an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.get_flow_version
+
+  services:
+    bedrock-agent: {GetFlowVersion}
+
+bedrock-agent_DeleteFlowVersion:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: Delete a version of an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.delete_flow_version
+
+  services:
+    bedrock-agent: {DeleteFlowVersion}
+
+bedrock-agent_ListFlowVersions:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/bedrock-agent
+          excerpts:
+            - description: List the versions of an Amazon Bedrock flow.
+              snippet_tags:
+                - python.example_code.bedrock-agent.list_flow_versions
+
+  services:
+    bedrock-agent: {ListFlowVersions}

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -72,14 +72,6 @@ bedrock-runtime_Converse_Ai21LabsJurassic2:
             - description: Send a text message to AI21 Labs Jurassic-2, using Bedrock's Converse API.
               snippet_tags:
                 - python.example_code.bedrock-runtime.Converse_Ai21LabsJurassic2
-    JavaScript:
-      versions:
-        - sdk_version: 3
-          github: javascriptv3/example_code/bedrock-runtime
-          excerpts:
-            - description: Send a text message to AI21 Labs Jurassic-2, using Bedrock's Converse API.
-              snippet_tags:
-                - javascript.v3.bedrock-runtime.Converse_Ai21LabsJurassic2
   services:
     bedrock-runtime: {Converse}
 
@@ -108,6 +100,10 @@ bedrock-runtime_Converse_AmazonNovaText:
             - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
               snippet_tags:
                 - javascript.v3.bedrock-runtime.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.javascriptv3.SendConverseRequest
     Kotlin:
       versions:
         - sdk_version: 1
@@ -189,6 +185,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
@@ -206,6 +218,15 @@ bedrock-runtime_Scenario_ToolUse:
               genai: some
               snippet_tags:
                 - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/bedrock-runtime/scenarios/converse_tool_scenario
+          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.javascriptv3.Scenario
     Python:
       versions:
         - sdk_version: 3
@@ -739,14 +760,6 @@ bedrock-runtime_InvokeModel_Ai21LabsJurassic2:
               snippet_tags:
                 - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeJurassic2
-    JavaScript:
-      versions:
-        - sdk_version: 3
-          github: javascriptv3/example_code/bedrock-runtime
-          excerpts:
-            - description: Use the Invoke Model API to send a text message.
-              snippet_files:
-                - javascriptv3/example_code/bedrock-runtime/models/ai21LabsJurassic2/invoke_model.js
     PHP:
       versions:
         - sdk_version: 3
@@ -1484,6 +1497,22 @@ bedrock-runtime_Scenario_ToolUseDemo_AmazonNova:
   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:
+    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
@@ -1501,6 +1530,15 @@ bedrock-runtime_Scenario_ToolUseDemo_AmazonNova:
               genai: some
               snippet_tags:
                 - Bedrock.ConverseTool.dotnetv3.SendConverseRequest
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/bedrock-runtime/scenarios/converse_tool_scenario
+          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.javascriptv3.Scenario
   services:
     bedrock-runtime: {Converse}