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

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

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. افحص أسعار الحساب وحصته وشروط البيانات الحالية أولًا. هذا المختبر المقيد بالمالك ليس خدمة دردشة عامة؛ أضف مصادقة مستخدمين وحدود استخدام دائمة ومراقبة وإشعار خصوصية قبل الاستخدام العام. لا يوجد نموذج متقاعد ثابت في الشيفرة ولا وعد بفئة مجانية غير محدودة.
يرسل هذا الدرس سؤالًا ثابتًا واحدًا، لا مطالبات زوار اعتباطية. انشر public/ مع netlify/functions/. ابحث عن مفتاح المزوّد في الملفات العامة وطلبات المتصفح قبل اعتبار النقل مكتملًا.
للأوامر المحلية الدقيقة وأسماء البيئة الخاصة، اقرأ 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