TL;DR

  • Cloudflare Web Search API는 단일 API 호출로 AI 에이전트와 애플리케이션이 실시간 인터넷 정보를 검색하고 응답 근거로 활용하게 하는 오픈 베타 서비스임.
  • 검색 결과는 모델에 전달할 수 있는 제목·URL·설명의 구조화된 형식이며, 학습 데이터의 기준 시점이나 URL 추측에 의존하지 않음.
  • AI Gateway를 통해 검색 요청에도 모델 추론과 동일한 로깅·분석·결제·접근 제어가 적용됨.
  • Ceramic.ai, Exa, Linkup 중 검색 제공자를 선택할 수 있고, 통합된 결과 형식으로 제공자 변경 시 코드 수정이 필요하지 않음.
  • AI Gateway 크레딧으로 제공자별 정가에 검색 비용을 지불할 수 있으며, 자체 제공자 API 키 사용과 요청 관측, 책임 있는 크롤링도 지원됨.

Web Search API

  • AI 에이전트와 애플리케이션이 인터넷을 검색하고 최신 정보에 기반해 응답할 수 있게 하는 API임.
  • 에이전트가 검색어를 전송하면 제목·URL·설명으로 구성된 구조화된 결과를 받으며, 이를 모델 컨텍스트에 바로 전달할 수 있음.
  • URL을 추측하거나 모델의 학습 데이터 기준 시점에 의존하는 대신 실시간 검색 결과를 활용하는 방식임.
  • 오픈 베타로 제공됨.
  • AI Gateway를 통해 실행되므로 검색 요청에도 모델 추론 요청과 같은 로깅·분석·결제·접근 제어가 적용됨.
  • REST API를 사용해 모든 백엔드에서 호출하거나, AI 바인딩을 사용해 Worker에서 호출할 수 있음.

검색 제공자 사용 방법

  • provider 매개변수 하나로 Ceramic.ai, Exa, Linkup 중 검색 제공자를 선택할 수 있음.
  • 모든 제공자가 같은 형식으로 결과를 반환하므로 코드를 바꾸지 않고 제공자를 전환할 수 있음.

기능

  • 통합 결제(Unified Billing): 추가 마크업 없이 제공자별 API 정가로 AI Gateway 크레딧을 사용해 검색 비용을 지불할 수 있음.
  • 자체 제공자 API 키를 사용할 수도 있음.
  • 관측 가능성(Observability): 검색 요청이 모델 추론 요청과 함께 AI Gateway 로그와 분석에 표시됨.
  • 책임 있는 크롤링(Responsible crawling): 모든 제공자가 Cloudflare의 검증된 봇 요건을 준수하며 각 검색 결과의 출처 링크를 반환함.

관련 제품

  • AI Gateway: 분석, 캐싱, 속도 제한, 모델 대체 기능으로 AI 애플리케이션을 관측하고 제어하는 서비스임.
  • Workers AI: 서버리스 GPU 기반 머신러닝 모델을 Cloudflare 글로벌 네트워크에서 실행하는 서비스임.
  • Agents: 작업 수행, 상태 유지, 웹 검색, 실시간 통신이 가능한 AI 에이전트를 구축하는 도구임.

추가 자료

  • Developer Discord: Workers 커뮤니티에서 질문하고, 개발 중인 내용을 공유하며, 다른 개발자와 플랫폼을 논의하는 공간임.
  • 사용 사례: Cloudflare 글로벌 네트워크에서 AI 애플리케이션을 구축하고 배포하는 방법을 안내함.
  • @CloudflareDev: 제품 발표와 Cloudflare Workers의 최신 소식을 확인할 수 있는 계정임.