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

# AgentCore Gateway를 통해 지식 기반에 연결
<a name="kb-gateway-target"></a>

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 관리형 지식 기반을 참조하세요](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-connector-managed-kb.html). * AgentCore *

## Strands 에이전트를 사용하여 호출
<a name="kb-gateway-target-invoke-strands"></a>

[Strands Agents SDK](https://strandsagents.com/latest/) 및 [AgentCore 스타터 툴킷](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html)으로 구축된 기존 에이전트가 있는 경우 게이트웨이 엔드포인트에 대해 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 게이트웨이 URL`endpoint`로 설정합니다.
+ SigV4 서명`aws_service="bedrock-agentcore"`에를 지정합니다.

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