Amazon Bedrock AgentCore 런타임 대상

Amazon Bedrock AgentCore 런타임 에이전트를 게이트웨이 대상으로 추가할 수 있습니다. 게이트웨이는 집계 또는 프로토콜 변환 없이 트래픽을 런타임 에이전트로 직접 전송합니다. 도구 기능을 통합 가상 MCP 서버로 결합하는 MCP 대상과 달리 AgentCore 런타임 대상은 수정 없이 클라이언트와 런타임 에이전트 간에 요청 및 응답을 전달합니다.

게이트웨이에 AgentCore 런타임 대상을 추가하면 다음과 같은 경우에 유용합니다.

주요 고려 사항 및 제한 사항

AgentCore 런타임 대상으로 작업할 때는 다음 고려 사항에 유의하세요.

대상 구성

AgentCore 런타임 대상을 생성할 때 런타임 ARN과 선택적 한정자를 제공합니다. 게이트웨이는 런타임 엔드포인트를 내부적으로 확인하므로 런타임 URL을 직접 구성할 필요가 없습니다.

AgentCore 런타임 대상의 대상 구성은 다음 구조를 사용합니다.

{
    "http": {
        "agentcoreRuntime": {
            "arn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID",
            "qualifier": "DEFAULT",
            "schema": {
                "source": {
                    "s3": {
                        "uri": "s3://DOC-EXAMPLE-BUCKET/agent-schema.yaml"
                    }
                }
            }
        }
    }
}

AgentCore 런타임 대상 호출

게이트웨이를 통해 AgentCore 런타임 대상을 호출하려면 대상의 호출 URL로 POST 요청을 보냅니다. URL 형식은 다음과 같습니다.

https://{gatewayId}.gateway.bedrock-agentcore.{region}.amazonaws.com/{targetName}/invocations

{gatewayId}를 게이트웨이 ID로,를 AWS 리전{region}으로, {targetName}를 대상 이름으로 바꿉니다.

다음 예제에서는 curl을 사용하여 AgentCore 런타임 대상을 호출합니다.

curl -X POST https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target/invocations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{"input": {"prompt": "Hello"}}'

엔드포인트 URL 재정의와 함께 Amazon Bedrock AgentCore SDK를 사용할 수도 있습니다.

aws bedrock-agentcore invoke-agent-runtime \
    --endpoint-url https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target \
    --runtimeArn arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID

아웃바운드 권한 부여

AgentCore 런타임 대상은 다음과 같은 아웃바운드 권한 부여 유형을 지원합니다.

게이트웨이를 통한 트래픽 적용

게이트웨이가 런타임에 대한 단일 관리형 진입점이 되도록 AgentCore 게이트웨이로 AgentCore 런타임을 앞당길 수 있습니다. 이를 통해 정책 기반 권한 부여, Amazon Bedrock Guardrails, 요청 및 응답 인터셉터, 통합 관찰성을 모두 에이전트의 자체 환경 외부에서 적용할 수 있습니다. 전체 근거는 AgentCore Gateway를 사용하여 런타임 전달을 참조하세요. 그러나 게이트웨이를 우회하고 런타임에 직접 액세스할 수 없는 경우에만 유용합니다. 이제 런타임에서 IAM(SigV4) 또는 OAuth(JWT) 인바운드 권한 부여를 사용하는지 여부에 관계없이 이를 달성할 수 있습니다.

런타임에 대해이 제한을 구성합니다. 게이트웨이는 전달하는 모든 요청의 소스를 스탬핑하고 런타임은 들어오는 동안 해당 소스를 검증합니다. 특정 메커니즘은 런타임의 인바운드 권한 부여 유형에 따라 달라집니다.

MCP 대상과의 기능 비교

집계 모드에서 MCP 대상 유형을 사용하거나 AgentCore 런타임 대상 유형을 사용하는 두 가지 방법을 사용하여 MCP 서버를 Amazon Bedrock AgentCore 게이트웨이와 통합할 수 있습니다. 다음 표에서는 각 접근 방식의 기능을 비교합니다.