View a markdown version of this page

Amazon Bedrock AgentCore Gateway - AWS Marketplace
Visão geral doIntegração com o Bedrock AgentCore Gateway

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á.

Amazon Bedrock AgentCore Gateway

Este documento fornece informações para AWS Marketplace vendedores que desejam listar produtos ou ferramentas de agentes de IA baseados em API que podem ser integrados ao Amazon Bedrock Gateway. AgentCore

Visão geral do

O Amazon Bedrock AgentCore Gateway ajuda os desenvolvedores a criar, implantar, descobrir e se conectar a ferramentas em grande escala. O serviço permite a você:

  • Converta APIs funções Lambda e serviços existentes em ferramentas compatíveis com o Model Context Protocol (MCP)

  • Disponibilizar ferramentas para atendentes por meio de endpoints do Gateway

  • Usar autenticação abrangente de entrada e saída em um serviço totalmente gerenciado

Os agentes de IA usam essas ferramentas para realizar tarefas como:

  • Consulta a bancos de dados

  • Enviar mensagens

  • Análise de documentos

Para obter mais informações, consulte o Amazon Bedrock AgentCore Developer Guide.

Integração com o Bedrock AgentCore Gateway

Você pode habilitar a integração do Amazon Bedrock AgentCore Gateway para seus produtos de agente de IA baseados na API SaaS de uma das seguintes formas, dependendo do seu produto:

  • Se você listar um servidor MCP que ofereça suporte à OAuth autenticação de duas pernas, poderá optar por oferecer aos seus compradores a integração sem requisitos adicionais. O endpoint do servidor MCP fornecido por você como parte do processo de listagem será usado na integração. No entanto, você deve garantir que o servidor MCP atenda aos requisitos listados abaixo. Para obter mais informações, consulte Destinos de servidores MCP.

  • Para todos os outros agentes ou ferramentas, você pode fornecer uma especificação OpenAPI para permitir a integração.

Requisitos do servidor MCP

O servidor MCP deve atender aos seguintes requisitos:

  • OAuth Autenticação de duas pernas com uma das seguintes configurações:

    • ID do cliente, senha do cliente e URL de descoberta

    • ID do cliente, segredo do cliente, emissor, endpoint de autorização e endpoint de token.

  • O servidor MCP deve ter recursos de ferramenta.

  • Versões do protocolo MCP compatíveis: 2025-06-18 e 2025-03-26.

  • Para o URL ou o endpoint do servidor fornecido, o URL deve ser codificado. O gateway usa a mesma URL para invocar o servidor.

Requisitos de especificação da OpenAPI

A especificação da OpenAPI deve:

  • Incluir campos operationId para todas as operações

  • Estar livre de erros semânticos

  • Incluir um URL de endpoint seguro (https) válido no atributo do servidor

A seguinte tabela mostra os atributos da OpenAPI compatíveis e incompatíveis:

Categoria Compatível Não suportado
Versão 3.0 e 3.1 2
Definições de esquema Tipos de dados básicos (string, número, booliano etc.) Especificações de oneOf
Validação do campo obrigatório Especificações de anyOf
Objetos aninhados
Matrizes com especificações de item
Métodos HTTP padrão
Tipos de mídia application/json Tipos de mídia personalizada
application/xml Tipos de mídia binária
multipart/form-data
x-www-form-urlencoded
Parâmetros Parâmetros de caminho simples e parâmetros básicos de consulta, como string/number/boolean tipos Serialização de parâmetro do caminho complexo
Matrizes de parâmetros de consulta complexa
Serialização de parâmetros de cabeçalho
Serialização de parâmetros de cookie
Solicitação e reposta Corpos JSON
Corpos XML
Códigos de status de HTTP padrão
Validação Validação de campo básico Validação de padrão Regex
Validação de valor mínimo/máximo
Segurança N/D Esquemas de segurança no nível de especificação
Vários esquemas de segurança
OAuth 2.0 no nível de especificação
Chave de API no nível de especificação
Autenticação HTTP básica em nível de especificação
Configuração do servidor URL básico
URL com espaços reservados

Habilitando o Bedrock AgentCore Gate

Antes de habilitar a integração do Gateway, teste sua especificação OpenAPI ou servidor MCP com o Amazon Bedrock AgentCore Gateway concluindo estas tarefas:

Para habilitar a integração do Gateway

  1. Faça login no Portal de gerenciamento do AWS Marketplace.

  2. Abra a página de Agentes de IA e ferramentas.

  3. Na guia Agentes de IA e produtos de ferramentas, selecione o produto a ser modificado.

  4. Na lista suspensa Solicitar alterações, selecione Atualizar opções de preenchimento.

  5. Escolha Habilitar ferramenta para AgentCore integração com o Amazon Bedrock.

  6. Faça o upload da sua especificação OpenAPI. Para produtos MCP Server OAuth habilitados para duas pernas, isso não é necessário e somente o endpoint MCP é necessário.

  7. Selecione Enviar.

Depois que você envia, o status da solicitação será exibido como Em análise na guia Solicitações. Quando o processamento é concluído, o status muda para Com êxito.