新增 API Gateway REST API 做為 Amazon Bedrock AgentCore Gateway 的目標 - Amazon API Gateway
考量事項新增 API 階段做為 AgentCore Gateway 的目標

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

新增 API Gateway REST API 做為 Amazon Bedrock AgentCore Gateway 的目標

Amazon Bedrock AgentCore Gateway 為 AI 代理程式開發人員提供了一種安全的方式，將您的 API Gateway REST APIs 公開為模型內容協定 (MCP) 相容工具。AgentCore Gateway 使用目標來定義工具。當您將階段新增為目標時，閘道會成為單一 MCP URL，讓 能夠存取代理程式的工具。如需詳細資訊，請參閱《Amazon Bedrock AgentCore Gateway 開發人員指南》中的 API Gateway REST API 階段作為目標。

API Gateway 目標會將 AgentCore Gateway 連線至 REST APIs的階段。您可以包含整個階段做為目標，或選取資源。建立 API Gateway 目標之後，AgentCore Gateway 會將傳入的 MCP 請求轉譯為 HTTP 請求，並處理回應格式。MCP 用戶端可以使用 tools/list方法擷取 API 文件，並使用 tools/call方法叫用 APIs。

考量事項

下列考量事項可能會影響您使用將階段新增為 AgentCore Gateway 的目標：

  • 您必須已經有 AgentCore Gateway。

  • 僅支援公有 REST APIs。

  • 無法停用 API 的預設端點。

  • API 的每個方法都必須有為其定義的操作名稱，或者當您將階段新增為目標時，需要建立名稱覆寫。此名稱用作代理程式用來與您的 方法互動的工具名稱。

  • 您可以使用傳出身分驗證的 NO_AUTH、 API_KEY或 GATEWAY_IAM_ROLE登入資料提供者類型，以允許閘道存取您的 API。API_KEY 登入資料提供者由 AgentCore Gateway 定義。您可以使用現有的 API Gateway API 金鑰。如需詳細資訊，請參閱設定傳出身分驗證。

  • 如果您使用 Amazon Cognito 使用者集區或 Lambda 授權方來控制對 API 的存取，則 MCP 用戶端無法存取它。

  • 您的 API 必須與 AgentCore Gateway 位於相同的帳戶和區域。

新增 API 階段做為 AgentCore Gateway 的目標

下列程序說明如何將 API 的階段新增為 AgentCore Gateway 的目標。

新增 API 階段做為 AgentCore Gateway 的目標

  1. 在以下網址登入 API Gateway 主控台：https://console.aws.amazon.com/apigateway。

  2. 選擇部署到階段的 REST API。

  3. 在主導覽窗格中，選擇階段。

  4. 選擇階段動作，然後選擇建立 MCP 目標。

  5. 針對 AgentCore Gateway，選取 AgentCore Gateway。

  6. 針對目標名稱，輸入目標名稱。

  7. 針對目標描述，輸入描述。

  8. 保留提供的 API 和階段。

  9. 針對選取 API 資源，選取使用 AgentCore Gateway 的代理程式可存取的 API 資源。

    如果您未選取資源，則客服人員無法檢視文件或叫用端點。

  10. 資源和 方法的組合是工具的操作。如果您的操作沒有名稱，請建立名稱覆寫。

    您也可以在建立方法時定義方法的操作名稱。

  11. 針對傳出身分驗證組態，選擇 IAM 角色 、無授權或 API 金鑰。

  12. 選擇建立目標。

若要檢視可存取 API 的所有 AgentCore Gateway，請選擇主導覽窗格中的 MCP 目標區段。 APIs 在本節中，您可以為部署到階段的區域中的任何 API 建立 MCP 目標。選擇建立 MCP 目標，然後遵循先前的步驟。

您也可以在 AgentCore Gateway 主控台中檢視目標的可用工具，並編輯目標。如需詳細資訊，請參閱將目標新增至現有的 AgentCore Gateway。