العودة إلى الدرس

ملف العمل الأصلي

START-HERE.txt

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

المسار العملي

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

دورك: أدخل قيم الإعداد الخاصة واختبر المحادثة كزائر، بما يشمل دورًا ثانيًا وحالة فشل.

1. استخدم المشروع المرفق واطلب من مساعد البرمجة تنفيذ الجانب التقني. لا تحتاج إلى كتابة HTML أو JavaScript أو SQL بنفسك.
2. اتبع خطوات الدرس الحالي، واضبط فقط حساباتك التي يحق لك استخدامها، وافحص النتيجة في الصفحة الفعلية أو لدى مزود الخدمة.
3. افصل بين النتائج المتوقعة وما لاحظته بالفعل. إن تعذّر إجراء اختبار فعلي، سجّل الخطوة المحددة التي توقفت عندها.

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

--- الإعداد المطلوب (قراءة الكود اختيارية) ---
هذا مشروع تدريب منفصل. public/ مجلد الموقع؛ ويحتوي netlify/functions/ على دوال خادم فقط. ثبّت Node وNetlify CLI لاختبار الدوال محليًا، أو انشر المشروع إلى حسابك في Netlify. ضع بيانات الاعتماد الحقيقية في متغيرات بيئة الخادم، لا في public/ أو Git أبدًا. لا يُنفّذ طلب للمزوّد بمجرد فتح هذه الملفات. يجب فحص خطوات الحساب والتسليم الحقيقي في حسابك.
اضبط GEMINI_API_KEY وGEMINI_MODEL، أي نموذج نص متاح في حساب AI Studio الخاص بك، وLAB_TOKEN غير قابل للتخمين بطول 24 محرفًا على الأقل. يُدخل المالك رمز التدريب، ولا يُضمّن في الحزمة. استخدم رسائل مصطنعة فقط: تُرسل إلى Google. افحص أسعار الحساب وحصته وشروط البيانات الحالية أولًا. هذا المختبر المقيد بالمالك ليس خدمة دردشة عامة؛ أضف مصادقة مستخدمين وحدود استخدام دائمة ومراقبة وإشعار خصوصية قبل الاستخدام العام. لا يوجد نموذج متقاعد ثابت في الشيفرة ولا وعد بفئة مجانية غير محدودة.
هذه محادثة متصفح في الذاكرة من أربع جولات. تمحوها إعادة التحميل. لا تتضمن قاعدة بيانات أو بثًا تدريجيًا. اختبر الدور الثاني، لا التحية الأولى فقط.
للأوامر المحلية الدقيقة وأسماء البيئة الخاصة، اقرأ run-locally.txt وserver-env.example.txt.

لفحص معرّفات النماذج المرئية للحساب حاليًا دون تثبيت اسم متقاعد في الشيفرة، شغّل: node --env-file=.env list-text-models.mjs
يسرد هذا المساعد بيانات النماذج الوصفية ويطبع الأسماء فقط؛ ولا يطلب إجابة مولدة. اختر مرشح نص مدعومًا حاليًا وافحص السعر والحصة قبل ضبط GEMINI_MODEL. دليل النماذج الحالي: https://ai.google.dev/gemini-api/docs/models