
درس مصغّر 17 من 30 · ربط البيانات والذكاء الاصطناعي
اختر محادثة صغيرة للاختبار
لمن هذا الدرس؟
لمن يضيفون مساعد محادثة إلى موقع صغير. المشروع مرفق؛ توجّه سلوكه وتختبره بدل كتابة كود معالجة الرسائل.
ينبغي أن تعتمد الرسالة الثانية على الأولى.
هدف هذا الدرس
- شغّل أول رد حقيقي من الذكاء الاصطناعي.
- افحص سؤالًا لاحقًا يعتمد على الرسالة السابقة.
- أبقِ الرسالة الفاشلة متاحة لإعادة المحاولة.
شرح ومثال محلول وتدريب
قبل أن تبدأ
وصولك الخاص إلى API في Google AI Studio ومشروع دوال الخادم المنفصل المرفق. يشرح درس مفاتيح API الإعداد الخاص عند الحاجة. تحقق أولًا من النماذج المتاحة وحدود الاستخدام والرسوم المحتملة. استخدم رسائل افتراضية ورمز تدريب يحتفظ به المالك؛ ويلزم إعداد المصادقة وحدود الاستخدام المستديمة ومراقبة الميزانية قبل الاستخدام العام.
تحقّق من مهارات البداية
هذه مهارات مفيدة وليست دروسًا إلزامية تمنع الدخول. ابدأ هنا إن كنت تتقنها، وإلا افتح التحضير المرتبط. ملفات البداية مرفقة، فلا تحتاج إلى موقع شخصي سابق.
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
ضع سر المزود في بيئة الخادم الخاصة فقط.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. تستخدم الطلبات الحقيقية حصة الحساب المعدّ. المصادقة العامة والحدود الدائمة ومراجعة الخصوصية أعمال منفصلة.
افهم الفكرة
افتح مشروع المحادثة الجاهز مع مساعدك. اختر موضوعًا بسيطًا ببيانات وهمية وسؤالًا لاحقًا يشير إلى الإجابة السابقة، لتتمكن من تقييم استمرار سياق المحادثة.
إجابة جيدة منفردة لا تثبت وجود محادثة تعمل. خطّط لفحص الرسالتين والعلاقة بينهما.
مثال عملي
اطلب شرحًا قصيرًا، ثم اطلب نسخة أبسط من الشرح نفسه.
استخدم مشروع المحادثة المرفق وأرشدني إلى الإعداد الخاص في run-locally.txt. أبقِ بيانات الدخول وتعليمات النموذج على الخادم. ساعدني في طرح سؤال أول، ومتابعته بسؤال عن الموضوع نفسه، واختبار طلب فاشل دون ضياع الرسالة المكتوبة. لا تُعِد بناء الموقع، ولا تدّعِ نجاح المحادثة من الإجابة الأولى وحدها.ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ما السؤال الأول والسؤال اللاحق المعتمد عليه اللذان ستجرّبهما؟
عرض حل نموذجي مشروح
مثال زوج أسئلة للاختبار: «ماذا يفعل خادم الموقع؟» ثم «بسّط هذا الشرح لشخص يبني موقعه الأول». ينبغي أن يبسط الجواب الثاني الدور نفسه، لا أن يبدأ موضوعًا جديدًا لا علاقة له بالسابق.
هذه خطة اختبار وليست نص محادثة حدثت فعلًا. سأقيّم الاستمرارية بعد الرد الأول الحقيقي، وأعدل السؤال التالي إذا احتاج الرد إلى توضيح مختلف.
ما تتضمنه الإجابة السليمة
- يقدم سؤالًا أوليًا محددًا ومتابعة تشير إلى إجابته.
- يشرح ما يدل على استمرارية الحوار بدل اعتبار رد جيد واحد كافيًا.
كيف يعمل؟ (اختياري)
أضف روبوت محادثة يستطيع متابعة الحوار
يجب أن يقرأ تكامل دردشة مفيد أحدث رسالة للمتعلّم وسياقها.
يبني هذا الدرس معلّم مواقع صغيرًا. يستطيع الزائر السؤال وقراءة الإجابة وطرح متابعة. يرسل المتصفح المحادثة المقبولة مع كل رسالة جديدة؛ ويستدعي الخادم Gemini ويعيد استجابة نموذج حقيقية.
لا يتذكر النموذج تلقائيًا طلب HTTP السابق. نحتفظ بسجل قصير في ذاكرة هذا التبويب. تمحوه إعادة التحميل، وتتوقف الورشة بعد أربع جولات سؤال وجواب ناجحة لإبقاء التدريب محدودًا.
مثال محلول
اسأل «What is DNS?» ثم «Explain that using a street-address example.»، أي ما DNS ثم طلب شرحه بمثال عنوان شارع. يحتاج الطلب الثاني إلى السؤال والإجابة السابقين لتحديد المقصود بـ«that».
تمرين تقني إضافي
لماذا قد تبدو إجابة الدور الثاني غير مرتبطة حتى إذا نجح استدعاء API؟
عرض حل نموذجي مشروح
ربما أرسل التكامل مطالبة عامة فقط أو حذف السجل. افحص مصفوفة messages الصادرة وتأكد من احتوائها على الأدوار السابقة المقبولة والسؤال الجديد بالترتيب.
- تفحص ما إذا أُدرجت الرسائل السابقة.
- تفحص الحفاظ على أحدث رسالة للمستخدم.

