Michael JohnsonCloudflare는 2026년 10월 2일 AI 에이전트와 애플리케이션을 위한 웹 검색 인터페이스인 Web Search API를 공개했습니다. 출시 시점에는 Ceramic.ai, Exa, Linkup을 연결했습니다. 10월 8일에 확인한 공식 개요 문서는 10월 2일에 업데이트되었으며, 제품을 오픈 베타로 안내합니다.
개발자에게 가장 중요한 변화는 기존 모델 작업 흐름에 검색을 추가할 수 있다는 점입니다. AI Gateway 통합 설명에 따르면 검색 요청에도 모델 요청과 동일한 로그, 분석, 결제 및 접근 제어 기능이 적용됩니다. 따라서 검색을 에이전트 작업 실행 과정에서 별도로 관찰할 수 있는 단계로 다룰 수 있습니다.
에이전트에게 검색이 필요한 이유
Cloudflare의 발표는 실질적인 문제를 제시합니다. 에이전트가 필요한 페이지의 주소를 추측했다가 잘못된 URL을 요청해 404 오류를 받을 수 있습니다. 검색 도구를 사용하면 다른 방식으로 작업할 수 있습니다. 검색어를 작성하고 관련 자료의 주소를 받은 뒤, 찾은 정보를 답변 작성에 활용하는 것입니다.
두 번째 사용 사례는 모델 학습 이후의 변화를 다루는 것입니다. Cloudflare는 최신 사건, 변경되는 API, 새로 출시되는 도구를 별도로 언급합니다. 코드 작성을 돕는 에이전트라면 특정 라이브러리 버전의 문서나 최근 추가된 매개변수를 찾는 것이 유용할 수 있습니다. 이 과정에서 검색은 문맥에 필요한 자료를 제공하고, 어떤 결과를 모델에 전달할지는 애플리케이션이 결정합니다.
실무적으로는 검색 결과에서 찾은 발췌문과 함께 URL 및 검색어를 저장하세요. 그러면 답변을 검토할 때 에이전트가 어떤 자료에 의존했는지 확인할 수 있습니다. 버전이 중요한 작업에서는 검색어에 제품명과 필요한 버전도 명시하는 것이 좋습니다.
새 API 연결 방법
문서에는 두 가지 호출 방식이 설명되어 있습니다. 외부 백엔드에서 사용하는 REST API와 Cloudflare Workers 내부의 AI 바인딩입니다. 제공업체는 provider 매개변수로 선택합니다. 세 서비스 모두 제목, URL, 설명을 포함하는 공통 형식으로 결과를 반환합니다. 따라서 애플리케이션에서 응답을 처리하는 방식을 바꾸지 않고도 제공업체를 변경하기 쉽습니다.
통합 형식은 자체 검색 도구 어댑터를 만들 때 유용합니다. 어댑터는 에이전트의 검색 요청을 받아 선택한 제공업체를 호출하고, 선별한 결과를 모델에 전달합니다. 애플리케이션 차원에서는 검색 결과에 포함된 설명만으로 충분한 경우와, 찾은 페이지를 열어 특정 주장을 확인해야 하는 경우를 구분해 두는 것이 좋습니다.
출시 관련 게시물은 AI Gateway의 내장 서버 도구를 향후 제공할 기능으로 설명합니다. Cloudflare는 웹 검색이 이러한 도구 중 최초로 제공되는 기능 중 하나가 될 것이라고 밝혔습니다. 출시 시점에 제시된 사용 사례는 자체 오케스트레이션을 전제로 합니다. 즉 도구 호출을 처리하고 검색 응답을 모델에 보내는 다음 요청에 전달해야 합니다.
확인된 조건
문서의 결제 조건에 따르면 공개된 제공업체 API 가격에 따라 AI Gateway 크레딧으로 요청 비용을 결제할 수 있으며, Cloudflare의 추가 수수료는 없습니다. 자체 API 키를 사용하는 Bring Your Own Key 방식도 지원합니다. 이 방식을 선택하는 팀은 사용량을 어디서 추적하고 청구 내역을 어떻게 대조할지 미리 정해야 합니다.
확인한 발표 자료와 개요 페이지에는 구체적인 금액이나 요청 수 기준의 정량적 한도가 없습니다. 따라서 통합 예산은 선택한 제공업체의 요금을 확인한 뒤 산정해야 합니다. 자체 작업을 중심으로 적절한 출처의 비율, 응답 시간, 완료된 작업당 검색 요청 수, 오류 처리 등을 기준으로 인수 테스트를 구성하면 좋습니다.
데이터 보존도 별도로 확인해야 합니다. Zero Data Retention 설명에서 Cloudflare는 ZDR을 지원하는 파트너를 표시하겠다고 밝혔습니다. 특정 검색 경로에서 제공업체가 적용하는 보존 조건과 AI Gateway 로그 설정은 별도로 확인해야 합니다. 발표 자료는 검색 요청이 관측 시스템에 기록된다는 점도 함께 명시하고 있습니다.
또한 제공업체는 Cloudflare의 Verified bots 요건을 준수해야 합니다. 여기에는 봇 식별, robots.txt 및 크롤링 지침 준수, 합리적인 요청 빈도 유지, 사이트 소유자의 선호 존중이 포함됩니다. Web Search API 개요 문서는 모든 검색 결과에 출처 링크를 포함해야 한다고 확인합니다.
개발자는 이번 출시를 통해 에이전트에 웹 검색을 연결하고 사용량을 통합 관리할 수 있는 명확한 방법을 얻었습니다. 실제 작업을 소규모로 시험하고, 제공업체를 명시적으로 선택하며, 답변에 링크를 보존하는 것부터 시작하는 것이 좋습니다. 찾은 자료가 애플리케이션의 구체적인 작업 수행에 얼마나 도움이 될지는 바로 이런 결정에 달려 있습니다.