بيئة موثوقة لوكلائك.

افصل الـ worker عن القرارات

الوكيل يقدر يخطط مهمة بينما الطابور يتحكم في وقت تنفيذ العامل ليها. ده بيخلي إعادة المحاولة واضحة ويمنع إن فشل مؤقت في API يتحول لإجراء مكرر. ادي كل مهمة معرّف وسجّل تغييرات الحالة المهمة.

تعامل مع الأدوات كصلاحيات

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

• خلي الأسرار بره جذر الويب ونظام التحكم في الإصدارات
• استخدم حدود الإنفاق والطلبات لـ API الخارجية
• احتفظ بسجل قابل للتدقيق دون تخزين بيانات شخصية غير ضرورية

صمّم لعملية متوقفة

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

اختار حجم الماكينة المناسب

العامل اللي بيتصل بموديل بعيد غالبًا بيحتاج CPU متواضعة وذاكرة كافية لأدواته. أتمتة المتصفح ممكن تستهلك RAM أكبر بكتير. تشغيل الموديل محليًا له متطلبات ذاكرة ومسرّعات منفصلة؛ وجود VPS عام مش معناه إن فيه GPU متوصّل.

تصميم سير عمل التجهيز

سير عمل تكامل الوكيل يقدر يفحص الخطط العامة، ويسجّل حساب، ويجهّز طلب خدمة في حدود سقف إنفاق واضح. الدفع وإنشاء السيرفر محتاجين التصريح المناسب. لازم يستقبل معرّف عملية، ويستنى الحالة المكتملة، وبعدين يدير السيرفر بمفتاح SSH العام بتاعه. الإزالة لازم تكون مقصودة وتحافظ على النتائج المطلوبة.

أحداث بدلًا من الاستقصاء المتلهف

الويب هوكس الموقّعة تقدر تبلّغ عن تسوية الدفع وتغييرات دورة الحياة. تحقق من صحتها، وامنع التكرار في التسليم، وطابق مع API قبل ما تاخد الخطوة الجاية. المزوّد مش المفروض يستقبل مفتاح SSH الخاص بالوكيل أو عبارة استرداد المحفظة أو بيانات اعتماد موديل غير مقيّدة.

حوّل مهمة واحدة إلى عملية واحدة متينة

امنح كل مهمة معرّفًا ثابتًا وحالات صريحة مثل في الانتظار، قيد التشغيل، بانتظار الموافقة، مكتملة أو فاشلة. احفظ نتيجة إجراء خارجي قبل الإقرار به للمخطط. ينبغي للعامل المعاد تشغيله فحص الحالة المحفوظة بدلًا من إعادة تشغيل دفعة أو رسالة أو كتابة إنتاجية لأن مخرجاته الطرفية فُقدت.

أدوات التجهيز والـ workers المستضافة منتجات منفصلة

VPS ممكن يشغّل وكيل العميل باستمرار باستخدام مدير الخدمة وبيانات الاعتماد الخاصة بيه. نقطة نهاية API أو MCP للوحة تحكم الاستضافة هي تكامل مختلف. الأول ممكن يتنشر كتطبيق؛ التاني محتاج تكامل لوحة تحكم KoalaVPS منفصل الإصدار ومش متوصل بالتوثيق ده.

خصّص ميزانية للعامل الكامل

احجز الذاكرة للمتصفح وعميل الموديل والطابور وقاعدة البيانات مع بعض. عامل صغير مدفوع بـ API ممكن يحتاج CPU متواضعة، بينما جلسات المتصفح المتزامنة بتستهلك RAM بسرعة. اضبط تزامن الطابور وحدود الإنفاق الخارجي على API قبل ما تكبّر حجم الجهاز. مفيش اشتراك موديل أو مسرّع أو مخصص API من طرف تالت متضمّن ضمنيًا.

تسليم تشغيلي مفيد

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

شوية وضوح أكتر.