الخطوة 1 · كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
شغّل روبوت المحادثة المرفق
دع المساعد يتولى إعداد الخادم الخاص.
شرح ومثال محلول وتدريب
افهم الفكرة
اتبع run-locally.txt مع المساعد. تحقق من الحساب والنموذج وشروط الاستخدام، واضبط قيم الخادم الخاصة وفق server-env.example.txt، ثم افتح رابط التطبيق الذي يطبعه الخادم الوسيط المحلي. أدخل رمز التدريب المنفصل في النموذج، لا مفتاح المزود مطلقًا. هذا الإعداد مطلوب؛ أما كتابة كود الخادم فاختيارية.
يبقى مفتاح المزود والتعليمات الحاكمة على الخادم. إن تعذر استخدام حسابك أو نموذجك، فاذكر المرحلة المحددة بدل ملء الصفحة برد وهمي.
مثال عملي
ينبغي ألا يسمح حقل في الموقع للزائر باختيار بيانات وصولك الخاصة إلى المزود.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
هل أنتج التطبيق الذي يعمل إجابة أولى حقيقية؟ وإن لم يفعل، فأين توقف الإعداد؟
عرض حل نموذجي مشروح
مثال سجل أول استدعاء: «فتح التطبيق الكامل عند رابط الخادم الوسيط. أدخلت رمز التدريب المنفصل وتلقيت شرحًا من نموذج المزود المُعدّ. بقي مفتاح Google في بيئة الخادم الخاصة».
مثال عائق: «فتحت الصفحة المحلية، لكن الخادم لم يستطع الحصول على رد من النموذج». سجل مرحلة الإعداد أو الوصول أو الحصة الفعلية، وراجع تكاليف الحساب قبل إعادة المحاولة. معاينة ملف ثابت لا تثبت الحصول على رد حي.
ما تتضمنه الإجابة السليمة
- يحدد تطبيق الخادم الوسيط المحلي وأول استجابة فعلية من نموذج المزود، أو العائق المحدد.
- يفصل رمز التدريب عن مفتاح المزود الخاص، ويتحقق من حدود استخدام الحساب والنموذج.
كيف يعمل؟ (اختياري)
اربط المتصفح بدالة خادم محدودة
أبقِ بيانات الاعتماد ودور المعلّم تحت سيطرة الخادم.
انشر المجلدات المرفقة واضبط المتغيرات في START-HERE.txt. يرسل public/app.js رسائل user/assistant إلى دالة mini-chat الخاصة بك. لا تقبل الدالة إلا أدوارًا متناوبة ونصًا محدودًا وسجلًا صغيرًا.
يطابق الخادم assistant مع دور model لدى Gemini، ويوفر تعليمات نظام منفصلة. لا يستطيع مقدم الطلب اختيار رابط مزوّد أو استبدال تلك التعليمات بدور system يقدمه العميل. يقيّد رمز المالك هذا المختبر؛ ولا يحل محل المصادقة العامة وضوابط الإنفاق الدائمة.
الدالة generate مساعد محلي داخل netlify/functions/mini-chat.mjs، وليست خدمة منشورة أخرى. لتغيير دور المعلّم في المهمة، عدّل نص التعليمات الممرر إلى generate في ملف الخادم هذا. ضبط متغير .env للواجهة الأمامية ليس بديلًا: تصبح القيمة المستبدلة في شيفرة المتصفح عامة.
للتسلسل المحلي الكامل، افتح run-locally.txt: جهز بيئة الجذر الخاصة، واربط مشروع التدريب فقط، وابدأ وكيل دوال Netlify. يسرد server-env.example.txt أسماء المتغيرات دون أسرار حقيقية. فتح HTML وحده لا يشغّل الخادم.
استخدم دليل النماذج الحالي أدناه، أو شغّل list-text-models.mjs من جذر الورشة الخاص ببيئتك. يسرد مرشحي generateContent المرئيين للحساب دون طباعة المفتاح. اختر نموذج نص مدعومًا وافحص شروطه وحصته، ثم انسخ معرّف API الدقيق إلى إعداد GEMINI_MODEL في الخادم.
مثال محلول
يرفض مدقق السجل رسالة محقونة بدور system قبل استدعاء المزوّد. لا يجعل مخرجات النموذج معصومة، لكنه يُبقي شكل الطلب والإعدادات ذات الامتيازات تحت سيطرتك.
واجهة Gemini generateContent API · مفاتيح Gemini API · Gemini: معرّفات النماذج الحالية وقدراتها · Node.js: حالة دعم الإصدارات
تمرين تقني إضافي
هل ينبغي أن يختار المتصفح GEMINI_API_KEY أو يرسل رسالة system لتجاوز المعلّم؟
عرض حل نموذجي مشروح
لا هذا ولا ذاك. اضبط المفتاح والدور في الخادم. تحقق من أدوار العميل وأحجامه؛ وتظل استجابات النموذج بحاجة إلى تقييم صحتها.
- تُبقي أسرار المزوّد في الخادم.
- تتعامل مع رسائل العميل كمدخلات محادثة غير موثوقة.

