View a markdown version of this page

AgentCore 게이트웨이 사용 - Amazon Bedrock AgentCore

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AgentCore 게이트웨이 사용

대상 로 게이트웨이를 설정한 후 모델 컨텍스트 프로토콜(MCP)을 통해 게이트웨이를 사용하도록 애플리케이션 또는 에이전트를 구성할 수 있습니다. MCP는 에이전트가 도구를 검색하고 호출할 수 있는 표준화된 방법을 제공합니다.

참고

AgentCore Gateway는 2026-07-28, , 2025-11-25 2025-06-18및 2025-03-26 MCP 버전을 지원합니다.

버전2026-07-28은 상태 비저장 프로토콜 개정입니다. 클라이언트는 initialize 핸드셰이크를 수행하지 않습니다. 각 요청은 MCP-Protocol-Version 헤더와 _meta 필드()에 프로토콜 버전을 포함합니다io.modelcontextprotocol/protocolVersion. 게이트웨이는를 통해 기능을 검색합니다server/discover. 버전 2025-11-25 이하에서는 initialize 핸드셰이크를 계속 사용합니다.

AgentCore 게이트웨이에서 다음 MCP 작업을 사용할 수 있습니다.

연산 설명

도구/통화

제공된 인수를 사용하여 특정 도구를 호출합니다.

도구/목록

게이트웨이에서 제공하는 사용 가능한 모든 도구를 나열합니다.

프롬프트/목록

게이트웨이에서 제공하는 사용 가능한 모든 프롬프트를 나열합니다.

프롬프트/get

제공된 인수로 렌더링된 특정 프롬프트 템플릿을 검색합니다.

리소스/목록

게이트웨이에서 제공하는 사용 가능한 모든 리소스를 나열합니다.

리소스/읽기

URI로 특정 리소스의 내용을 읽습니다.

resources/templates/list

게이트웨이에서 제공하는 사용 가능한 모든 리소스 템플릿을 나열합니다.

유도/생성

도구 호출 중에 클라이언트에 추가 입력을 요청합니다(서버 시작).

샘플링/createMessage

도구 호출 중에 클라이언트에 LLM 완료를 요청합니다(서버 시작).

알림/진행

장기 실행 도구 호출(서버 시작)에 대한 진행 상황 보고

알림/메시지

도구 실행 중에 서버에서 로그 메시지를 전송합니다(서버 시작).

버전에서 2026-07-28서버 시작 상호 작용(elicitation/create 및 sampling/createMessage)은 다중 왕복 요청(MRTR) 패턴을 사용합니다.

  1. 서버는가 로 resultType 설정된 중간 결과를 반환합니다input_required.

  2. 클라이언트는 원래 요청의 재시도 시 요청된 입력을 제공합니다.

게이트웨이는 알림을 옵트인하는 요청에 대해서만 알림(notifications/progress 및 notifications/message)을 전송합니다. 버전 2025-11-25 이하에서는 게이트웨이가 이러한 상호 작용을 오픈 스트림에서 서버 시작 메시지로 전달합니다.

다음 주제에서는 AgentCore 게이트웨이를 호출하는 방법을 설명합니다.