View a markdown version of this page

AgentCore Gateway를 통해 지식 기반에 연결 - Amazon Bedrock
Strands 에이전트를 사용하여 호출

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

AgentCore Gateway를 통해 지식 기반에 연결

AgentCore Gateway를 사용하면 모델 컨텍스트 프로토콜(MCP)을 사용하여 Amazon Bedrock 관리형 지식 기반을 도구로 노출할 수 있습니다. 게이트웨이에 지식 기반 대상을 추가한 후 모든 MCP 호환 클라이언트는 지식 기반을 표준 MCP 도구로 쿼리할 수 있습니다. 커넥터는 다음 두 가지 도구를 노출합니다.

  • AgenticRetrieveStream - 결과를 계획하고 반복적으로 검색하며 스트리밍하는 다단계 스트리밍 에이전트 검색과 선택적으로 합성된 인용 기반 답변입니다.

  • Retrieve - 소스 참조와 가장 관련성이 높은 구절을 반환하는 단일 검색입니다.

게이트웨이는 인증, 파라미터 삽입 및 스키마 하위 설정을 처리하는 중개자 역할을 합니다. 관리자는 지식 기반을 바인딩하고 호출 에이전트에 노출되는 파라미터와 미리 구성된 기본값으로 숨겨지는 파라미터를 제어합니다.

참고

지식 기반 게이트웨이 대상은 관리형 지식 기반 및 IAM 기반 아웃바운드 인증(자GATEWAY_IAM_ROLE격 증명 공급자 유형)에서만 지원됩니다.

사전 조건

  • 관리형 지식 기반 및 해당 지식 기반 ID.

  • 지식 기반(bedrock:Retrieve 지식 기반 ARN 기반)에서 검색할 수 있는 권한이 있는 AgentCore Gateway 및 게이트웨이 서비스 역할.

AWS SDK 또는 AWS CLI를 사용하여 게이트웨이 대상 생성, 게이트웨이 서비스 역할 및 신뢰 정책 구성, 에이전트가 설정할 수 있는 검색 파라미터 제어, 도구 호출, 전체 입력 및 응답 스키마 등 전체 지침은 Amazon Bedrock AgentCore 개발자 안내서의 커넥터 대상으로서 Amazon Bedrock 관리형 지식 기반을 참조하세요. AgentCore

Strands 에이전트를 사용하여 호출

Strands Agents SDK 및 AgentCore 스타터 툴킷으로 구축된 기존 에이전트가 있는 경우 게이트웨이 엔드포인트에 대해 SigV4 인증을 사용하도록 MCP 클라이언트를 전환하여 지식 기반 게이트웨이 대상에 연결할 수 있습니다.

mcp-proxy-for-aws 패키지를 설치합니다.

pip install mcp-proxy-for-aws

그런 다음 IAM 인증을 사용하여 게이트웨이 URL을 가리키도록 MCP 클라이언트를 업데이트합니다.

from mcp_proxy_for_aws.client import aws_iam_streamablehttp_client
from strands.tools.mcp.mcp_client import MCPClient

GATEWAY_URL = "https://your-gateway-url/mcp"

def get_streamable_http_mcp_client() -> MCPClient:
    """Returns an MCP Client with SigV4 auth for AgentCore Gateway."""
    return MCPClient(lambda: aws_iam_streamablehttp_client(
        endpoint=GATEWAY_URL,
        aws_region="us-west-2",
        aws_service="bedrock-agentcore",
    ))

표준 MCP 클라이언트 설정에서 변경된 키는 다음과 같습니다.

  • mcp 패키지streamablehttp_client에서를의 로 바꿉aws_iam_streamablehttp_client니다mcp-proxy-for-aws.

  • 를 AgentCore 게이트웨이 URLendpoint로 설정합니다.

  • SigV4 서명aws_service="bedrock-agentcore"에를 지정합니다.

연결되면 지식 기반 도구가를 통해 자동 검색되고 추가 구성 없이 에이전트가 tools/list 사용할 수 있습니다.