View a markdown version of this page

使用网 AgentCore 关 - 亚马逊基岩 AgentCore

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用网 AgentCore 关

使用目标设置网关后,您可以将应用程序或代理配置为通过模型上下文协议 (MCP) 使用网关。MCP 为代理发现和调用工具提供了一种标准化的方式。

注意

AgentCore Gateway 支持以下 MCP 版本:2026-07-28、2025-11-25、2025-06-18 和 2025-03-26。

版本2026-07-28是无状态协议修订版。客户不进行initialize握手。每个请求在MCP-Protocol-Version标头和_meta字段 (io.modelcontextprotocol/protocolVersion) 中都带有其协议版本。网关通过server/discover发现功能。版本2025-11-25及更早版本继续使用initialize握手。

您可以对 AgentCore 网关使用以下 MCP 操作:

操作 说明

tools/call

使用提供的参数调用特定工具

tools/list

列出网关提供的所有可用工具

prompts/list

列出网关提供的所有可用提示

prompts/get

检索使用提供的参数呈现的特定提示模板

resources/list

列出网关提供的所有可用资源

resources/read

通过 URI 读取特定资源的内容

resources/templates/清单

列出网关提供的所有可用资源模板

elicitation/create

在工具调用(服务器启动)期间请求客户端提供更多输入

sampling/createMessage

在工具调用(服务器启动)期间请求客户端完成 LLM

notifications/progress

报告长时间运行的工具调用(服务器启动)的进度

notifications/message

在工具执行期间(服务器启动)从服务器发送日志消息

在版本上2026-07-28,服务器启动的交互(elicitation/create和sampling/createMessage)使用多往返请求 (MRTR) 模式:

  1. 服务器返回一个resultType设置为的临时结果input_required。

  2. 客户端在重试原始请求时提供所请求的输入。

网关仅为选择接收通知的请求发送通知(notifications/progress和notifications/message)。在版本2025-11-25及更早版本中,网关将这些交互作为服务器发起的公开消息传输。

以下主题介绍如何调用您的 AgentCore 网关: