Edge Functions

تنفيذ التعليمات البرمجية من جانب الخادم

Edge functions هي وظائف JavaScript/TypeScript تعمل في وقت تشغيل Deno، مما يتيح لك تنفيذ المنطق الذي لا ينبغي أو لا يمكن تشغيله في المتصفح. ينشئ الذكاء الاصطناعي هذه الوظائف عندما تصف الميزات التي تحتاج إلى معالجة من جانب الخادم، أو تكامل API خارجي، أو أمان محسّن.

ما هي Edge functions التي تتيحها:

  • معالجة النماذج مع التحقق من الصحة واستدعاءات API الخارجية
  • دمج الخدمات مثل إرسال رسائل البريد الإلكتروني أو معالجة المدفوعات أو الاتصال بواجهات برمجة تطبيقات الذكاء الاصطناعي
  • حماية المنطق الحساس الذي لا ينبغي أن يكون مرئيًا في كود المتصفح
  • الوصول إلى الأسرار بشكل آمن دون تعريضها للمستخدمين
  • تنفيذ عمليات معقدة تكون بطيئة جدًا أو كثيفة الاستخدام للموارد بالنسبة للمتصفح

كيف تعمل الوظائف

عندما ينشئ الذكاء الاصطناعي Edge function لك، فإنه:

  1. يكتب كود JavaScript لتنفيذ المهمة التي وصفتها
  2. يُعدّ التحكم في الوصول لتحديد من يمكنه الاتصال بالوظيفة
  3. يضبط الوصول إلى الأسرار إذا كانت الوظيفة تحتاج إلى بيانات اعتماد API خارجية
  4. يختبر الوظيفة للتأكد من أنها تعمل بشكل صحيح
  5. يوفر عنوان URL يمكن لتطبيقك الاتصال به لتنفيذ الوظيفة

تعمل الوظائف في بيئات معزولة وآمنة. يتم تسجيل كل عملية تنفيذ مع معلومات التوقيت وأي أخطاء والمستخدم الذي قام بتشغيلها. يمكنك عرض هذه السجلات في الإعدادات > تكوين الموقع > المراقبة > السجلات لمراقبة كيفية أداء وظائفك وتصحيح أي مشكلات.

التحكم في الوصول للوظائف

تمامًا مثل جداول قاعدة البيانات، تتمتع Edge functions بسياسات أمان تتحكم في من يمكنه تنفيذها. يقوم الذكاء الاصطناعي بإعداد هذه العناصر بناءً على ما تقوم ببنائه:

الوظائف العامة

يمكن لأي شخص الاتصال بهم، حتى بدون تسجيل الدخول. يُستخدم لمعالجات webhook (مثل إشعارات الدفع Stripe) أو واجهات برمجة التطبيقات العامة أو نقاط نهاية الفحص الصحي.

وظائف مصادق عليها

يمكن فقط للمستخدمين الذين قاموا بتسجيل الدخول الاتصال بهم. تستخدم معظم الوظائف هذه السياسة — فهي مناسبة للميزات التي تواجه المستخدم أو عمليات إرسال النماذج أو جلب البيانات لتطبيقك.

الوصول على أساس المجموعة

يمكن فقط للمستخدمين في مجموعات محددة (مثل "admin") استدعاء الوظيفة. مثالي للعمليات الإدارية أو أدوات الإشراف أو الميزات الخاصة بالفريق.

الوصول القائم على البيانات الوصفية

الوصول يعتمد على سمات المستخدم المخصصة. على سبيل المثال، يمكن فقط للمستخدمين الذين لديهم department = "engineering" الاتصال بوظائف معينة. وهذا يتيح أنظمة أذونات مرنة ومخصصة.

ما هي الوظائف التي يمكن أن تفعلها

الوصول إلى قاعدة البيانات

يمكن للوظائف الاستعلام عن قاعدة البيانات الخاصة بك وتعديلها، مع تطبيق جميع قواعد الأمان نفسها.

استدعاءات API الخارجية

يمكن للوظائف التواصل مع الخدمات الخارجية باستخدام أسرارك المخزنة.

المنطق المعقد

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

البريد الإلكتروني والإخطارات

أرسل رسائل البريد الإلكتروني الخاصة بالمعاملات أو الرسائل النصية القصيرة أو الإشعارات الفورية استجابةً لإجراءات المستخدم.

معالجة الدفع

تعامل مع تدفقات الدفع أو معالجة webhook أو إدارة الاشتراكات باستخدام خدمات مثل Stripe.

تكامل الذكاء الاصطناعي

اتصل بواجهات برمجة تطبيقات الذكاء الاصطناعي مثل OpenAI أو Anthropic لإنشاء محتوى أو تحليل البيانات أو توفير ميزات ذكية.

المراقبة والسجلات

يتم تسجيل كل تنفيذ للوظيفة تلقائيًا باستخدام:

  • متى تم استدعاؤه ومن قام به
  • كم من الوقت استغرق التنفيذ
  • سواء نجحت أو واجهت أخطاء
  • أي مخرجات من console أو رسائل خطأ
  • الاستجابة التي أعادتها

أفضل الممارسات

✅ صِف بوضوح - عندما تطلب من الذكاء الاصطناعي إنشاء وظيفة، كن محددًا بشأن ما يجب أن يفعله ومن يجب أن يكون قادرًا على استدعائها.

✅ راقب السجلات - تحقق من سجلات تنفيذ الوظيفة لفهم الأداء ورصد الأخطاء مبكرًا.

✅ احتفظ بالأسرار في مدير الأسرار - سيستخدم الذكاء الاصطناعي الأسرار المخزنة بدلاً من ترميزها في الوظائف.

❌ لا تكشف عن العمليات الحساسة - اسمح للذكاء الاصطناعي بتكوين عناصر التحكم في الوصول المناسبة. لا ينبغي أبدا أن تكون الوظائف الإدارية عامة.


الوثائق ذات الصلة: