Cloudflare Developers لبناء تطبيقات الويب والذكاء الاصطناعي

يجمع Cloudflare Developers وثائق منتجات Cloudflare ومراجع API والأمثلة العملية. يساعد المطورين على اختيار خدمات تشغيل الشيفرة واستدعاء نماذج الذكاء الاصطناعي وحفظ البيانات وحماية التطبيقات، ثم فهم خطوات الربط وحدود الاستخدام.

ببساطة، ما فائدة هذا الموقع؟

يمكن اعتباره دليل استخدام لمجموعة قطع تبني بها خدمة سحابية. عندما تريد نشر واجهة API أو حفظ ملفات أو إضافة إجابات ذكية إلى تطبيقك، تجد المنتج المناسب وكيفية ربطه بالشيفرة. قراءة الوثائق لا تنشئ الموارد تلقائيًا؛ تُنفّذ العمليات عبر حساب Cloudflare أو لوحة التحكم أو سطر الأوامر أو API.

الموقع مناسب للمطورين والمؤسسين التقنيين وفرق التشغيل. يمكن للمبتدئ البدء بمثال صغير، لكن إطلاق خدمة فعلية يتطلب برمجة وصلاحيات واختبارات ومتابعة للتكاليف.

تشغيل النموذج وإدارة الطلبات وبناء الوكيل

تُشغّل Workers AI النماذج على بنية GPU لدى Cloudflare. يمكن استدعاؤها من Worker أو من خادم خارجي عبر REST. تختلف المدخلات والمخرجات بحسب النموذج والمهمة، مثل توليد النصوص أو التضمينات المتجهية أو معالجة الصور.

تدير AI Gateway الطلبات المرسلة إلى مزودي النماذج المدعومين. تتيح التحليلات والسجلات والتخزين المؤقت وحدود المعدل وإعادة المحاولة والتحويل إلى نموذج بديل، للمساعدة في فهم الاستهلاك والأخطاء.

توفر Agents حالة مستمرة واتصالات فورية ومهام مجدولة وأدوات مثل MCP لتطبيقات الوكلاء. يظل تحديد سلوك الوكيل وصلاحياته والتحقق من نتائجه مسؤولية المطور.

نشر Worker أول ثم تجربة طلب إلى نموذج

يتطلب دليل البدء الرسمي عبر CLI حساب Cloudflare وبيئة Node.js مدعومة.

1. نفّذ npm create cloudflare@latest -- my-first-worker واختر مثال Worker بسيطًا.
2. انتقل إلى مجلد المشروع وشغّل npx wrangler dev، ثم افتح العنوان المحلي الظاهر في الطرفية.
3. عدّل نص الاستجابة في الملف، واحفظه وأعد تحميل الصفحة للتحقق من التغيير.
4. نفّذ npx wrangler deploy وأكمل التفويض المطلوب، ثم اختبر عنوان workers.dev الناتج.

لتجربة النموذج وحده، اتبع دليل REST الخاص بـ Workers AI: احصل على Account ID ورمز API، وأرسل الطلب الموثّق للنموذج، وافحص استجابة JSON وحقول الأخطاء. احتفظ بالرمز في الخادم. قد تُحتسب طلبات الاستدلال أثناء التطوير المحلي ضمن حدود الخدمة أيضًا.

ما المجاني وما الذي قد يُحاسب عليه؟

الوثائق متاحة للعامة، بينما لكل منتج سحابي تسعيره. وفق أسعار Workers AI التي جرى التحقق منها في 7 أكتوبر 2026، توجد حصة يومية مجانية قدرها 10,000 Neurons تُجدّد عند 00:00 UTC. تجاوزها يتطلب Workers Paid، وبعض النماذج تتطلب وسيلة فوترة مدفوعة.

التحليلات الأساسية والتخزين المؤقت وتحديد المعدل في Gateway مجانية، لكن الاستدلال والسجلات وميزات أخرى قد تولّد رسومًا. تميّز قواعد تسعير Gateway السجلات بحسب تاريخ إنشاء أول بوابة. الأسعار الرسمية بالدولار لا تمثل سعرًا شاملًا لكل المنتجات بالريال السعودي مع الضرائب.

اختيار مكان الملفات والسجلات والمتجهات

تخزن R2 الملفات والكائنات، وتستخدم D1 للبيانات العلائقية عبر SQL، وتخزن KV أزواج المفاتيح والقيم. تنسق Durable Objects الحالة، بينما تحفظ Vectorize التضمينات وتبحث عن العناصر المتشابهة.

يمكن لمساعد مستندات استخدام R2 للأصول وD1 لسجلات التطبيق وVectorize لمتجهات البحث. لكنه ما زال يحتاج إلى تنفيذ إدخال البيانات والتحكم في الوصول والتحقق من الإجابات. يساعد دليل اختيار التخزين على مطابقة كل خدمة مع وظيفتها.

مراجعة السجلات وتراخيص النماذج

توضح سياسة بيانات Workers AI أن محتوى العميل لا يُستخدم لتدريب النماذج أو تحسين الخدمات دون موافقة صريحة. قد تحفظ خدمات التخزين المرتبطة المحتوى، وللمزودين الخارجيين شروطهم الخاصة.

تكون سجلات AI Gateway مفعّلة افتراضيًا وقد تتضمن المدخلات والاستجابات. راجع إعدادات الجمع قبل معالجة بيانات حساسة، وتحقق من ترخيص النموذج قبل الاستخدام التجاري؛ الوصول إلى API ليس ترخيصًا عامًا لكل الأغراض.

حماية الموقع وتشغيله بعد النشر

يشمل الموقع أدلة DNS والتخزين المؤقت وTLS وWAF وTurnstile. يمكن تضمين Turnstile دون تمرير حركة الموقع كلها عبر Cloudflare. نشر Worker لا يضبط هذه الخدمات تلقائيًا؛ اختر ما تحتاج إليه وأكمل إعداداته.

أسئلة شائعة

هل تعني الحصة المجانية طلبات غير محدودة؟

لا. يتغير الاستهلاك بحسب النموذج وحجم المدخلات والمخرجات، مع وجود حدود للمعدل وشروط دفع لبعض النماذج.

هل أستطيع استخدام خادمي الحالي لاستدعاء AI؟

نعم. استخدم REST مع Account ID ورمز ذي صلاحيات مناسبة وصيغة الطلب المطلوبة للنموذج، دون نقل التطبيق كله إلى Workers.

هل تشمل Gateway المجانية تكلفة النماذج؟

مجانية ميزات الإدارة الأساسية لا تجعل الاستدلال مجانيًا. افحص المزود وطريقة الفوترة وتكلفة السجلات كلًا على حدة.

موارد رسمية ومجتمع المطورين

• مرجع API: نقاط الاتصال والمصادقة.
• Discord للمطورين: مناقشة أسئلة التنفيذ.
• Cloudflare على GitHub: المشاريع الرسمية.
• CloudflareDev: إعلانات المطورين.
• الدعم وحالة الخدمات: المساعدة ومتابعة الأعطال.