AWS bedrock-agentcore documentation change
Summary
Updated documentation formatting and structure for adding various gateway targets (Lambda, API Gateway, OpenAPI, Smithy, MCP server). Changes include typographic corrections, heading level adjustments, and reorganization of example sections with numbered steps.
Security assessment
The changes are purely structural and formatting updates to improve documentation clarity and organization. There is no mention of security vulnerabilities, patches, or incident responses. The content updates are focused on presentation of examples and instructions without introducing or modifying security controls, configurations, or warnings.
Diff
diff --git a/bedrock-agentcore/latest/devguide/gateway-add-target-api-target-config.md b/bedrock-agentcore/latest/devguide/gateway-add-target-api-target-config.md index a9cb131b6..a9f4032c4 100644 --- a//bedrock-agentcore/latest/devguide/gateway-add-target-api-target-config.md +++ b//bedrock-agentcore/latest/devguide/gateway-add-target-api-target-config.md @@ -9 +9 @@ Add a Lambda targetAdd an API Gateway stage targetAdd an OpenAPI targetAdd a Smi -The target configuration depends on the target type that you're adding to the gateway. For more information about supported gateway target types, see [Supported targets for Amazon Bedrock AgentCore gateways](./gateway-supported-targets.html). +The target configuration depends on the target type that you’re adding to the gateway. For more information about supported gateway target types, see [Supported targets for Amazon Bedrock AgentCore gateways](./gateway-supported-targets.html). @@ -32 +32 @@ You can add a Lambda target to your gateway using the AgentCore CLI by specifyin -###### Target configuration +**Target configuration** @@ -47 +47 @@ Select one of the following methods: -AgentCore CLI +###### Example @@ -48,0 +49 @@ AgentCore CLI +AgentCore CLI @@ -50 +50,0 @@ AgentCore CLI -To add a Lambda function as a target, run `agentcore add gateway-target` with the `--type lambda-function-arn` option. Provide the Lambda ARN and a JSON file containing the tool schema: @@ -51,0 +52 @@ To add a Lambda function as a target, run `agentcore add gateway-target` with th + 1. To add a Lambda function as a target, run `agentcore add gateway-target` with the `--type lambda-function-arn` option. Provide the Lambda ARN and a JSON file containing the tool schema: @@ -61 +61,0 @@ To add a Lambda function as a target, run `agentcore add gateway-target` with th -AgentCore Python SDK @@ -64 +63,0 @@ AgentCore Python SDK -With the AgentCore CLI, you can easily create a Lambda target with default configurations. @@ -65,0 +65,4 @@ With the AgentCore CLI, you can easily create a Lambda target with default confi +AgentCore Python SDK + + + 1. With the AgentCore CLI, you can easily create a Lambda target with default configurations. @@ -124 +125,0 @@ The following is an example argument you can provide for the `target_payload`. I -Boto3 @@ -127 +127,0 @@ Boto3 -The following Python code shows how to add a Lambda target using the AWS Python SDK (Boto3): @@ -128,0 +129,4 @@ The following Python code shows how to add a Lambda target using the AWS Python +Boto3 + + + 1. The following Python code shows how to add a Lambda target using the AWS Python SDK (Boto3): @@ -178 +185 @@ Interactive -In the AgentCore CLI interactive terminal UI, run `agentcore`, select **add** , choose **Gateway Target** , and then select **Lambda function** : + 1. In the AgentCore CLI interactive terminal UI, run `agentcore` , select **add** , choose **Gateway Target** , and then select **Lambda function** : @@ -199 +209 @@ Select one of the following methods: -AgentCore CLI +###### Example @@ -200,0 +211 @@ AgentCore CLI +AgentCore CLI @@ -202 +212,0 @@ AgentCore CLI -To add an API Gateway REST API stage as a target, run `agentcore add gateway-target` with the `--type api-gateway` option: @@ -203,0 +214 @@ To add an API Gateway REST API stage as a target, run `agentcore add gateway-tar + 1. To add an API Gateway REST API stage as a target, run `agentcore add gateway-target` with the `--type api-gateway` option: @@ -213 +223,0 @@ To add an API Gateway REST API stage as a target, run `agentcore add gateway-tar -AWS CLI @@ -216 +226,2 @@ AWS CLI -The following command uses the AWS CLI: + +AWS CLI @@ -218,0 +230,2 @@ The following command uses the AWS CLI: + 1. The following command uses the AWS CLI: + @@ -255 +267,0 @@ The following command uses the AWS CLI: -Boto3 @@ -258 +269,0 @@ Boto3 -The following code shows uses the AWS Python SDK (Boto3): @@ -259,0 +271,4 @@ The following code shows uses the AWS Python SDK (Boto3): +Boto3 + + + 1. The following code shows uses the AWS Python SDK (Boto3): @@ -307 +325 @@ Interactive -In the AgentCore CLI interactive terminal UI, run `agentcore`, select **add** , choose **Gateway Target** , and then select **API Gateway REST API** : + 1. In the AgentCore CLI interactive terminal UI, run `agentcore` , select **add** , choose **Gateway Target** , and then select **API Gateway REST API** : @@ -317 +338 @@ Select one of the following methods: -AgentCore CLI +###### Example @@ -318,0 +340 @@ AgentCore CLI +AgentCore CLI @@ -320 +341,0 @@ AgentCore CLI -To add an OpenAPI schema target, run `agentcore add gateway-target` with the `--type open-api-schema` option and provide the path to your OpenAPI specification file: @@ -321,0 +343 @@ To add an OpenAPI schema target, run `agentcore add gateway-target` with the `-- + 1. To add an OpenAPI schema target, run `agentcore add gateway-target` with the `--type open-api-schema` option and provide the path to your OpenAPI specification file: @@ -331 +352,0 @@ To add an OpenAPI schema target, run `agentcore add gateway-target` with the `-- -Boto3 @@ -334 +354,0 @@ Boto3 -The following Python code shows how to add an OpenAPI target using the AWS Python SDK (Boto3). The schema has been uploaded to an S3 location whose URI is referenced in the `target_payload`. Outbound authorization for the target is through an API key. @@ -335,0 +356,4 @@ The following Python code shows how to add an OpenAPI target using the AWS Pytho +Boto3 + + + 1. The following Python code shows how to add an OpenAPI target using the AWS Python SDK (Boto3). The schema has been uploaded to an S3 location whose URI is referenced in the `target_payload` . Outbound authorization for the target is through an API key. @@ -373 +400 @@ Interactive -In the AgentCore CLI interactive terminal UI, run `agentcore`, select **add** , choose **Gateway Target** , and then select **OpenAPI Schema** : + 1. In the AgentCore CLI interactive terminal UI, run `agentcore` , select **add** , choose **Gateway Target** , and then select **OpenAPI Schema** : @@ -383 +413 @@ Select one of the following methods: -AgentCore CLI +###### Example @@ -384,0 +415 @@ AgentCore CLI +AgentCore CLI @@ -386 +416,0 @@ AgentCore CLI -To add a Smithy model target, run `agentcore add gateway-target` with the `--type smithy-model` option and provide the path to your Smithy model file: @@ -387,0 +418 @@ To add a Smithy model target, run `agentcore add gateway-target` with the `--typ + 1. To add a Smithy model target, run `agentcore add gateway-target` with the `--type smithy-model` option and provide the path to your Smithy model file: @@ -396 +426,0 @@ To add a Smithy model target, run `agentcore add gateway-target` with the `--typ -Boto3 @@ -399 +428,0 @@ Boto3 -The following Python code shows how to add a Smithy model target using the AWS Python SDK (Boto3): @@ -400,0 +430,4 @@ The following Python code shows how to add a Smithy model target using the AWS P +Boto3 + + + 1. The following Python code shows how to add a Smithy model target using the AWS Python SDK (Boto3): @@ -431 +467 @@ Interactive -In the AgentCore CLI interactive terminal UI, run `agentcore`, select **add** , choose **Gateway Target** , and then select **Smithy Model** : + 1. In the AgentCore CLI interactive terminal UI, run `agentcore` , select **add** , choose **Gateway Target** , and then select **Smithy Model** : @@ -443 +482 @@ You can add an MCP server target using the AgentCore CLI or AWS Python SDK (Boto -The following example creates an MCP server target with IAM authorization. The gateway signs requests to the MCP server using SigV4 with the gateway service role's credentials. You must specify the `service` name for signing. The `region` is optional and defaults to the gateway's Region. +The following example creates an MCP server target with IAM authorization. The gateway signs requests to the MCP server using SigV4 with the gateway service role’s credentials. You must specify the `service` name for signing. The `region` is optional and defaults to the gateway’s Region. @@ -458 +497 @@ Select one of the following methods: -AWS CLI +###### Example @@ -459,0 +499 @@ AWS CLI +AWS CLI @@ -462 +502 @@ AWS CLI - aws bedrock-agentcore-control create-gateway-target \ + 1. aws bedrock-agentcore-control create-gateway-target \ @@ -485 +528 @@ Interactive -In the AgentCore CLI interactive terminal UI, run `agentcore`, select **add** , choose **Gateway Target** , and then select **MCP Server endpoint** : + 1. In the AgentCore CLI interactive terminal UI, run `agentcore` , select **add** , choose **Gateway Target** , and then select **MCP Server endpoint** : @@ -491 +533,0 @@ The wizard then prompts you for the target name, MCP server endpoint URL, and ou -Boto3 @@ -495 +537,4 @@ Boto3 - import boto3 +Boto3 + + + 1. import boto3 @@ -528 +576 @@ Select one of the following methods: -AWS CLI +###### Example @@ -529,0 +578 @@ AWS CLI +AWS CLI @@ -532 +581 @@ AWS CLI - aws bedrock-agentcore-control create-gateway-target \ + 1. aws bedrock-agentcore-control create-gateway-target \ @@ -552 +600,0 @@ AWS CLI -AgentCore CLI @@ -555 +602,0 @@ AgentCore CLI -To add an MCP server target with OAuth authorization, run `agentcore add gateway-target` with the `--type mcp-server` option and specify the OAuth credentials: @@ -556,0 +604,4 @@ To add an MCP server target with OAuth authorization, run `agentcore add gateway +AgentCore CLI + + + 1. To add an MCP server target with OAuth authorization, run `agentcore add gateway-target` with the `--type mcp-server` option and specify the OAuth credentials: @@ -569 +619,0 @@ To add an MCP server target with OAuth authorization, run `agentcore add gateway -Boto3 @@ -573 +623,4 @@ Boto3 - import boto3 +Boto3 + + + 1. import boto3