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
**Topics**
+ [Visão geral do](#agentcore-overview)
+ [Integração com o Bedrock AgentCore Gateway](#bedrock-agentcore-integration)
## 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](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html).
## 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](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html).
+ 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:
+ [Crie um gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building.html)
+ [Anexar um destino](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html)
+ [Testar o gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-testing.html)
**Para habilitar a integração do Gateway**
1. Faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management).
1. Abra a página de [Agentes de IA e ferramentas](https://aws.amazon.com/marketplace/management/products/aiagents).
1. Na guia **Agentes de IA e produtos de ferramentas**, selecione o produto a ser modificado.
1. Na lista suspensa **Solicitar alterações**, selecione **Atualizar opções de preenchimento**.
1. Escolha **Habilitar ferramenta para AgentCore integração com o Amazon Bedrock**.
1. 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.
1. 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**.