AWS, 맞춤형 에이전트와 데이터 파이프라인을 위한 직접 웹 검색 API 출시

Amazon Web Services는 2026년 11월 11일 독립형 웹 검색 API를 발표하고 Amazon Bedrock AgentCore에서 제공한다고 밝혔습니다. 애플리케이션은 게이트웨이를 별도로 만들지 않고 서명된 요청 한 번으로 순위가 매겨진 웹 검색 결과를 가져올 수 있습니다. AWS는 검색 1,000건당 7달러를 청구하며, 이 API는 맞춤형 에이전트, 데이터 파이프라인 및 기존 애플리케이션을 위해 설계됐습니다.

이번 출시 전에는 AgentCore의 웹 검색 기능이 AgentCore Gateway를 통해 제공됐습니다. 이 방식에는 게이트웨이, 웹 검색 대상, Model Context Protocol (MCP) 클라이언트가 필요했습니다. 새 InvokeWebSearch 기능은 별도의 API 키나 시크릿 없이 표준 AWS Identity and Access Management (IAM) 자격 증명과 Signature Version 4 인증을 사용해 AWS SDK 또는 AWS CLI를 통해 작동합니다. 결과에는 텍스트 발췌문과, 제공되는 경우 페이지 제목, URL, 게시 시간이 포함됩니다.

맞춤형 오케스트레이션을 위한 직접 검색

이 API는 LangChain이나 LlamaIndex와 같은 프레임워크를 사용하는 맞춤형 에이전트 루프뿐 아니라 대시보드, 팩트체크 파이프라인, 콘텐츠 보강 및 모니터링 시스템 등 에이전트가 아닌 워크로드에도 적합합니다. 또한 개발자는 재시도, 캐싱 및 오류 처리를 게이트웨이에 맡기지 않고 직접 관리할 수 있습니다.

이 서비스는 Amazon이 운영하는 웹 색인을 검색합니다. AWS에 따르면 검색어는 타사 검색 엔진으로 전송되지 않고 AWS 내부에서 처리되며, 이 기능은 Alexa+, Kiro, Quick 및 기타 Amazon 제품과 동일한 검색 인프라를 사용합니다.

검색어는 최대 200자까지 입력할 수 있으며, 호출자는 결과를 1~25개 요청해 최대 25개까지 받을 수 있고, 지정하지 않으면 maxResults 생략됩니다. 도메인 포함 목록과 제외 목록에는 각각 최대 100개 항목을 지정할 수 있으며, 루트 도메인을 지정하면 하위 도메인도 일치 항목으로 처리됩니다. 게시 날짜 필터에는 RFC 3339 형식의 UTC 타임스탬프를 사용하며, 두 publishedAfter 및 publishedBefore 기준값은 모두 범위에 포함됩니다.

Python에서 호출하려면 Boto3 1.43.127 이상이 필요합니다. langchain-aws 1.9.3과 AgentCore Python SDK 1.26.0에도 지원 기능이 포함돼 있습니다. AgentCore 콘솔에서는 결과 수, 날짜 및 도메인 설정을 지정해 검색어를 테스트하고, 결과 메타데이터와 호출 지연 시간을 확인한 뒤, 통합 코드 조각을 생성하거나 게이트웨이 대상을 만들 수 있습니다.

자격 증명 및 프라이빗 네트워크 제어

호출자에게는 bedrock-agentcore:InvokeWebSearch AWS 관리형 웹 검색 도구에 대한 권한이 필요합니다. 이는 게이트웨이의 서비스 역할에 사용되는 것과 동일한 작업 및 리소스입니다. 서비스 제어 정책을 계정 전반에 적용해 보호 장치를 마련할 수 있으므로, 조직은 다른 AWS 권한과 함께 직접 검색 기능도 관리할 수 있습니다.

프라이빗 서브넷의 워크로드에서는 AWS PrivateLink를 사용해 가상 프라이빗 클라우드(VPC)의 인터페이스 엔드포인트를 통해 호출을 라우팅할 수 있습니다. 이 방식은 인터넷 게이트웨이, NAT 게이트웨이 또는 프록시 없이 AWS 네트워크 안에서 트래픽을 유지합니다. 엔드포인트 정책, 보안 그룹, 서브넷 배치 및 aws:SourceVpce IAM 조건을 사용하면 검색을 호출할 수 있는 보안 주체와 네트워크 경로를 제한할 수 있습니다.

CloudTrail은 InvokeWebSearch 요청을 데이터 이벤트로 기록하지만, 기본적으로는 로깅하지 않습니다. 트레일 또는 이벤트 데이터 스토어에 AWS::BedrockAgentCore::WebSearch 리소스 유형에 대한 이벤트 선택기를 설정해야 합니다. 생성되는 이벤트에는 웹 검색 도구와 maxResults검색 텍스트나 필터가 아니라 해당 도구가 기록됩니다. 적용되는 허용 사용 약관에 따라 고객은 결과와 함께 제공된 출처 인용 및 링크를 보존하고 표시해야 합니다.

가용성 및 게이트웨이의 경계

이 API에는 게이트웨이 커넥터와 동일한 사용량 유형이 적용되지만, 직접 호출 경로에는 게이트웨이 요금이 부과되지 않습니다. 기본 할당량은 각 리전에서 계정당 초당 10건의 요청이며, 고객은 할당량 증가를 요청할 수 있습니다. 출시 시점에는 미국 동부(버지니아 북부), 미국 동부(오하이오), 미국 서부(오리건), 유럽(아일랜드), 아시아 태평양(도쿄) 및 아시아 태평양(시드니)에서 이용할 수 있습니다.

AWS는 대부분의 에이전트 기반 워크로드에 AgentCore Gateway를 계속 권장합니다. 특히 MCP 호환 도구를 하나의 엔드포인트 뒤에 통합하거나, 선택적 MCP 세션을 사용하거나, 팀 전체에 관리자가 제어하는 단일 소스 정책을 적용하는 배포에 적합합니다. 두 경로 모두 같은 색인을 검색하지만, 게이트웨이는 JSON 웹 토큰으로 호출자를 인증할 수 있는 반면 독립형 API는 IAM만 사용합니다. 게이트웨이 관리자는 호출 에이전트에게 공개되지 않는 대상 수준의 도메인 목록을 적용할 수 있지만, 직접 API 요청은 각 요청에 자체 필터를 포함합니다.

이번 출시로 애플리케이션은 MCP나 게이트웨이 스택을 도입하지 않고도 Amazon의 웹 색인에 접근할 수 있습니다. 두 방식의 차이는 운영 제어에 있습니다. 직접 호출 방식에서는 요청 처리와 필터링을 호출자가 직접 관리하며, 여러 에이전트가 공유하는 환경에서는 게이트웨이가 도구, 인증 및 소스 정책을 중앙에서 제어합니다.