Configure dependências e credenciais para criar, manter e usar recursos de gateway
O serviço AgentCore Gateway envolve os seguintes processos principais:
-
Criação e manutenção de recursos de gateway — Você pode criar recursos de gateway e de destino de gateway por meio do serviço Amazon Bedrock AgentCore Control Plane.
-
Invocação de gateways — Depois de criar um gateway e um destino de gateway, você pode invocar o gateway por meio de solicitações HTTP diretas ao gateway ou com a ajuda de um cliente ou agente MCP.
Selecione um tópico para aprender sobre a configuração de ferramentas e credenciais para realizar esses processos:
Tópicos
Configurar ferramentas e credenciais para a criação e manutenção de recursos de gateway
Você cria, modifica, exclui e recupera informações sobre o gateway e os recursos de destino do gateway fazendo chamadas para o serviço Amazon Bedrock AgentCore Control Plane. A referência da API do serviço Amazon Bedrock AgentCore Control Plane detalha informações sobre as operações e estruturas da API nesse serviço.
Você pode interagir com o serviço Amazon Bedrock AgentCore Control Plane das seguintes formas. Expanda um tópico para saber como instalar a ferramenta e configurar a autenticação para ela.
O AWS Management Console permite criar e manter o gateway e os recursos de destino do gateway por meio de uma interface gráfica interativa em um navegador da web.
-
Instalação — Não é necessária. Para gerenciar gateways por meio do AgentCore console, você pode navegar até https://console.aws.amazon.com/bedrock-agentcore/home#
e selecionar Gateways no painel de navegação esquerdo. -
Autenticação — Faça login com uma identidade do IAM com permissões para usar ações do AgentCore Gateway.
A página de referência da API do serviço Amazon Bedrock AgentCore Control Plane para cada operação de API fornece as informações de que você precisa para fazer uma solicitação de API.
-
Instalação — Não é necessária.
-
Autenticação — Você pode usar o cabeçalho de autorização ou os parâmetros de consulta (usando o AWS Signature Version 4) para autenticar.
AWS Os SDKs permitem que você faça solicitações de API aos AWS serviços por meio de uma linguagem de programação de sua escolha. Consulte os seguintes recursos no Guia de referência de AWS SDKs e ferramentas para configurar:
-
Instalação — Para saber mais sobre um SDK e como instalá-lo, selecione o AWS SDK como link que corresponda à linguagem de programação de sua escolha.
-
Autenticação — Para saber mais sobre como configurar SDKs e autenticação, consulte os links na coluna Seções relevantes deste guia para você:.
-
Outros recursos — Na referência específica do idioma, pesquise o serviço Amazon Bedrock AgentCore Core Control para ver a sintaxe de métodos de API específicos.
A interface de linha de AWS comando (CLI) permite que você interaja com a AWS API em uma interface de linha de comando. Para saber como instalar e configurar a AWS CLI, consulte Introdução à AWS CLI no Guia do usuário da interface de linha de AWS comando.
-
Instalação — Para saber como instalar a AWS CLI, consulte Instalando ou atualizando para a versão mais recente da AWS CLI.
-
Autenticação — Para saber mais sobre como configurar suas credenciais na CLI, consulte Configurando a AWS CLI. AWS
A AgentCore CLI é uma ferramenta de Node.js linha de comando para interagir com a API. AgentCore Consulte os seguintes recursos no repositório AgentCore CLI
-
Instalação — Para instalar a AgentCore CLI, execute o seguinte comando:
npm install -g @aws/agentcore -
Autenticação — Para acessar suas AWS credenciais e configurá-las para a AgentCore CLI, siga as etapas em Como usar o IAM Identity Center para AWS autenticar o SDK e as ferramentas.
-
Outros recursos — Para obter mais informações sobre como usar a AgentCore CLI para interagir com o AgentCore Gateway, consulte o repositório da CLIAgentCore .
Invocação de gateways
Depois de criar um gateway e destinos de gateway, você pode interagir com o gateway por meio de solicitações HTTP diretas ou por meio de um cliente ou agente MCP.
Para fazer uma solicitação HTTP para um AgentCore gateway, você faz uma solicitação POST para um endpoint de gateway que você configurou ao criar um gateway.
-
Instalação — Não é necessária.
-
Autenticação — Você pode usar o cabeçalho de autorização ou os parâmetros de consulta (usando o AWS Signature Version 4) para autenticar.
Para interagir com um AgentCore gateway usando um cliente MCP, você precisa instalar o cliente MCP seguindo as principais etapas de Configuração do ambiente e Configuração da API em Criar um cliente MCP
Para interagir com um AgentCore gateway usando o SDK do Strands Agents, você precisa instalar o SDK do Strands seguindo as etapas no SDK do Strands Agents para instalar o SDK
Para interagir com um AgentCore gateway usando um agente Langgraph, você precisa instalar o Langgraph navegando até LangGraph