Change "Agents for Amazon Bedrock" to "Amazon Bedrock Agents" (#6834)

DennisTraub · Dennis Traub · web-flow · commit 6f2c61ff615a · 2024-09-11T13:31:29.000-04:00
* Change "Agents for Amazon Bedrock" to "Amazon Bedrock Agents"
---------

Co-authored-by: Dennis Traub &lt;dennist.traub@gmail.com&gt;
diff --git a/.doc_gen/cross-content/cross_ServerlessPromptChaining_Python_block.xml b/.doc_gen/cross-content/cross_ServerlessPromptChaining_Python_block.xml
@@ -8,7 +8,7 @@
         The &BRlong; Serverless Prompt Chaining scenario demonstrates how
         <ulink  type="documentation"  url="step-functions/latest/dg/welcome.html">&SFNlong;</ulink>,
         <ulink  type="documentation"  url="bedrock/latest/userguide/what-is-bedrock.html">&BRlong;</ulink>,
-        and <ulink  type="documentation"  url="bedrock/latest/userguide/agents.html">Agents for &BRlong;</ulink>
+        and <ulink  type="documentation"  url="bedrock/latest/userguide/agents.html">&BRAlong;</ulink>
         can be used to build and orchestrate complex, serverless, and highly scalable generative AI applications.
         It contains the following working examples:
     </para>
diff --git a/.doc_gen/cross-content/phrases-code-examples.ent b/.doc_gen/cross-content/phrases-code-examples.ent
@@ -89,11 +89,11 @@
 <!ENTITY BRRUNlong '&BRlong; Runtime'>
 <!ENTITY BRRUN '&BR; Runtime'>
 
-<!--Bedrock-->
-<!ENTITY BRAlong 'Agents for Amazon Bedrock'>
-<!ENTITY BRA 'Agents for Amazon Bedrock'>
+<!--Bedrock Agents-->
+<!ENTITY BRAlong 'Amazon Bedrock Agents'>
+<!ENTITY BRA 'Amazon Bedrock Agents'>
 
-<!--Bedrock Runtime-->
+<!--Bedrock Agents Runtime-->
 <!ENTITY BRARUNlong '&BRAlong; Runtime'>
 <!ENTITY BRARUN '&BRA; Runtime'>
 
diff --git a/.doc_gen/metadata/bedrock-agent_metadata.yaml b/.doc_gen/metadata/bedrock-agent_metadata.yaml
@@ -1,8 +1,8 @@
 # zexi 0.4.0
 bedrock-agent_Hello:
-  title: Hello Agents for &BR;
-  title_abbrev: Hello Agents for &BR;
-  synopsis: get started using Agents for &BR;.
+  title: Hello &BRA;
+  title_abbrev: Hello &BRA;
+  synopsis: get started using &BRA;.
   category: Hello
   languages:
     JavaScript:
@@ -186,7 +186,7 @@ bedrock-agent_PrepareAgent:
   services:
     bedrock-agent: {PrepareAgent}
 bedrock-agent_GettingStartedWithBedrockAgents:
-  title: An end-to-end example showing how to create and invoke &BR; agents using an &AWS; SDK
+  title: An end-to-end example showing how to create and invoke &BRA; using an &AWS; SDK
   title_abbrev: Create and invoke an agent
   synopsis_list:
     - Create an execution role for the agent.
diff --git a/.github/workflows/validate-doc-metadata.yml b/.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@2024-09-04-A
+        uses: awsdocs/aws-doc-sdk-examples-tools@2024-09-11-A
         with:
           doc_gen_only: "False"
           strict_titles: "True"
diff --git a/.gitignore b/.gitignore
@@ -11,6 +11,7 @@
 .recommenders
 .swiftpm
 .venv
+.vs
 .vscode
 Package.resolved
 build_dir
@@ -33,4 +34,4 @@ rust_dev_preview
 kotlin/services/**/build/
 kotlin/services/**/gradle/
 kotlin/services/**/gradlew
-kotlin/services/**/gradlew.bat
+kotlin/services/**/gradlew.bat
diff --git a/javascriptv3/example_code/bedrock-agent-runtime/README.md b/javascriptv3/example_code/bedrock-agent-runtime/README.md
@@ -1,13 +1,13 @@
-# Agents for Amazon Bedrock Runtime code examples for the SDK for JavaScript (v3)
+# Amazon Bedrock Agents Runtime code examples for the SDK for JavaScript (v3)
 
 ## Overview
 
-Shows how to use the AWS SDK for JavaScript (v3) to work with Agents for Amazon Bedrock Runtime.
+Shows how to use the AWS SDK for JavaScript (v3) to work with Amazon Bedrock Agents Runtime.
 
 <!--custom.overview.start-->
 <!--custom.overview.end-->
 
-_Agents for Amazon Bedrock Runtime offers you the ability to run autonomous agents in your application._
+_Amazon Bedrock Agents Runtime offers you the ability to run autonomous agents in your application._
 
 ## ⚠ Important
 
@@ -27,9 +27,6 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javas
 
 
 <!--custom.prerequisites.start-->
-
-> ⚠ You must create an agent before you can invoke it. For more information, see [Create an agent](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-create.html). Additionally, you must grant access to the model you specify during agent creation. For more information, see [Model access](https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/modelaccess).
-
 <!--custom.prerequisites.end-->
 
 ### Single actions
@@ -92,9 +89,9 @@ in the `javascriptv3` folder.
 
 ## Additional resources
 
-- [Agents for Amazon Bedrock Runtime User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
-- [Agents for Amazon Bedrock Runtime API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html)
-- [SDK for JavaScript (v3) Agents for Amazon Bedrock Runtime reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agent-runtime)
+- [Amazon Bedrock Agents Runtime User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
+- [Amazon Bedrock Agents Runtime API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html)
+- [SDK for JavaScript (v3) Amazon Bedrock Agents Runtime reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agent-runtime)
 
 <!--custom.resources.start-->
 <!--custom.resources.end-->
diff --git a/javascriptv3/example_code/bedrock-agent/README.md b/javascriptv3/example_code/bedrock-agent/README.md
@@ -1,13 +1,13 @@
-# Agents for Amazon Bedrock code examples for the SDK for JavaScript (v3)
+# Amazon Bedrock Agents code examples for the SDK for JavaScript (v3)
 
 ## Overview
 
-Shows how to use the AWS SDK for JavaScript (v3) to work with Agents for Amazon Bedrock.
+Shows how to use the AWS SDK for JavaScript (v3) to work with Amazon Bedrock Agents.
 
 <!--custom.overview.start-->
 <!--custom.overview.end-->
 
-_Agents for Amazon Bedrock offer you the ability to build and configure autonomous agents in your application._
+_Amazon Bedrock Agents offer you the ability to build and configure autonomous agents in your application._
 
 ## ⚠ Important
 
@@ -27,14 +27,11 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javas
 
 
 <!--custom.prerequisites.start-->
-
-> ⚠ You must request access to a foundation model before you can use it. If you try to use the foundation model before you have requested access to it, you will receive an error message. For more information, see [Model access](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html).
-
 <!--custom.prerequisites.end-->
 
 ### Get started
 
-- [Hello Agents for Amazon Bedrock](hello.js) (`GetAgent`)
+- [Hello Amazon Bedrock Agents](hello.js) (`GetAgent`)
 
 
 ### Single actions
@@ -84,9 +81,9 @@ for that file.
 <!--custom.instructions.start-->
 <!--custom.instructions.end-->
 
-#### Hello Agents for Amazon Bedrock
+#### Hello Amazon Bedrock Agents
 
-This example shows you how to get started using Agents for Amazon Bedrock.
+This example shows you how to get started using Amazon Bedrock Agents.
 
 ```bash
 node ./hello.js
@@ -108,9 +105,9 @@ in the `javascriptv3` folder.
 
 ## Additional resources
 
-- [Agents for Amazon Bedrock User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
-- [Agents for Amazon Bedrock API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html)
-- [SDK for JavaScript (v3) Agents for Amazon Bedrock reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agent)
+- [Amazon Bedrock Agents User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
+- [Amazon Bedrock Agents API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html)
+- [SDK for JavaScript (v3) Amazon Bedrock Agents reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agent)
 
 <!--custom.resources.start-->
 <!--custom.resources.end-->
diff --git a/python/example_code/bedrock-agent-runtime/README.md b/python/example_code/bedrock-agent-runtime/README.md
@@ -1,13 +1,13 @@
-# Agents for Amazon Bedrock Runtime code examples for the SDK for Python
+# Amazon Bedrock Agents Runtime code examples for the SDK for Python
 
 ## Overview
 
-Shows how to use the AWS SDK for Python (Boto3) to work with Agents for Amazon Bedrock Runtime.
+Shows how to use the AWS SDK for Python (Boto3) to work with Amazon Bedrock Agents Runtime.
 
 <!--custom.overview.start-->
 <!--custom.overview.end-->
 
-_Agents for Amazon Bedrock Runtime offers you the ability to run autonomous agents in your application._
+_Amazon Bedrock Agents Runtime offers you the ability to run autonomous agents in your application._
 
 ## ⚠ Important
 
@@ -69,9 +69,9 @@ in the `python` folder.
 
 ## Additional resources
 
-- [Agents for Amazon Bedrock Runtime User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
-- [Agents for Amazon Bedrock Runtime API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html)
-- [SDK for Python Agents for Amazon Bedrock Runtime reference](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agent-runtime.html)
+- [Amazon Bedrock Agents Runtime User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
+- [Amazon Bedrock Agents Runtime API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html)
+- [SDK for Python Amazon Bedrock Agents Runtime reference](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agent-runtime.html)
 
 <!--custom.resources.start-->
 <!--custom.resources.end-->
diff --git a/python/example_code/bedrock-agent-runtime/bedrock_agent_runtime_wrapper.py b/python/example_code/bedrock-agent-runtime/bedrock_agent_runtime_wrapper.py
@@ -4,8 +4,8 @@
 """
 Purpose
 
-Shows how to use the AWS SDK for Python (Boto3) with the Agents for Amazon
-Bedrock Runtime client to send prompts to an agent to process and respond to.
+Shows how to use the AWS SDK for Python (Boto3) with the Amazon Bedrock Agents Runtime
+client to send prompts to an agent to process and respond to.
 """
 
 import logging
@@ -18,12 +18,12 @@
 # snippet-start:[python.example_code.bedrock-agent-runtime.BedrockAgentsRuntimeWrapper.class]
 # snippet-start:[python.example_code.bedrock-agent-runtime.BedrockAgentRuntimeWrapper.decl]
 class BedrockAgentRuntimeWrapper:
-    """Encapsulates Agents for Amazon Bedrock Runtime actions."""
+    """Encapsulates Amazon Bedrock Agents Runtime actions."""
 
     def __init__(self, runtime_client):
         """
-        :param runtime_client: A low-level client representing the Agents for Amazon
-                               Bedrock Runtime. Describes the API operations for running
+        :param runtime_client: A low-level client representing the Amazon Bedrock Agents Runtime.
+                               Describes the API operations for running
                                inferences using Bedrock Agents.
         """
         self.agents_runtime_client = runtime_client
@@ -68,5 +68,4 @@ def invoke_agent(self, agent_id, agent_alias_id, session_id, prompt):
 
     # snippet-end:[python.example_code.bedrock-agent-runtime.InvokeAgent]
 
-
 # snippet-end:[python.example_code.bedrock-agent-runtime.BedrockAgentsRuntimeWrapper.class]
diff --git a/python/example_code/bedrock-agent/README.md b/python/example_code/bedrock-agent/README.md
@@ -1,13 +1,13 @@
-# Agents for Amazon Bedrock code examples for the SDK for Python
+# Amazon Bedrock Agents code examples for the SDK for Python
 
 ## Overview
 
-Shows how to use the AWS SDK for Python (Boto3) to work with Agents for Amazon Bedrock.
+Shows how to use the AWS SDK for Python (Boto3) to work with Amazon Bedrock Agents.
 
 <!--custom.overview.start-->
 <!--custom.overview.end-->
 
-_Agents for Amazon Bedrock offer you the ability to build and configure autonomous agents in your application._
+_Amazon Bedrock Agents offer you the ability to build and configure autonomous agents in your application._
 
 ## ⚠ Important
 
@@ -38,16 +38,16 @@ python -m pip install -r requirements.txt
 
 Code excerpts that show you how to call individual service functions.
 
-- [CreateAgent](bedrock_agent_wrapper.py#L33)
-- [CreateAgentActionGroup](bedrock_agent_wrapper.py#L62)
-- [CreateAgentAlias](bedrock_agent_wrapper.py#L97)
-- [DeleteAgent](bedrock_agent_wrapper.py#L119)
-- [DeleteAgentAlias](bedrock_agent_wrapper.py#L140)
-- [GetAgent](bedrock_agent_wrapper.py#L162)
-- [ListAgentActionGroups](bedrock_agent_wrapper.py#L209)
-- [ListAgentKnowledgeBases](bedrock_agent_wrapper.py#L238)
-- [ListAgents](bedrock_agent_wrapper.py#L186)
-- [PrepareAgent](bedrock_agent_wrapper.py#L267)
+- [CreateAgent](bedrock_agent_wrapper.py#L32)
+- [CreateAgentActionGroup](bedrock_agent_wrapper.py#L61)
+- [CreateAgentAlias](bedrock_agent_wrapper.py#L96)
+- [DeleteAgent](bedrock_agent_wrapper.py#L118)
+- [DeleteAgentAlias](bedrock_agent_wrapper.py#L139)
+- [GetAgent](bedrock_agent_wrapper.py#L161)
+- [ListAgentActionGroups](bedrock_agent_wrapper.py#L208)
+- [ListAgentKnowledgeBases](bedrock_agent_wrapper.py#L237)
+- [ListAgents](bedrock_agent_wrapper.py#L185)
+- [PrepareAgent](bedrock_agent_wrapper.py#L266)
 
 ### Scenarios
 
@@ -110,9 +110,9 @@ in the `python` folder.
 
 ## Additional resources
 
-- [Agents for Amazon Bedrock User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
-- [Agents for Amazon Bedrock API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html)
-- [SDK for Python Agents for Amazon Bedrock reference](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agent.html)
+- [Amazon Bedrock Agents User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)
+- [Amazon Bedrock Agents API Reference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html)
+- [SDK for Python Amazon Bedrock Agents reference](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agent.html)
 
 <!--custom.resources.start-->
 <!--custom.resources.end-->
diff --git a/python/example_code/bedrock-agent/bedrock_agent_wrapper.py b/python/example_code/bedrock-agent/bedrock_agent_wrapper.py
@@ -9,7 +9,6 @@
 """
 
 import logging
-import boto3
 from botocore.exceptions import ClientError
 
 logger = logging.getLogger(__name__)
@@ -23,7 +22,7 @@ class BedrockAgentWrapper:
     def __init__(self, client):
         """
         :param client: A Boto3 Amazon Bedrock Agents client, which is a low-level client that
-                       represents Agents for Amazon Bedrock and describes the API operations
+                       represents Amazon Bedrock Agents and describes the API operations
                        for creating and managing Bedrock Agent resources.
         """
         self.client = client
@@ -42,7 +41,7 @@ def create_agent(self, agent_name, foundation_model, role_arn, instruction):
         :param role_arn: The ARN of the IAM role with permissions needed by the agent.
         :param instruction: Instructions that tell the agent what it should do and how it should
                             interact with users.
-        :return: The response from Agents for Bedrock if successful, otherwise raises an exception.
+        :return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
         """
         try:
             response = self.client.create_agent(
@@ -61,7 +60,7 @@ def create_agent(self, agent_name, foundation_model, role_arn, instruction):
 
     # snippet-start:[python.example_code.bedrock-agent.CreateAgentActionGroup]
     def create_agent_action_group(
-        self, name, description, agent_id, agent_version, function_arn, api_schema
+            self, name, description, agent_id, agent_version, function_arn, api_schema
     ):
         """
         Creates an action group for an agent. An action group defines a set of actions that an
@@ -122,7 +121,7 @@ def delete_agent(self, agent_id):
         Deletes an Amazon Bedrock agent.
 
         :param agent_id: The unique identifier of the agent to delete.
-        :return: The response from Agents for Bedrock if successful, otherwise raises an exception.
+        :return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
         """
 
         try:
@@ -144,7 +143,7 @@ def delete_agent_alias(self, agent_id, agent_alias_id):
 
         :param agent_id: The unique identifier of the agent that the alias belongs to.
         :param agent_alias_id: The unique identifier of the alias to delete.
-        :return: The response from Agents for Bedrock if successful, otherwise raises an exception.
+        :return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
         """
 
         try:
@@ -221,9 +220,9 @@ def list_agent_action_groups(self, agent_id, agent_version):
 
             paginator = self.client.get_paginator("list_agent_action_groups")
             for page in paginator.paginate(
-                agentId=agent_id,
-                agentVersion=agent_version,
-                PaginationConfig={"PageSize": 10},
+                    agentId=agent_id,
+                    agentVersion=agent_version,
+                    PaginationConfig={"PageSize": 10},
             ):
                 action_groups.extend(page["actionGroupSummaries"])
 
@@ -250,9 +249,9 @@ def list_agent_knowledge_bases(self, agent_id, agent_version):
 
             paginator = self.client.get_paginator("list_agent_knowledge_bases")
             for page in paginator.paginate(
-                agentId=agent_id,
-                agentVersion=agent_version,
-                PaginationConfig={"PageSize": 10},
+                    agentId=agent_id,
+                    agentVersion=agent_version,
+                    PaginationConfig={"PageSize": 10},
             ):
                 knowledge_bases.extend(page["agentKnowledgeBaseSummaries"])
 
@@ -270,7 +269,7 @@ def prepare_agent(self, agent_id):
         Creates a DRAFT version of the agent that can be used for internal testing.
 
         :param agent_id: The unique identifier of the agent to prepare.
-        :return: The response from Agents for Bedrock if successful, otherwise raises an exception.
+        :return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
         """
         try:
             prepared_agent_details = self.client.prepare_agent(agentId=agent_id)
@@ -282,5 +281,4 @@ def prepare_agent(self, agent_id):
 
     # snippet-end:[python.example_code.bedrock-agent.PrepareAgent]
 
-
 # snippet-end:[python.example_code.bedrock-agent.BedrockAgentWrapper.class]
diff --git a/python/example_code/bedrock-agent/scenario_get_started_with_agents.py b/python/example_code/bedrock-agent/scenario_get_started_with_agents.py
diff --git a/python/test_tools/bedrock_agent_runtime_stubber.py b/python/test_tools/bedrock_agent_runtime_stubber.py
diff --git a/python/test_tools/bedrock_agent_stubber.py b/python/test_tools/bedrock_agent_stubber.py
