Set up dependencies and credentials to create, maintain, and use gateway resources
The AgentCore Gateway service involves the following main processes:
-
Creation and maintenance of gateway resources – You can create gateway and gateway target resources through the Amazon Bedrock AgentCore Control Plane service.
-
Invocation of gateways – After creating a gateway and gateway target, you can invoke the gateway through direct HTTP requests to the gateway or through the help of an MCP client or agent.
Select a topic to learn about setting up tools and credentials for carrying out these processes:
Topics
Set up tools and credentials for the creation and maintenance of gateway resources
You create, modify, delete, and retrieve information about gateway and gateway target resources through making calls to the Amazon Bedrock AgentCore Control Plane service. The Amazon Bedrock AgentCore Control Plane service API reference details information about the API operations and structures in this service.
You can interact with the Amazon Bedrock AgentCore Control Plane service in the following ways. Expand a topic to learn how to install the tool and set up authentication for it.
The AWS Management Console lets you create and maintain gateway and gateway target resources through an interactive graphical interface in a web browser.
-
Installation – None needed. To manage gateways through the AgentCore console, you can navigate to https://console.aws.amazon.com/bedrock-agentcore/home#
and select Gateways from the left navigation pane. -
Authentication – Sign in with an IAM identity with permissions to use AgentCore Gateway actions.
The Amazon Bedrock AgentCore Control Plane service API reference page for each API operations provides the information you need to make an API request.
-
Installation – None needed.
-
Authentication – You can use the Authorization header or query parameters (using AWS Signature Version 4) to authenticate.
AWS SDKs let you make API requests to AWS services through a programming language of your choice. Refer to the following resources in the AWS SDKs and Tools Reference Guide to get set up:
-
Installation – To learn about an SDK and how to install it, select the AWS SDK for link that corresponds to your programming language of choice.
-
Authentication – To learn about configuring SDKs and authentication, refer to the links in the This guide's relevant sections for you are: column.
-
Other resources – In the language-specific reference, search for the Amazon Bedrock AgentCore Core Control service to see the syntax of specific API methods.
The AWS Command Line Interface (CLI) lets you interact with the AWS API in a command line interface. To learn how to install and set up the AWS CLI, see Getting started with the AWS CLI in the AWS Command Line Interface User Guide.
-
Installation – To learn how to install the AWS CLI see Installing or updating to the latest version of the AWS CLI.
-
Authentication – To learn about configuring your credentials in the AWS CLI see Setting up the AWS CLI.
-
Other resources – To see the syntax of specific API methods in the Amazon Bedrock AgentCore control plane service, see the bedrock-agentcore-control reference.
The AgentCore starter toolkit is a Python SDK that provides tools to help you easily interact with the AgentCore API. Refer to the following resources in the AgentCore starter toolkit repository.
-
Installation – To learn how to install the starter toolkit, follow the steps at Installation.
-
Authentication – To access your AWS credentials and configure them for the AgentCore starter toolkit, follow the steps at Using IAM Identity Center to authenticate AWS SDK and Tools.
-
Other resources – You use the Gateway client in this toolkit to interact with AgentCore Gateway. For more information, see AgentCore Gateway client.
Invocation of gateways
After you create a gateway and gateway targets, you can interact with the gateway through direct HTTP requests or through an MCP client or agent.
To make an HTTP request to an AgentCore gateway, you make a POST request to a gateway endpoint that you set up when creating a gateway.
-
Installation – None needed.
-
Authentication – You can use the Authorization header or query parameters (using AWS Signature Version 4) to authenticate.
To interact with an AgentCore gateway using an MCP client, you need to install the MCP client by following the Setting up your environment and Setting up your API key steps at Build an MCP client
To interact with an AgentCore gateway using the Strands Agents SDK, you need to install the Strands SDK by following the steps at Strands Agents SDK
To interact with an AgentCore gateway using a Langgraph agent, you need to install Langgraph by navigating to LangGraph