Adicionar uma API REST do API Gateway como destino para o Amazon Bedrock AgentCore Gateway.
O Amazon Bedrock AgentCore Gateway oferece aos desenvolvedores de agentes de IA uma maneira segura de expor as APIs REST do API Gateway como ferramentas compatíveis com o protocolo de contexto para modelos (MCP). O AgentCore Gateway usa destinos para definir ferramentas. Quando você adiciona seu estágio como um destino, o gateway se torna um único URL do MCP que permite acesso às ferramentas de um agente. Para ter mais informações, consulte Estágios da API REST do API Gateway como destinos no Guia do desenvolvedor do Amazon Bedrock AgentCore Gateway.
Os destinos do API Gateway conectam o AgentCore Gateway aos estágios de suas APIs REST. É possível incluir o estágio inteiro como destino ou selecionar recursos. Depois de criar o destino do API Gateway, o AgentCore Gateway converte as solicitações do MCP recebidas em solicitações HTTP e processa a formatação da resposta. Os clientes MCP podem recuperar a documentação da API usando o método tools/list e invocar APIs usando o método tools/call.
Considerações
As considerações a seguir podem impactar seu uso ao adicionar um estágio como destino a um AgentCore Gateway:
-
Você já deve ter criado um AgentCore Gateway.
-
Somente as APIs REST públicas são compatíveis.
-
Não é possível desabilitar o endpoint padrão para a API.
-
Cada método da API deve ter um nome de operação definido para ele ou será necessário criar uma substituição de nome ao adicionar seu estágio como destino. Esse nome é usado como o nome da ferramenta que os agentes usam para interagir com seu método.
-
Você pode usar os tipos de provedor de credenciais
API_KEY,NO_AUTH, ouGATEWAY_IAM_ROLEcomo autenticação de saída para permitir que o gateway acesse a API. O provedor de credenciaisAPI_KEYé definido pelo AgentCore Gateway. Você pode usar sua chave de API existente do API Gateway. Para ter mais informações, consulte Configurar autenticação de saída. -
Se você usa um grupo de usuários do Amazon Cognito ou um autorizador do Lambda para controlar o acesso à API, os clientes MCP não poderão acessá-la.
-
A API deve estar na mesma conta e região do AgentCore Gateway.
Adicionar um estágio de uma API como destino para um AgentCore Gateway
O procedimento a seguir mostra como adicionar um estágio de uma API como um destino para um AgentCore Gateway.
Como adicionar um estágio de uma API como destino para um AgentCore Gateway
Faça login no console do API Gateway em https://console.aws.amazon.com/apigateway
. Escolha uma API REST que esteja implantada em um estágio.
No painel de navegação principal, selecione Estágios.
-
Escolha Ações de estágio e Criar destino do MCP.
Em AgentCore Gateway, selecione um AgentCore Gateway.
Em Nome do destino, insira um nome para o destino.
Em Descrição do destino, insira uma descrição.
Mantenha a API e o estágio fornecidos.
-
Em Selecione os recursos da API, escolha os recursos da API que os agentes que usam o AgentCore Gateway podem acessar.
Se você não selecionar um recurso, o agente não poderá visualizar a documentação nem invocar o endpoint.
-
A combinação do recurso e do método são as operações da ferramenta. Se a operação não tiver um nome, crie um nome de substituição.
Você também pode definir um nome de operação para um método ao criá-lo.
Em Configuração de autenticação de saída, escolha Perfil do IAM, Sem autorização ou Chave de API.
Escolha Criar destino.
Para visualizar todos os AgentCore Gateways que têm acesso às suas APIs, escolha a seção Destinos do MCP no painel de navegação principal. Nessa seção, é possível criar um destino do MCP para qualquer API em sua região implantada em um estágio. Escolha Criar destino do MCP e siga as etapas anteriores.
Também é possível visualizar as ferramentas disponíveis para seu destino e editar o destino no console do AgentCore Gateway. Para ter mais informações, consulte Adicionar destinos a um AgentCore Gateway existente.