الخطوة 2 · كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
تابع المحادثة وجرّب الفشل
احفظ الرسالة المكتوبة عندما يفشل الطلب.
شرح ومثال محلول وتدريب
افهم الفكرة
أرسل السؤال اللاحق المعتمد على السياق وقارن إجابته بالتبادل السابق. اطلب من المساعد محاكاة طلب فاشل واحد أو إعادة إنتاجه في المشروع القابل للحذف.
ينبغي أن تبقى المتابعة مرتبطة بمحادثتك، وأن يحافظ الإرسال الفاشل على المسودة والرسائل السابقة لإعادة المحاولة.
مثال عملي
فشل الدور الثاني يجب ألا يمحو السؤال الذي كتبته للتو.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ماذا حدث في المتابعة وفي مسار فشل الإرسال وإعادة المحاولة؟
عرض حل نموذجي مشروح
مثال سجل محادثة: «بعد شرح الخادم، ظل طلبي لنسخة أبسط مرتبطًا بالشرح نفسه. استخدمت بعدها رمز تدريب خاطئًا عمدًا في محاولة إرسال؛ وظلت المسودة والرسائل السابقة ظاهرة. أتاحت استعادة الرمز الصحيح إعادة المحاولة».
رفض الرمز الخاطئ اختبار محلي مقصود، وليس انقطاعًا لدى المزود. إذا اختفت المسودة أو تكرر تبادل ناجح عند إعادة المحاولة، فالمحادثة غير جاهزة بعد.
ما تتضمنه الإجابة السليمة
- يقارن جواب المتابعة بالتبادل السابق للتحقق من استمرار الموضوع.
- يختبر حالة فشل موضحة بجلاء، ويتحقق من بقاء المسودة والرسائل السابقة للمحاولة مجددًا.
كيف يعمل؟ (اختياري)
اختبر الاستمرار والفشل
اجعل الدور الثاني جزءًا من اختبار الإكمال.
اسأل مثال DNS، ثم سؤال متابعة يشير إليه. افحص متن الطلب في أدوات المتصفح وقارن الإجابة بالسؤال الأخير الفعلي. الاستجابة الطويلة السلسة ليست دليل صلة.
جرّب رمز وصول خاطئًا للإرسال التالي. تبقى المسودة في حقل النص ولا تُضاف جولة فاشلة إلى السجل المقبول. بعد تصحيح الوصول، أعد المحاولة. يرسل Enter؛ وينشئ Shift+Enter سطرًا جديدًا. يُعطّل الزر أثناء الانتظار.
مثال محلول
تؤدي المهلة أو استجابة المزوّد غير المكتملة إلى فشل ظاهر. لا يضيف المتصفح رسالة assistant فارغة ويتظاهر بأن المحادثة استمرت.
تمرين تقني إضافي
إجابتك الأولى جيدة لكن الطلب الثاني يفشل. ماذا ينبغي أن يحدث للرسالة المكتوبة والسجل؟
عرض حل نموذجي مشروح
احتفظ بالمسودة والأدوار السابقة المقبولة. أظهر الفشل بصدق، وأعد عناصر الإرسال للعمل، ولا تضف الزوج الجديد إلا بعد وصول إجابة صحيحة.
- تحافظ على المسودة لإعادة المحاولة.
- لا تسجل رد مساعد مختلقًا.

