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 API를 Model Context Protocol(MCP) 호환 도구로 노출할 수 있는 안전한 방법을 제공합니다. AgentCore Gateway는 대상을 사용하여 도구를 정의합니다. 스테이지를 대상으로 추가하면 Gateway는 에이전트의 도구에 액세스할 수 있는 단일 MCP URL이 됩니다. 자세한 내용은 Amazon Bedrock AgentCore Gateway 개발자 안내서의 API Gateway REST API 스테이지를 대상으로 지정을 참조하세요.

API Gateway 대상은 AgentCore Gateway를 REST API의 스테이지에 연결합니다. 전체 스테이지를 대상으로 포함하거나 리소스를 선택할 수 있습니다. API Gateway 대상을 생성하면 AgentCore Gateway는 수신 MCP 요청을 HTTP 요청으로 변환하고 응답 형식을 처리합니다. MCP 클라이언트는 tools/list 메서드를 사용하여 API 설명서를 검색하고 tools/call 메서드를 사용하여 API를 간접적으로 호출할 수 있습니다.

고려 사항

다음 고려 사항은 AgentCore Gateway에 대상으로 스테이지를 추가하는 사용에 영향을 미칠 수 있습니다.

  • AgentCore Gateway가 이미 있어야 합니다.

  • 공개 REST API만 지원됩니다.

  • API의 기본 엔드포인트를 비활성화할 수 없습니다.

  • API의 모든 메서드에는 작업 이름이 정의되어 있거나 스테이지를 대상으로 추가할 때 이름 재정의를 생성해야 합니다. 이 이름은 에이전트가 메서드와 상호 작용하는 데 사용하는 도구 이름으로 사용됩니다.

  • 아웃바운드 인증에 API_KEY, NO_AUTH 또는 GATEWAY_IAM_ROLE 자격 증명 공급자 유형을 사용하여 Gateway가 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. https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

  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 대상 섹션을 선택합니다. 이 섹션에서는 스테이지에 배포된 리전의 모든 API에 대해 MCP 대상을 생성할 수 있습니다. MCP 대상 생성을 선택하고 이전 단계를 따릅니다.

AgentCore Gateway 콘솔에서 대상에 사용할 수 있는 도구를 보고 대상을 편집할 수도 있습니다. 자세한 내용은 기존 AgentCore Gateway에 대상 추가를 참조하세요.