View a markdown version of this page

Configure dependências e credenciais para criar, manter e usar recursos de gateway - Base da Amazônia AgentCore

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 saber como configurar ferramentas e credenciais para realizar esses processos:

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 neste serviço.

Você pode interagir com o serviço Amazon Bedrock AgentCore Control Plane das seguintes maneiras. 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 recursos de destino de gateway e gateway por meio de uma interface gráfica interativa em um navegador da Web.

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 — Nenhuma é necessária.

  • Autenticação — Você pode usar o cabeçalho de autorização ou os parâmetros de consulta (usando a versão 4 do AWS Signature) para autenticar.

AWS Os SDKs permitem que você faça solicitações de API para 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 para o link que corresponde à sua linguagem de programação preferida.

  • Autenticação — Para saber mais sobre como configurar SDKs e autenticação, consulte os links nas seções relevantes deste guia para você: coluna.

  • 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 específicos da API.

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.

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 Usando o IAM Identity Center para autenticar AWS SDK e 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 AgentCore CLI.

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 — Nenhuma é necessária.

  • Autenticação — Você pode usar o cabeçalho de autorização ou os parâmetros de consulta (usando a versão 4 do AWS Signature) para autenticar.

Para interagir com um AgentCore gateway usando um cliente MCP, você precisa instalar o cliente MCP seguindo as etapas principais Configurando seu ambiente e Configurando sua API em Criar um cliente MCP depois de escolher a linguagem de programação de sua escolha. Ao seguir as etapas, você também recuperará uma chave da API Anthropic para autenticação.

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 e configurar as credenciais.

Para interagir com um AgentCore gateway usando um agente Langgraph, você precisa instalar o Langgraph navegando até LangGraph, selecionando Documentos e escolhendo a LangGraph página que corresponde à sua linguagem de programação preferida. Ao seguir essas etapas, você também receberá uma chave de API para ajudar a configurar suas credenciais.