View a markdown version of this page

Use um AgentCore 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á.

Use um AgentCore gateway

Depois de configurar seu gateway com destinos, você pode configurar seu aplicativo ou agente para usar o gateway por meio do Model Context Protocol (MCP). O MCP fornece uma forma padronizada para os agentes descobrirem e invocarem ferramentas.

nota

AgentCore O Gateway oferece suporte às seguintes versões do MCP: 2026-07-28, 2025-11-25, 2025-06-18 e 2025-03-26.

A versão 2026-07-28 é uma revisão de protocolo sem estado. Os clientes não realizam um aperto de initialize mão. Cada solicitação carrega sua versão do protocolo no MCP-Protocol-Version cabeçalho e no _meta campo (io.modelcontextprotocol/protocolVersion). O gateway descobre recursos por meio server/discover de. A versão 2025-11-25 e as anteriores continuam usando o aperto de initialize mão.

Você pode usar as seguintes operações de MCP com um AgentCore gateway:

Operation Description

tools/call

Invoca uma ferramenta específica com os argumentos fornecidos

tools/list

Lista todas as ferramentas disponíveis fornecidas pelo gateway

prompts/list

Lista todas as solicitações disponíveis fornecidas pelo gateway

prompts/get

Recupera um modelo de prompt específico, renderizado com os argumentos fornecidos

resources/list

Lista todos os recursos disponíveis fornecidos pelo gateway

resources/read

Lê o conteúdo de um recurso específico por URI

resources/templates/lista

Lista todos os modelos de recursos disponíveis fornecidos pelo gateway

elicitation/create

Solicita informações adicionais do cliente durante uma chamada de ferramenta (iniciada pelo servidor)

sampling/createMessage

Solicita a conclusão do LLM do cliente durante uma chamada de ferramenta (iniciada pelo servidor)

notifications/progress

Relata o progresso em chamadas de ferramentas de longa duração (iniciadas pelo servidor)

notifications/message

Envia mensagens de log do servidor durante a execução da ferramenta (iniciada pelo servidor)

Na versão2026-07-28, as interações iniciadas pelo servidor (elicitation/createesampling/createMessage) usam o padrão de várias solicitações de ida e volta (MRTR):

  1. O servidor retorna um resultado provisório com resultType definido como. input_required

  2. O cliente fornece a entrada solicitada em uma nova tentativa da solicitação original.

O gateway fornece notificações (notifications/progressenotifications/message) somente para solicitações que as aceitam. Na versão anterior 2025-11-25 e na versão anterior, o gateway fornece essas interações como mensagens iniciadas pelo servidor no fluxo aberto.

Os tópicos a seguir descrevem como invocar seu AgentCore gateway: