Web Search API

• Cloudflare가 Web Search API를 베타로 공개해, AI 에이전트와 애플리케이션이 인터넷을 검색하고 실시간 정보를 근거로 응답할 수 있게 함
• 출시 시점에는 Ceramic.ai, Exa, Linkup의 세 검색 제공업체를 선택할 수 있음
• 세 제공업체 모두 Cloudflare를 통한 요청에 데이터 무보관(Zero Data Retention) 을 지원하며, Cloudflare의 검증된 봇 크롤링 표준을 준수하기로 약속함
• 검색 요청은 AI Gateway를 거쳐 로그에 기록되며, 추가 할증 없이 각 제공업체의 API 정가로 AI Gateway 크레딧에서 과금됨
• REST API 또는 Worker의 AI 바인딩으로 호출할 수 있으며, 사용자가 보유한 검색 제공업체 API 키도 사용할 수 있음

실시간 웹 검색과 제공업체

• Web Search API가 베타로 제공됨
  • AI 에이전트와 애플리케이션이 URL을 추측하거나 모델의 학습 시점에 의존하는 대신, 인터넷을 검색해 실시간 정보를 응답의 근거로 사용할 수 있음
• 출시 시 선택 가능한 검색 제공업체는 Ceramic.ai, Exa, Linkup임
  • 세 업체 모두 Cloudflare를 통한 요청에 데이터 무보관을 지원함
  • 모두 Cloudflare의 검증된 봇 크롤링 표준을 준수하기로 약속함

AI Gateway 연동과 과금

• 검색 요청은 AI Gateway를 통해 처리되어 게이트웨이 로그에 표시됨
• 비용은 각 제공업체의 API 정가를 기준으로 AI Gateway 크레딧에서 청구되며, 추가 할증은 없음
• 사용자가 보유한 제공업체 API 키를 가져와 사용할 수도 있음

호출 방식

• REST API는 /client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/에 POST 요청을 보내 호출함
  • 예제는 Bearer 토큰 인증과 JSON 본문을 사용하며, query, provider, limit, options.gateway.id를 지정함
• Worker에서는 AI 바인딩의 env.AI.websearch()를 호출함
  • gatewayId, query, provider, limit를 전달하고, 반환된 응답을 response.json()으로 읽음
• 시작 절차는 Web Search API 사용 방법에서 확인할 수 있음