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)
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):
-
O servidor retorna um resultado provisório com
resultTypedefinido como.input_required -
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: