
درس مصغّر · العربية
كيف تجعل روبوت محادثة يجيب من محتواك الخاص
ابدأ بمشروع المقهى الجاهز: أضف معلوماتك بمساعد برمجة وتحقّق من الإجابات ومصادرها.
لمن هذا الدرس؟
لمن يريد روبوتًا يجيب من معلومات موقعه. ستشغّل المشروع وتعدّل ملاحظاته بمساعد برمجة؛ لا يلزم كتابة HTML أو JavaScript من الصفر.
قبل أن تبدأ
يكفي المتصفح للتدريب الأول. للإجابات الحقيقية تحتاج مساعد برمجة، وفتح مجلد وتنفيذ أوامر، وNode LTS مدعومًا، ومشروع Netlify تجريبيًا، ووصولك إلى API في Google AI Studio. درسا المفاتيح والروبوت يشرحان الإعداد؛ تجاوزهما إن كنت تتقنه. جميع الملفات مرفقة.
الوقت المتوقع: 20–37 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. آلية الاسترجاع البسيطة بالكلمات المفتاحية محدودة عمدًا. الاسترجاع وفحوص المصادر لا يضمنان صحة كل ادعاء مولّد.
ما الذي ستتعلمه؟
- تشغيل الروبوت ومقارنة الإجابة بمصدرها.
- إضافة قاعدة بتعديل ملف معلومات واحد.
- تمييز المعلومة الغائبة من تعطل الخدمة.
الخطوة 1
أنشئ روبوتًا يعرف معلومات المقهى
النتيجة: مربع أسئلة يجيب من الملاحظات ويفتح مصدر الإجابة.
يسأل زائر المقهى عن الساعات والدخول والحجز. الروبوت العام لا يعرف هذه الحقائق تلقائيًا. سنشغّل مقهى خياليًا جاهزًا ونزوّده بالملاحظات ونختبر الإجابات.
مهمتك تشغيل المشروع وتغيير معلومة وفحص النتيجة. يمكن لمساعد البرمجة تنفيذ التغيير؛ لست مطالبًا بقراءة كل الكود. المعلومات القابلة للتعديل في records.json، والموقع والخادم جاهزان.
افتح أولًا practice/index.html وجرّب الأسئلة. يعرض التدريب المحلي السؤال والملاحظة المختارة والمعلومة بقواعد ثابتة، دون نموذج أو إرسال إلى Google. ستشغّل الروبوت الحقيقي لاحقًا.
التجربة الأولى: معلومة متاحة وأخرى غائبة
اسأل عن الساعات: الثلاثاء–السبت، 09:00–17:00. ثم عن هاتف المالك: لا رقم في الملاحظات. يجب التصريح بذلك بدل اختراعه.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
الخطوة 2
شغّل المشروع مع مساعد البرمجة
نزّل المشروع كاملًا، واضبط القيم الخاصة، وافتح العنوان الذي يطبعه الخادم.
افتح ملفات التطبيق واحفظها في مجلد مشروع واحد مع الاحتفاظ بمسارات المجلدات الموضحة. افتح المجلد في مساعد البرمجة. public/index.html هو صفحة الزائر؛ ويعمل netlify/functions/mini-chat.mjs على الخادم. هذه ملفات تنفيذ جاهزة، وليست واجبًا لقراءة الكود. اطلب من المساعد إعداد المشروع الحالي باستخدام الطلب أدناه.
اتبع run-locally.txt: نفّذ npm install ثم npx netlify login ثم npx netlify link لمشروع التجربة فقط. جهّز .env بأسماء server-env.example.txt: GEMINI_API_KEY مفتاحك، وGEMINI_MODEL معرّف نموذج متاح، وLAB_TOKEN رمز دخول منفصل. الرمز ليس مفتاح Google.
نفّذ npm run dev وافتح العنوان الظاهر، عادة http://localhost:8888 لهذا المشروع. أدخل رمز التدريب واسأل عن الساعات. الإجابة ورابط المصدر أول فحص حقيقي. معاينة HTML لا تشغّل الخادم؛ اذكر العائق بدقة بدل ادعاء النجاح.
انسخ هذا الطلب إلى مساعد البرمجة
يساعد المساعد في الإعداد؛ تضع الأسرار في البيئة الخاصة وتفحص النتيجة في المتصفح. لا تضع مفتاح Google في حقل رمز الدخول.
افتح مجلد روبوت المقهى هذا واستخدم الملفات الموجودة بدل إعادة بناء الموقع. أرشدني خلال run-locally.txt وافحص Node واشرح القيم الخاصة الثلاث. بعد أن أضعها في البيئة الخاصة شغّل المشروع محليًا. اعرض العنوان وساعدني في اختبار الساعات ورابط المصدر. لا تدّعِ وصول رد من المزوّد قبل نجاح طلب فعلي.Google AI Studio: إنشاء مفاتيح API وإدارتها · Netlify: التطوير المحلي وربط المشروع
جرّب بنفسك
شغّل المشروع واسأل عن الساعات. اذكر العنوان المحلي ووصول إجابة حقيقية والمصدر المفتوح. وإلا فحدّد المتطلب الغائب أو الخطأ.
- نزّل المشروع كاملًا، لا ملفًا منفردًا.
- استخدم الطلب وأسماء متغيرات البيئة الخاصة المرفقة.
- افتح التطبيق المحلي واتبع مصدر الإجابة.
ما المطلوب إنجازه سجل قصير أو عائق محدد، دون أسرار.
عرض حل نموذجي مشروح
سجل مفيد يبيّن فتح عنوان الوكيل ووصول الرد وفتح Opening hours للملاحظة الصحيحة. هذا قالب سجل لا إثبات تشغيل حسابك. حدّد عائق الوصول أو النموذج أو الخادم واطلب فحصه.
- يميّز التطبيق والإجابة الحقيقية من معاينة الملف.
- يسجّل المصدر أو عدم التنفيذ دون كشف أسرار.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
الخطوة 3
تحقّق من الإجابة بفتح مصدرها
قبل التعديل، جرّب معلومة معروفة وأخرى غائبة وتعليمات تناقض الملاحظات.
اسأل عن السبت وافتح المصدر: 09:00–17:00. ثم الهاتف الغائب؛ اختراع رقم فشل. سجّل المشاهدات في evaluation.txt.
اطلب تجاهل الملاحظات وادعاء فتح المقهى الأحد. المصدر يقول مغلق. الرابط الحقيقي لا يجعل الجملة المناقضة صحيحة.
يختار المشروع ملاحظة بكلمات السؤال، ثم يطلب من النموذج الإجابة. إن فشلت إعادة صياغة في إيجادها، افحص الاختيار والكلمات مع المساعد. إن اختار الصحيح وأجاب خطأ، افحص مرحلة الإجابة. قراءة الخادم كاملًا اختيارية.
شخّص ما شاهدته
«مفتوح الأحد حتى 17:00» ومصدر يقول «مغلق» إجابة خاطئة موثّقة برابط. عدم العثور على ملاحظة قد يكون مشكلة اختيار. خطأ الشبكة حالة ثالثة؛ لا يعني غياب المعلومة.
جرّب بنفسك
الإجابة تزعم فتح الأحد حتى 17:00 ومصدرها يقول مغلق. هل تُقبل؟ حدّد التناقض والفحص التالي المطلوب.
- قارن الادعاء نفسه بنص المصدر.
- صف التصحيح؛ لست مطالبًا بكتابة الخادم.
ما المطلوب إنجازه الادعاء الخاطئ وحقيقة المصدر وفحص محدد.
عرض حل نموذجي مشروح
ارفض: مفتوح يناقض مغلق. اطلب إعادة السؤال وفحص hours وتصحيح استخدام الملاحظة واختباره. احتفظ بالرابط وتحقق من الكلام أيضًا.
- يرفض فتح الأحد رغم صحة الرابط.
- يطلب فحص التزام الإجابة بالملاحظة لا تعديل شكل الصفحة.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
الخطوة 4
أضف قاعدة للمقهى واختبر التغيير
أضف قاعدة الكلاب في ملف واحد مع المساعد، وزامن المشروع واختبر مجددًا.
أضف في records.json: الكلاب مسموحة في الشرفة فقط، لا بالداخل. يمكن للمساعد تعديل JSON. استخدم dogs معرّفًا وعنوانًا واضحًا وكلمات تناسب أسئلتك.
نفّذ npm run sync:notes. يحدّث sync-records.mjs الخادم والمصادر والتدريب المحلي. أعد التشغيل والتحميل والاختبار؛ لا تعدّل HTML وبيانات الخادم يدويًا كلًّا على حدة.
اختبر السؤال المباشر وإعادة صياغة وسؤالًا لا علاقة له وتعليمات للسماح بالكلاب في كل مكان. سجّل المتوقع والمشاهد في evaluation.txt. افحص المرجع بعد محاولتك؛ ليس دليلًا على اختبارك.
اطلب تغييرًا محدودًا
«أضف قاعدة الشرفة فقط في records.json مع dog وdogs وterrace وكلمات لغتي. احفظ بقية المعلومات، وزامن وأعد التشغيل وساعدني في اختبار المصدر وسؤال لا علاقة له.»
يعرض reference/records.json وreference/assignment-walkthrough.txt مقارنة كاملة. يمكن التدريب المحلي بلا حساب API، مع فصل نتائجه عن ردود النموذج الحقيقي.
مهمتك العملية
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
أضف قاعدة الشرفة مع المساعد، وزامن واختبر. أرسل الملاحظة والمتوقع/المشاهد وحدّد تدريبًا محليًا أو AI حقيقيًا أو لم يُنفّذ.
- عدّل records.json ودع الأمر يحدّث النسخ.
- أعد التشغيل وجرّب سؤال كلاب ومعلومة غائبة.
- تحقّق من أن الشرفة فقط لا تصبح إذنًا بالداخل.
ما المطلوب إنجازه الملاحظة وفحصان متوقع/مشاهد على الأقل، مع نمط الاختبار والعوائق.
عرض حل نموذجي مشروح
ملاحظة صحيحة تشمل dogs وعنوانًا وقاعدة الشرفة فقط وكلمات مفيدة. بعد المزامنة يجب أن يفتح الرابط القاعدة نفسها.
رد الكلاب يقتصر على الشرفة؛ السؤال الآخر لا يختلق معلومات، والتعليمات لا تغيّر القاعدة. انقل مشاهداتك ونمط الاختبار؛ غير المنفّذ يبقى كذلك.
- يحافظ على دقة القاعدة ومصدر يحتويها فعلًا.
- يفصل المشاهدة والتوقع وغياب المطابقة وتعطل الخدمة.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تتيح للناس تسجيل الدخول إلى موقعك
- كيف تُبقي صفحة خاصة
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تتيح للمستخدمين رفع الصور
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تعاين تغييرات موقعك قبل النشر
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها
- كيف تجد الأخطاء في موقعك المنشور وتصلحها