الدروسكيف تجعل روبوت محادثة يجيب من محتواك الخاص

درس مصغّر 18 من 30 · ربط البيانات والذكاء الاصطناعي

أنشئ روبوتًا يعرف معلومات المقهى

لمن هذا الدرس؟

لمن يريد روبوتًا يجيب من معلومات موقعه. ستشغّل المشروع وتعدّل ملاحظاته بمساعد برمجة؛ لا يلزم كتابة HTML أو JavaScript من الصفر.

النتيجة: مربع أسئلة يجيب من الملاحظات ويفتح مصدر الإجابة.

هدف هذا الدرس

  • تشغيل الروبوت ومقارنة الإجابة بمصدرها.
  • إضافة قاعدة بتعديل ملف معلومات واحد.
  • تمييز المعلومة الغائبة من تعطل الخدمة.
شرح ومثال محلول وتدريب

قبل أن تبدأ

يكفي المتصفح للتدريب الأول. للإجابات الحقيقية تحتاج مساعد برمجة، وفتح مجلد وتنفيذ أوامر، وNode LTS مدعومًا، ومشروع Netlify تجريبيًا، ووصولك إلى API في Google AI Studio. درسا المفاتيح والروبوت يشرحان الإعداد؛ تجاوزهما إن كنت تتقنه. جميع الملفات مرفقة.

تحقّق من مهارات البداية

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

  1. كيف تُبقي مفاتيح API خارج الواجهة الأمامية

    ضع سر المزود في بيئة الخادم الخاصة فقط.

  2. كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك

    شغّل أول رد حقيقي من الذكاء الاصطناعي.

الوقت المتوقع: 20–37 دقيقة

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

افهم الفكرة

يسأل زائر المقهى عن الساعات والدخول والحجز. الروبوت العام لا يعرف هذه الحقائق تلقائيًا. سنشغّل مقهى خياليًا جاهزًا ونزوّده بالملاحظات ونختبر الإجابات.

مهمتك تشغيل المشروع وتغيير معلومة وفحص النتيجة. يمكن لمساعد البرمجة تنفيذ التغيير؛ لست مطالبًا بقراءة كل الكود. المعلومات القابلة للتعديل في records.json، والموقع والخادم جاهزان.

افتح أولًا practice/index.html وجرّب الأسئلة. يعرض التدريب المحلي السؤال والملاحظة المختارة والمعلومة بقواعد ثابتة، دون نموذج أو إرسال إلى Google. ستشغّل الروبوت الحقيقي لاحقًا.

التجربة الأولى: معلومة متاحة وأخرى غائبة

اسأل عن الساعات: الثلاثاء–السبت، 09:00–17:00. ثم عن هاتف المالك: لا رقم في الملاحظات. يجب التصريح بذلك بدل اختراعه.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

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

  1. افتح رابط التدريب الجاهز؛ لا تنزيل ولا مفتاح مطلوب.
  2. قارن المعلومات المختارة والإجابة للسؤالين.

ما المطلوب إنجازه: ملاحظتان قصيرتان: معلومة مدعومة وأخرى غائبة.

عرض حل نموذجي مشروح

سؤال الساعات يختار hours ويعرض المعلومة. الهاتف لا يجد ملاحظة ويعرض رسالة النقص. لم يُختبر توليد حقيقي بعد.

ما تتضمنه الإجابة السليمة

  • يميّز ملاحظة الساعات من غياب الهاتف.
  • يصف النتيجة المحلية دون ادعاء طلب إلى نموذج.

الخطوة 1 · كيف تجعل روبوت محادثة يجيب من محتواك الخاص

شغّل المشروع مع مساعد البرمجة

نزّل المشروع كاملًا، واضبط القيم الخاصة، وافتح العنوان الذي يطبعه الخادم.

شرح ومثال محلول وتدريب

افهم الفكرة