الخطوة 3 · كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
سلّم سلوك المحادثة
استخدم عدة تبادلات بدل إجابة جذابة واحدة.
شرح ومثال محلول وتدريب
افهم الفكرة
أكمل اختبارًا من ثلاثة تبادلات حول موضوعك الوهمي واحتفظ بسجل أزلت منه المعلومات الحساسة. كرّر التعافي من فشل الإرسال بعد أي إصلاح.
تحقق من أن إعادة المحاولة لا تفقد المسودة أو تكرر تبادلًا ناجحًا. سجل الاختبارات غير المتاحة بأنها لم تُنفذ. لا يسترجع هذا المثال ملاحظات موثوقة من الموقع ولا يضمن صحة الأجوبة؛ ويضيف درس chatbot المعتمد على المحتوى التالي مهمة بمصادر مرفقة والتحقق منها.
مثال عملي
ينبغي أن يوضح دليلك ما سأله الزائر وما جاءه وكيف استعاد المسار عمله بعد طلب فاشل.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
قدّم سجل المحادثة وملاحظة فشل الطلب وإعادة المحاولة الفعلية.
ما المطلوب إنجازه: سجل محادثة متعدد الأدوار قصير ونتيجة فعلية للفشل وإعادة المحاولة، بعد إزالة الأسرار.
عرض حل نموذجي مشروح
مثال مخطط ثلاثة تبادلات: «1. اشرح خادم الموقع. 2. بسّط ذلك الجواب. 3. أعط مثالًا واحدًا لمساعدة الخادم لهذا الموقع». يتضمن السجل المكتمل الردود الفعلية بجوار الأسئلة كي يمكن تقييم العلاقة بينها.
مثال ملاحظة تعافٍ: «احتفظ إرسال رُفض عمدًا بمسودته؛ وأضافت إعادة المحاولة تبادلًا ناجحًا واحدًا، لا اثنين». قبل الاستخدام العام، ما زال المثال المقصور على المالك يحتاج إلى مصادقة وضوابط استخدام مستديمة ومراقبة التكلفة؛ وليس نظام إجابات يستند إلى مصادر.
ما تتضمنه الإجابة السليمة
- يتضمن ثلاثة تبادلات مترابطة وسياقًا كافيًا لتقييم الأجوبة.
- يسجل التعافي من فشل الإرسال دون ضياع مسودة أو تكرار تبادل ناجح.
كيف يعمل؟ (اختياري)
مهمتك: اجعل المعلّم جديرًا بمتابعة الحوار
قيّم الصلة بدل عد الطلبات الناجحة فقط.
غيّر تعليمات الخادم إلى معلّم HTML/CSS موجز. أجرِ ثلاث جولات: اسأل عن مرساة معطلة، واقترح زوج href/id غير صحيح، واسأل لماذا يفشل. استخدم شيفرة مصطنعة، لا مصدرًا خاصًا.
احتفظ بنص محادثة محجوب البيانات الحساسة وعلّق على ما إذا كانت الإجابة تعالج كل رسالة أخيرة. كرر إرسالًا فاشلًا وأثبت أن إعادة المحاولة تُبقي المحادثة متماسكة. قبل الوصول العام، خطط لمصادقة فعلية وحصص دائمة لكل مستخدم وشرح لوجهة إرسال الرسائل.
مثال محلول
يسمي المعلّم المفيد قيم href/id غير المتطابقة. نصائح عامة عن تسمية المتغيرات تفوّت إجابة المتعلّم المحددة، حتى إن كانت صحيحة تقنيًا.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
تمرين تقني إضافي
أنجز نص محادثة لثلاث جولات وملاحظة فشل وإعادة محاولة واحدة.
عرض حل نموذجي مشروح
عدّل نص التعليمات في دالة الخادم إلى معلّم HTML/CSS موجز. لا تغيّر متغير واجهة أمامية أو تنقل generate إلى المجلد العام. الدالة المرجعية نسخة كاملة بالتعليمات المعدّلة.
تقييم نموذجي: يسأل المستخدم لماذا لا تصل <a href='#work'> إلى <section id='projects'>. تسمي الاستجابة ذات الصلة عدم تطابق href/id هذا. يقترح المستخدم بعد ذلك href='#projects'؛ فتفحص متابعة ذات صلة هذا التصحيح تحديدًا. تفشل نصائح عامة لتسمية المتغيرات في هذا الاختبار حتى لو كانت حالة HTTP هي 200.
أرسل برمز تدريب خاطئ في دور لاحق. يجب أن تبقى المحادثة المقبولة سليمة وأن يحتفظ حقل النص بالمسودة غير المرسلة. صحح الوصول وأعد المحاولة؛ لا تضف زوج user/assistant جديدًا إلا بعد رد صحيح. نص المحادثة النموذجي هذا دليل تقييم، وليس ادعاء بنتيجة مولدة فعلية.
- تستجيب المتابعات للرسائل السابقة الفعلية.
- يحافظ الفشل على المسودة والسجل، ويظل مفتاح المزوّد خاصًا.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.