Amazon Bedrock AgentCore Web Search API 정식 출시: InvokeWebSearch는 1,000건당 7달러, 기본 계정·리전당 초당 최대 10건, 여섯 개 리전이며 GovCloud(미국 서부)는 제외, 출처 인용을 보존하고 표시해야 하며 공지와 가이드에는 인덱스 규모·최신성·결과 품질 데이터가 없음

2026년 11월 10일 AWS는 Amazon Bedrock AgentCore의 Web Search API가 정식 출시(GA)됐다고 발표했습니다. 공지에 따르면 API 호출 한 번으로 웹을 검색할 수 있습니다. AgentCore의 Web Search는 이미 AgentCore Gateway를 통한 모델 컨텍스트 프로토콜(MCP) 도구로 제공되고 있었습니다. 새 InvokeWebSearch API는 서비스를 직접 호출하는 코드, 즉 애플리케이션, 자체 에이전트 루프, 데이터 파이프라인을 위한 것이며 미리 만들어야 할 리소스가 없습니다. 이 기사는 AWS 공지와 웹 검색에 관한 AgentCore 개발자 가이드 페이지를 근거로 합니다. API를 시험하지 않았고, 결과 품질·최신성·지연에 대한 측정은 두 출처 어디에도 없습니다.

API는 공지가 "AgentCore의 Web Search 뒤에 있는 Amazon이 운영하는 웹 인덱스"라고 부르는 곳에서 순위가 매겨진 결과 목록을 돌려줍니다. 각 결과에는 페이지의 텍스트 발췌가 있고, 가능한 경우 페이지 제목, URL, 게시 시각도 있습니다. "가능한 경우"라는 말이 중요합니다. 결과가 제목이나 날짜 없이 올 수 있으므로 이 필드에 의존하는 코드에는 대체 경로가 필요합니다. 요청마다 도메인과 게시 시각으로 필터링할 수 있습니다. 공지는 두 가지 용도를 듭니다. 최근 제품 발표를 찾는 것, 그리고 신뢰할 수 있는 도메인에 비추어 주장을 확인하는 것입니다. 가이드도 같은 말을 하며 연구 질문을 위한 출처를 모으는 용도를 더합니다.

호출 방식은 AWS 사용자에게 익숙합니다. AWS SDK 또는 AWS 명령줄 인터페이스를 쓰고, AWS Identity and Access Management(IAM)로 호출을 인가합니다. 가이드에 따르면 API는 호출자를 IAM으로만 인가하고, 게이트웨이는 JSON Web Token(JWT)으로도 인가할 수 있습니다. 가상 프라이빗 클라우드에서 AWS PrivateLink를 통해 API를 호출할 수 있고, 요청을 AWS CloudTrail 데이터 이벤트로 기록할 수 있습니다. 보안팀이 가장 먼저 물을 통제 항목입니다. 서비스가 쿼리 텍스트에 대해 무엇을 기록하거나 보관하는지는 출처에 없으며, 이 기사도 가정하지 않습니다.

가격과 할당량은 명시돼 있습니다. 쿼리는 1,000건당 7달러, 즉 쿼리당 0.007달러로 청구됩니다. 공지는 이것이 AgentCore Gateway를 통한 Web Search와 같은 요율이며 API에는 게이트웨이 요금이 없다고 말합니다. 기본적으로 계정은 리전마다 초당 최대 10건의 InvokeWebSearch 요청을 보낼 수 있고, AWS Support를 통해 상향을 요청할 수 있습니다. 결과가 0건인 요청이 과금되는지는 출처에 없습니다. 많은 검색을 병렬로 쏟아내는 시스템은 계산을 해 보아야 합니다. 검색 1,000건이 모두 공시 요율로 과금되면 비용은 7달러이고, 기본 할당량은 AWS Support로 늘리지 않는 한 한 계정이 한 리전에서 초당 보낼 수 있는 요청 수를 제한합니다. 몰린 요청이 끝나기까지 걸리는 시간은 출처에 없습니다.

서비스는 여섯 개 리전에서 이용할 수 있습니다. 미국 동부(버지니아 북부), 미국 동부(오하이오), 미국 서부(오리건), 아시아 태평양(시드니), 아시아 태평양(도쿄), 유럽(아일랜드)입니다. 가이드는 AWS GovCloud(미국 서부)에서는 이용할 수 없다고 말합니다. 그곳에서는 같은 리전에서 제공되는 Web Search Tool 커넥터를 써야 합니다. 트래픽을 특정 리전 안에 두어야 하는 팀은 이 목록을 먼저 확인해야 합니다. 출처가 인덱스를 어디에서 호스팅하는지, 쿼리를 어디에서 처리하는지 설명하지 않기 때문입니다.

가이드는 API와 게이트웨이 커넥터를 차이점 목록으로 비교합니다. API는 AgentCore 데이터 플레인 엔드포인트에서 호출하고, 에이전트는 게이트웨이를 통해 커넥터를 MCP 도구로 호출합니다. API는 검색 텍스트를 searchQuery라는 필드로, MCP 도구는 query라는 필드로 받습니다. maxResults를 설정하지 않으면 API는 최대 25개, MCP 도구는 최대 10개를 돌려줍니다. 게시 시각 범위는 API에서는 publishedAfter와 publishedBefore, MCP 도구에서는 from과 to로 제한합니다. 둘 다 양쪽 경계를 포함으로 취급합니다. 하루 어긋나는 오류를 만들 수 있는 세부 사항이 있습니다. 날짜에 시각이 없을 때 MCP 도구의 "to" 날짜는 그날 전체를 포함하지만, AWS SDK와 AWS CLI는 publishedBefore 날짜를 그날이 시작되는 협정 세계시(UTC) 자정으로 보냅니다. 그래서 API에서 publishedBefore를 날짜만으로 설정하면 그날이 시작되는 지점에서 잘리고, 그날 늦게 게시된 글은 범위 밖이 됩니다. 이는 가이드 규칙에 대한 해석이며 가이드가 제시한 예는 아닙니다. 또 API는 요청마다 도메인 필터를 받지만, 커넥터는 호출하는 에이전트에게 보이지 않게 모든 요청에 대상 수준의 도메인 목록을 적용할 수도 있습니다.

허용 가능한 사용 약관도 다시 읽을 만합니다. 가이드는 Web Search Tool의 약관이 InvokeWebSearch API의 결과에도 적용되며, 각 결과에 딸린 출처 인용과 링크를 보존하고 표시해야 하는 요건이 포함된다고 말합니다. 사용자에게 검색 결과를 보여 주는 제품이나, 결과를 모델에 주고 답을 보여 주는 제품에게 이것은 각주가 아니라 설계 요건입니다. 가이드는 전체 약관을 별도의 허용 가능한 사용 페이지로 안내하는데, 이 기사에서는 그 페이지를 수집하지 않았습니다.

출처가 입증하지 않은 내용은 입증한 내용만큼 중요합니다. 인덱스가 얼마나 크고 최신인지, 어떤 언어를 다루는지, 결과 순위를 어떻게 매기는지, 품질이나 비용에서 다른 검색 서비스와 어떻게 비교되는지는 나와 있지 않습니다. 공지는 이 API를 여섯 개 리전에서 정식 출시했다고 말합니다. 기본 할당량은 개발자 가이드가 정하며, 계정·리전당 초당 최대 10건입니다. 에이전트에 쓰려는 팀은 자기 쿼리로 결과 품질을 시험하고, 날짜 필터는 UTC 자정 규칙을 염두에 두고 설정하며, 인용 요건에 맞춰 설계하고, 1,000건당 7달러 요율로 비용을 추정해야 합니다.