افتح ملفات التطبيق واحفظها في مجلد مشروع واحد مع الاحتفاظ بمسارات المجلدات الموضحة. افتح المجلد في مساعد البرمجة. 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 واشرح القيم الخاصة الثلاث. بعد أن أضعها في البيئة الخاصة شغّل المشروع محليًا. اعرض العنوان وساعدني في اختبار الساعات ورابط المصدر. لا تدّعِ وصول رد من المزوّد قبل نجاح طلب فعلي.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

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

  1. نزّل المشروع كاملًا، لا ملفًا منفردًا.
  2. استخدم الطلب وأسماء متغيرات البيئة الخاصة المرفقة.
  3. افتح التطبيق المحلي واتبع مصدر الإجابة.

ما المطلوب إنجازه: سجل قصير أو عائق محدد، دون أسرار.

عرض حل نموذجي مشروح

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

ما تتضمنه الإجابة السليمة

  • يميّز التطبيق والإجابة الحقيقية من معاينة الملف.
  • يسجّل المصدر أو عدم التنفيذ دون كشف أسرار.

الخطوة 2 · كيف تجعل روبوت محادثة يجيب من محتواك الخاص

تحقّق من الإجابة بفتح مصدرها

قبل التعديل، جرّب معلومة معروفة وأخرى غائبة وتعليمات تناقض الملاحظات.

شرح ومثال محلول وتدريب

افهم الفكرة

اسأل عن السبت وافتح المصدر: 09:00–17:00. ثم الهاتف الغائب؛ اختراع رقم فشل. سجّل المشاهدات في evaluation.txt.

اطلب تجاهل الملاحظات وادعاء فتح المقهى الأحد. المصدر يقول مغلق. الرابط الحقيقي لا يجعل الجملة المناقضة صحيحة.

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

شخّص ما شاهدته

«مفتوح الأحد حتى 17:00» ومصدر يقول «مغلق» إجابة خاطئة موثّقة برابط. عدم العثور على ملاحظة قد يكون مشكلة اختيار. خطأ الشبكة حالة ثالثة؛ لا يعني غياب المعلومة.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

الإجابة تزعم فتح الأحد حتى 17:00 ومصدرها يقول مغلق. هل تُقبل؟ حدّد التناقض والفحص التالي المطلوب.

  1. قارن الادعاء نفسه بنص المصدر.
  2. صف التصحيح؛ لست مطالبًا بكتابة الخادم.

ما المطلوب إنجازه: الادعاء الخاطئ وحقيقة المصدر وفحص محدد.

عرض حل نموذجي مشروح

ارفض: مفتوح يناقض مغلق. اطلب إعادة السؤال وفحص hours وتصحيح استخدام الملاحظة واختباره. احتفظ بالرابط وتحقق من الكلام أيضًا.

ما تتضمنه الإجابة السليمة

  • يرفض فتح الأحد رغم صحة الرابط.
  • يطلب فحص التزام الإجابة بالملاحظة لا تعديل شكل الصفحة.

الخطوة 3 · كيف تجعل روبوت محادثة يجيب من محتواك الخاص

أضف قاعدة للمقهى واختبر التغيير

أضف قاعدة الكلاب في ملف واحد مع المساعد، وزامن المشروع واختبر مجددًا.

شرح ومثال محلول وتدريب

افهم الفكرة

أضف في 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 حقيقيًا أو لم يُنفّذ.

  1. عدّل records.json ودع الأمر يحدّث النسخ.
  2. أعد التشغيل وجرّب سؤال كلاب ومعلومة غائبة.
  3. تحقّق من أن الشرفة فقط لا تصبح إذنًا بالداخل.

ما المطلوب إنجازه: الملاحظة وفحصان متوقع/مشاهد على الأقل، مع نمط الاختبار والعوائق.

عرض حل نموذجي مشروح

ملاحظة صحيحة تشمل dogs وعنوانًا وقاعدة الشرفة فقط وكلمات مفيدة. بعد المزامنة يجب أن يفتح الرابط القاعدة نفسها.

رد الكلاب يقتصر على الشرفة؛ السؤال الآخر لا يختلق معلومات، والتعليمات لا تغيّر القاعدة. انقل مشاهداتك ونمط الاختبار؛ غير المنفّذ يبقى كذلك.

ما تتضمنه الإجابة السليمة

  • يحافظ على دقة القاعدة ومصدر يحتويها فعلًا.
  • يفصل المشاهدة والتوقع وغياب المطابقة وتعطل الخدمة.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.