API جست‌وجوی وب Cloudflare در بتا روی AI Gateway عرضه شد

API جست‌وجوی وب Cloudflare (Web Search API) روز ۱۰ مهر ۱۴۰۵ (۲ اکتبر ۲۰۲۶) در نسخه بتا عرضه شد؛ سرویسی که یک پرس‌وجو می‌گیرد و فهرستی از نتایج تازه وب برمی‌گرداند تا ایجنت‌ها و اپلیکیشن‌ها پاسخشان را به اطلاعات زنده وصل کنند، نه به تاریخ قطع آموزش مدل. سرویس روی AI Gateway ساخته شده و سه ارائه‌دهنده جست‌وجو را پشت یک قالب پاسخ یکسان می‌گذارد.

مسئله‌ای که API جست‌وجوی وب Cloudflare حل می‌کند

مستندات Cloudflare مسئله را بی‌تعارف تعریف می‌کند: ایجنتی که به اطلاعات زنده نیاز دارد، بدون ابزار جست‌وجو معمولاً آدرس یک صفحه را حدس می‌زند و مستقیم آن را واکشی می‌کند؛ وقتی حدس غلط باشد پاسخ 404 Not Found است و ایجنت باید دوباره تلاش کند. این همان حلقه‌ای است که هر کسی یک ایجنت هوش مصنوعی نوشته باشد دیده است.

نکته معماری اما جای دیگری است: Cloudflare می‌نویسد Web Search API روی AI Gateway ساخته شده و گیت‌وی نقش کنترل‌پلین اپلیکیشن هوش مصنوعی را دارد. نتیجه عملی این است که درخواست‌های جست‌وجو کنار درخواست‌های استنتاج مدل در لاگ و تحلیل گیت‌وی ظاهر می‌شوند، از همان موجودی اعتبار کم می‌شوند، و همان کنترل دسترسی را می‌گیرند — یعنی می‌توانید تعیین کنید گیت‌وی از کدام ارائه‌دهنده‌ها استفاده کند و چه کسی اجازه ارسال درخواست دارد.

سه ارائه‌دهنده، یک قالب پاسخ و اختلاف ۲۸ برابری قیمت

قیمت‌ها به نوشته همین صفحه، قیمت لیست خود ارائه‌دهنده در زمان عرضه است و Cloudflare می‌گوید حاشیه سودی روی آن نمی‌گذارد. اگر از قبل حساب فعالی دارید، می‌توانید کلید خودتان را روی گیت‌وی بگذارید و با پارامتر اختیاری byokAlias صدایش بزنید؛ در آن حالت ارائه‌دهنده مستقیماً از شما صورت‌حساب می‌گیرد. یک رفتار را هم بدانید: اگر آن کلید روی گیت‌وی تنظیم نشده باشد، درخواست خطا می‌دهد و بی‌صدا به اعتبار AI Gateway برنمی‌گردد.

یک نکته درباره ستون آخر: صفحه ارائه‌دهنده‌های مستندات برای Exa گزینه Zero Data Retention را ثبت نکرده، اما پست چنج‌لاگ عرضه می‌نویسد هر سه ارائه‌دهنده برای درخواست‌هایی که از مسیر Cloudflare می‌آیند Zero Data Retention دارند. این دو جمله با هم نمی‌خوانند و Cloudflare تا لحظه نوشتن این خبر توضیحی برای اختلاف نداده است؛ اگر معیار تصمیم شما همین سطر است، به جدول تکیه کنید و موضوع را با خود ارائه‌دهنده راستی‌آزمایی کنید.

خروجی هر سه ارائه‌دهنده در یک قالب یکسان نرمال‌سازی شده است: هر نتیجه url و title دارد و در صورت وجود، description، تصویر، فاوآیکون (favicon) و تاریخ آخرین تغییر. پاسخ یک آرایه items و یک شیء metadata با query، requestId و latencyMs است.

فراخوانی Web Search API از Worker یا REST

برای Workers کافی است در فایل Wrangler بلوک [ai] با binding = "AI" را داشته باشید و متد websearch را صدا بزنید:

export default {
  async fetch(request, env): Promise<Response> {
    const response = await env.AI.websearch({
      gatewayId: "default",
      query: "cloudflare workers release notes",
      provider: "ceramic",
      limit: 5,
    });
    const results = await response.json();
    return Response.json(results);
  },
} satisfies ExportedHandler<Env>;

بیرون از Workers، یک درخواست POST به https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/websearch/ بفرستید؛ توکن API باید دو دسترسی خواندن داشته باشد: Workers AI و AI Gateway. شناسه گیت‌وی در هر دو مسیر لازم است، اما جایش فرق می‌کند: در REST داخل شیء options و به‌شکل options.gateway.id می‌آید و در بایندینگ Workers یک پارامتر سطح‌اول اجباری به نام gatewayId است.

پارامترها کم و روشن‌اند: query اجباری و بین ۱ تا ۱۰۲۴ کاراکتر، provider با پیش‌فرض ceramic، و limit با پیش‌فرض ۱۰ و بازه مجاز ۱ تا ۱۰. همین سقف ۱۰ نتیجه، محدودیتی است که در طراحی بازیابی باید جدی بگیرید.

چرا این خبر برای سازنده‌های ایجنت و RAG مهم است

این بخش خوانش تحریریه DevNA است، نه بخشی از اعلام Cloudflare.

لایه «ابزار جست‌وجو» در پشته ایجنت و بازیابی تقویت‌شده با تولید (RAG) دارد به زیرساخت تبدیل می‌شود. تا دیروز انتخاب ارائه‌دهنده جست‌وجو یعنی یک قرارداد تازه، یک کلید تازه و یک قالب پاسخ تازه؛ اینجا یعنی عوض کردن یک رشته در بدنه درخواست و دیدن نتیجه در همان داشبوردی که هزینه مدل‌ها را می‌بینید. همین الگو را Cloudflare در K2 هم پیش گرفته بود: تبدیل یک سرویس زیرساختی آشنا به یک بایندینگ Workers.

دو عدد، تصمیم را می‌سازند. اول اختلاف قیمت: Exa دقیقاً ۲۸ برابر Ceramic.ai است، و در حجم یک ایجنت تولیدی که برای هر پاسخ چند جست‌وجو می‌زند، این فاصله در صورت‌حساب ماهانه دیده می‌شود. دوم Zero Data Retention: اگر متن پرس‌وجو را عیناً از کاربر می‌گیرید، سطر Exa در جدول مستندات یک ریسک انطباق است، نه یک جزئیات فنی — و تا وقتی تناقض بالا حل نشده، این ریسک را حل‌شده فرض نکنید. سرویس فعلاً در بتا است و در هیچ‌یک از این چهار سند تاریخی برای عرضه عمومی اعلام نشده است.