

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

# 设置依赖关系和证书以创建、维护和使用网关资源
<a name="gateway-setup-tools-credentials"></a>

 AgentCore 网关服务涉及以下主要流程：
+  **创建和维护网关资源 ** — 您可以通过 Amazon Bedrock AgentCore 控制平面服务创建网关和网关目标资源。
+  **调用网关 **-创建网关和网关目标后，您可以通过向网关发出的直接 HTTP 请求或通过 MCP 客户端或代理的帮助来调用网关。

选择一个主题来了解如何设置用于执行这些流程的工具和证书：

**Topics**
+ [设置用于创建和维护网关资源的工具和证书](#gateway-setup-control-plane)
+ [调用网关](#gateway-setup-data-plane)

## 设置用于创建和维护网关资源的工具和证书
<a name="gateway-setup-control-plane"></a>

您可以通过调用 Amazon Bedrock AgentCore 控制平面服务来创建、修改、删除和检索有关网关和网关目标资源的信息。[亚马逊基岩 AgentCore 控制平面服务 API 参考](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/Welcome.html)详细说明了有关该服务中的 API 操作和结构的信息。

您可以通过以下方式与亚马逊基岩 AgentCore 控制平面服务进行交互。展开主题以了解如何安装该工具并为其设置身份验证。

### Amazon 管理控制台
<a name="gateway-prerequisites-console"></a>

 Amazon 管理控制台允许您通过 Web 浏览器中的交互式图形界面创建和维护网关和网关目标资源。
+  **安装 **-不需要。要通过 AgentCore 控制台管理网关，您可以导航到 [ https://console.aws.amazon.com/bedrock-agentcore/home \# ](https://console.amazonaws.cn/bedrock-agentcore/home#) 并**从左侧导航窗格中选择**网关。
+  **身份验证 **-使用具有 AgentCore 网关操作权限的 IAM 身份登录。

### 直接 HTTP 请求
<a name="gateway-prerequisites-cp-http"></a>

每个 API 操作的[亚马逊基岩 AgentCore 控制平面服务 API 参考](https://docs.amazonaws.cn/bedrock-agentcore-control/latest/APIReference/Welcome.html)页面提供了提出 API 请求所需的信息。
+  **安装 **-不需要。
+  **身份验证 **-您可以使用[授权标头](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)或查询参数（使用[Amazon 签名版本 4](https://docs.amazonaws.cn/AmazonS3/latest/API/sigv4-query-string-auth.html)）进行身份验证。

### Amazon 软件开发套件 SDK
<a name="gateway-prerequisites-aws-sdk"></a>

 Amazon SDK 允许您通过自己选择的编程语言向 Amazon 服务提出 API 请求。请参阅《软件开发工具包和[Amazon 工具参考指南》中的以下资源](https://docs.amazonaws.cn/sdkref/latest/guide/overview.html)进行设置：
+  **安装 ** — 要了解 SDK 及其安装方法，请选择与您选择的编程语言对应的 ** Amazon SDK ** 链接。
+  **身份验证 ** — 要了解如何配置 SDK 和身份验证，请参阅**本指南相关章节中的 you are: ** 栏中的链接。
+  **其他资源 ** — 在特定语言的参考资料中，搜索亚马逊基岩 AgentCore 核心控制服务以查看特定 API 方法的语法。

### Amazon 命令行界面
<a name="gateway-prerequisites-aws-cli"></a>

 Amazon 命令行接口 (CLI) 允许您在命令行界面中与 Amazon API 进行交互。要了解如何安装和设置 Amazon CLI，请参阅《[Amazon 命令行界面用户指南》[中的 Amazon CLI ](https://docs.amazonaws.cn/cli/latest/userguide/cli-chap-getting-started.html) 入门](https://docs.amazonaws.cn/cli/latest/userguide/)。
+  **安装 **-要了解如何安装 Amazon CLI，请参阅[安装或更新到最新版本的 Amazon CLI ](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-install.html)。
+  **身份验证 **-要了解如何在 Amazon CLI 中配置您的证书，请参阅[设置 Amazon CLI ](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-quickstart.html)。
+  **其他资源 ** — 要查看亚马逊基岩 AgentCore 控制平面服务中特定 API 方法的语法，请参阅基[岩代理核心控制参考文档。](https://docs.amazonaws.cn/cli/latest/reference/bedrock-agentcore-control/)

### AgentCore CLI
<a name="gateway-prerequisites-agentcore-cli"></a>

C AgentCore LI 是用于与 API 交互的 Node.js 命令行工具。 AgentCore 请参阅 [ AgentCore CLI 存储库中的以下资源](https://github.com/aws/agentcore-cli)。
+  **安装 **-要安装 AgentCore CLI，请运行以下命令：

  ```
  npm install -g @aws/agentcore
  ```
+  **身份验证 **-要访问您的 Amazon 证书并针对 AgentCore CLI 进行配置，请按照[使用 IAM 身份中心对 Amazon SDK 和工具进行身份验证中的步骤进行操作](https://docs.amazonaws.cn/sdkref/latest/guide/access-sso.html)。
+  **其他资源 **-有关使用 AgentCore CLI 与 AgentCore 网关交互的更多信息，请参阅 [ AgentCore CLI 存储库](https://github.com/aws/agentcore-cli)。

## 调用网关
<a name="gateway-setup-data-plane"></a>

创建网关和网关目标后，您可以通过直接 HTTP 请求或 MCP 客户端或代理与网关进行交互。

### 直接 HTTP 请求
<a name="gateway-prerequisites-dp-http"></a>

要向 AgentCore 网关发出 HTTP 请求，您需要向在创建网关时设置的网关终端节点发出 POST 请求。
+  **安装 **-不需要。
+  **身份验证 **-您可以使用[授权标头](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)或查询参数（使用[Amazon 签名版本 4](https://docs.amazonaws.cn/AmazonS3/latest/API/sigv4-query-string-auth.html)）进行身份验证。

### MCP 客户端
<a name="gateway-prerequisites-mcp-client"></a>

要使用 MCP 客户端与 AgentCore 网关进行交互，您需要在选择所选编程语言[后，按照](https://modelcontextprotocol.io/docs/develop/build-client)构建 MCP 客户端中的**设置环境**和设置 API 密钥**步骤安装 MCP 客户端。**通过执行这些步骤，您还将检索用于身份验证的 Anthropic API 密钥。

### Strands 代理软件开发工具包
<a name="gateway-prerequisites-strands-sdk"></a>

要使用Strands Agents SDK与 AgentCore 网关进行交互，您需要按照Strands Agents SDK中的步骤安装 [ Strands SDK ](https://strandsagents.com/latest/documentation/docs/) 来安装该软件开发工具包并设置证书。

### Langraph 代理商
<a name="gateway-prerequisites-langgraph-agent"></a>

要使用 Langgraph 代理与 AgentCore 网关进行交互，你需要安装 Langgraph，方法是导航到[LangGraph](https://www.langchain.com/langgraph)、选择**文档**，然后选择与你选择的编程语言相对应的**LangGraph**页面。通过执行这些步骤，您还将收到一个 API 密钥，以帮助设置您的证书。