درس مصغّر · العربية

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

ابدأ بمشروع المقهى الجاهز: أضف معلوماتك بمساعد برمجة وتحقّق من الإجابات ومصادرها.

ابدأ الدرس التفاعلياقرأ ملاحظات الدرس

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

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

قبل أن تبدأ

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

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

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

ما الذي ستتعلمه؟

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

ملفات ورشة العمل

الخطوة 1

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

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

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

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

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

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

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

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

Start hereملفات ورشة العمل

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: التطوير المحلي وربط المشروع

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

Start hereملفات ورشة العمل

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» ومصدر يقول «مغلق» إجابة خاطئة موثّقة برابط. عدم العثور على ملاحظة قد يكون مشكلة اختيار. خطأ الشبكة حالة ثالثة؛ لا يعني غياب المعلومة.

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

Start hereملفات ورشة العمل

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، مع فصل نتائجه عن ردود النموذج الحقيقي.

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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

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

واصل التعلّم

استكشف الدروس الأخرى