
درس مصغّر · العربية
كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
شغّل روبوت محادثة خاصًا جاهزًا بمساعدة مساعد برمجة، واختبر هل يستند السؤال اللاحق إلى المحادثة، وهل يحتفظ التطبيق بالمحتوى عند فشل طلب.
لمن هذا الدرس؟
لمن يضيفون مساعد محادثة إلى موقع صغير. المشروع مرفق؛ توجّه سلوكه وتختبره بدل كتابة كود معالجة الرسائل.
قبل أن تبدأ
وصولك الخاص إلى API في Google AI Studio ومشروع دوال الخادم المنفصل المرفق. يشرح درس مفاتيح API الإعداد الخاص عند الحاجة. تحقق أولًا من النماذج المتاحة وحدود الاستخدام والرسوم المحتملة. استخدم رسائل افتراضية ورمز تدريب يحتفظ به المالك؛ ويلزم إعداد المصادقة وحدود الاستخدام المستديمة ومراقبة الميزانية قبل الاستخدام العام.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. تستخدم الطلبات الحقيقية حصة الحساب المعدّ. المصادقة العامة والحدود الدائمة ومراجعة الخصوصية أعمال منفصلة.
ما الذي ستتعلمه؟
- شغّل أول رد حقيقي من الذكاء الاصطناعي.
- افحص سؤالًا لاحقًا يعتمد على الرسالة السابقة.
- أبقِ الرسالة الفاشلة متاحة لإعادة المحاولة.
الخطوة 1
اختر محادثة صغيرة للاختبار
ينبغي أن تعتمد الرسالة الثانية على الأولى.
افتح مشروع المحادثة الجاهز مع مساعدك. اختر موضوعًا بسيطًا ببيانات وهمية وسؤالًا لاحقًا يشير إلى الإجابة السابقة، لتتمكن من تقييم استمرار سياق المحادثة.
إجابة جيدة منفردة لا تثبت وجود محادثة تعمل. خطّط لفحص الرسالتين والعلاقة بينهما.
مثال عملي
اطلب شرحًا قصيرًا، ثم اطلب نسخة أبسط من الشرح نفسه.
استخدم مشروع المحادثة المرفق وأرشدني إلى الإعداد الخاص في run-locally.txt. أبقِ بيانات الدخول وتعليمات النموذج على الخادم. ساعدني في طرح سؤال أول، ومتابعته بسؤال عن الموضوع نفسه، واختبار طلب فاشل دون ضياع الرسالة المكتوبة. لا تُعِد بناء الموقع، ولا تدّعِ نجاح المحادثة من الإجابة الأولى وحدها.ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
أضف روبوت محادثة يستطيع متابعة الحوار
يجب أن يقرأ تكامل دردشة مفيد أحدث رسالة للمتعلّم وسياقها.
يبني هذا الدرس معلّم مواقع صغيرًا. يستطيع الزائر السؤال وقراءة الإجابة وطرح متابعة. يرسل المتصفح المحادثة المقبولة مع كل رسالة جديدة؛ ويستدعي الخادم Gemini ويعيد استجابة نموذج حقيقية.
لا يتذكر النموذج تلقائيًا طلب HTTP السابق. نحتفظ بسجل قصير في ذاكرة هذا التبويب. تمحوه إعادة التحميل، وتتوقف الورشة بعد أربع جولات سؤال وجواب ناجحة لإبقاء التدريب محدودًا.
مثال محلول
اسأل «What is DNS?» ثم «Explain that using a street-address example.»، أي ما DNS ثم طلب شرحه بمثال عنوان شارع. يحتاج الطلب الثاني إلى السؤال والإجابة السابقين لتحديد المقصود بـ«that».
Extra implementation exercise
لماذا قد تبدو إجابة الدور الثاني غير مرتبطة حتى إذا نجح استدعاء API؟
عرض حل نموذجي مشروح
ربما أرسل التكامل مطالبة عامة فقط أو حذف السجل. افحص مصفوفة messages الصادرة وتأكد من احتوائها على الأدوار السابقة المقبولة والسؤال الجديد بالترتيب.
- تفحص ما إذا أُدرجت الرسائل السابقة.
- تفحص الحفاظ على أحدث رسالة للمستخدم.
خطأ شائع
تسمية سلسلة إجابات جاهزة غير مترابطة محادثة.
الخطوة 2
شغّل روبوت المحادثة المرفق
دع المساعد يتولى إعداد الخادم الخاص.
اتبع run-locally.txt مع المساعد. تحقق من الحساب والنموذج وشروط الاستخدام، واضبط قيم الخادم الخاصة وفق server-env.example.txt، ثم افتح رابط التطبيق الذي يطبعه الخادم الوسيط المحلي. أدخل رمز التدريب المنفصل في النموذج، لا مفتاح المزود مطلقًا. هذا الإعداد مطلوب؛ أما كتابة كود الخادم فاختيارية.
يبقى مفتاح المزود والتعليمات الحاكمة على الخادم. إن تعذر استخدام حسابك أو نموذجك، فاذكر المرحلة المحددة بدل ملء الصفحة برد وهمي.
مثال عملي
ينبغي ألا يسمح حقل في الموقع للزائر باختيار بيانات وصولك الخاصة إلى المزود.
واجهة Gemini generateContent API · مفاتيح Gemini API · Gemini: معرّفات النماذج الحالية وقدراتها · Node.js: حالة دعم الإصدارات
جرّب بنفسك
هل أنتج التطبيق الذي يعمل إجابة أولى حقيقية؟ وإن لم يفعل، فأين توقف الإعداد؟
عرض حل نموذجي مشروح
مثال سجل أول استدعاء: «فتح التطبيق الكامل عند رابط الخادم الوسيط. أدخلت رمز التدريب المنفصل وتلقيت شرحًا من نموذج المزود المُعدّ. بقي مفتاح Google في بيئة الخادم الخاصة».
مثال عائق: «فتحت الصفحة المحلية، لكن الخادم لم يستطع الحصول على رد من النموذج». سجل مرحلة الإعداد أو الوصول أو الحصة الفعلية، وراجع تكاليف الحساب قبل إعادة المحاولة. معاينة ملف ثابت لا تثبت الحصول على رد حي.
- يحدد تطبيق الخادم الوسيط المحلي وأول استجابة فعلية من نموذج المزود، أو العائق المحدد.
- يفصل رمز التدريب عن مفتاح المزود الخاص، ويتحقق من حدود استخدام الحساب والنموذج.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
اربط المتصفح بدالة خادم محدودة
أبقِ بيانات الاعتماد ودور المعلّم تحت سيطرة الخادم.
انشر المجلدات المرفقة واضبط المتغيرات في 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: حالة دعم الإصدارات
Extra implementation exercise
هل ينبغي أن يختار المتصفح GEMINI_API_KEY أو يرسل رسالة system لتجاوز المعلّم؟
عرض حل نموذجي مشروح
لا هذا ولا ذاك. اضبط المفتاح والدور في الخادم. تحقق من أدوار العميل وأحجامه؛ وتظل استجابات النموذج بحاجة إلى تقييم صحتها.
- تُبقي أسرار المزوّد في الخادم.
- تتعامل مع رسائل العميل كمدخلات محادثة غير موثوقة.
خطأ شائع
الثقة بأدوار يرسلها العميل لأن الواجهة العادية لا تكشفها.
الخطوة 3
تابع المحادثة وجرّب الفشل
احفظ الرسالة المكتوبة عندما يفشل الطلب.
أرسل السؤال اللاحق المعتمد على السياق وقارن إجابته بالتبادل السابق. اطلب من المساعد محاكاة طلب فاشل واحد أو إعادة إنتاجه في المشروع القابل للحذف.
ينبغي أن تبقى المتابعة مرتبطة بمحادثتك، وأن يحافظ الإرسال الفاشل على المسودة والرسائل السابقة لإعادة المحاولة.
مثال عملي
فشل الدور الثاني يجب ألا يمحو السؤال الذي كتبته للتو.
جرّب بنفسك
ماذا حدث في المتابعة وفي مسار فشل الإرسال وإعادة المحاولة؟
عرض حل نموذجي مشروح
مثال سجل محادثة: «بعد شرح الخادم، ظل طلبي لنسخة أبسط مرتبطًا بالشرح نفسه. استخدمت بعدها رمز تدريب خاطئًا عمدًا في محاولة إرسال؛ وظلت المسودة والرسائل السابقة ظاهرة. أتاحت استعادة الرمز الصحيح إعادة المحاولة».
رفض الرمز الخاطئ اختبار محلي مقصود، وليس انقطاعًا لدى المزود. إذا اختفت المسودة أو تكرر تبادل ناجح عند إعادة المحاولة، فالمحادثة غير جاهزة بعد.
- يقارن جواب المتابعة بالتبادل السابق للتحقق من استمرار الموضوع.
- يختبر حالة فشل موضحة بجلاء، ويتحقق من بقاء المسودة والرسائل السابقة للمحاولة مجددًا.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
اختبر الاستمرار والفشل
اجعل الدور الثاني جزءًا من اختبار الإكمال.
اسأل مثال DNS، ثم سؤال متابعة يشير إليه. افحص متن الطلب في أدوات المتصفح وقارن الإجابة بالسؤال الأخير الفعلي. الاستجابة الطويلة السلسة ليست دليل صلة.
جرّب رمز وصول خاطئًا للإرسال التالي. تبقى المسودة في حقل النص ولا تُضاف جولة فاشلة إلى السجل المقبول. بعد تصحيح الوصول، أعد المحاولة. يرسل Enter؛ وينشئ Shift+Enter سطرًا جديدًا. يُعطّل الزر أثناء الانتظار.
مثال محلول
تؤدي المهلة أو استجابة المزوّد غير المكتملة إلى فشل ظاهر. لا يضيف المتصفح رسالة assistant فارغة ويتظاهر بأن المحادثة استمرت.
Extra implementation exercise
إجابتك الأولى جيدة لكن الطلب الثاني يفشل. ماذا ينبغي أن يحدث للرسالة المكتوبة والسجل؟
عرض حل نموذجي مشروح
احتفظ بالمسودة والأدوار السابقة المقبولة. أظهر الفشل بصدق، وأعد عناصر الإرسال للعمل، ولا تضف الزوج الجديد إلا بعد وصول إجابة صحيحة.
- تحافظ على المسودة لإعادة المحاولة.
- لا تسجل رد مساعد مختلقًا.
خطأ شائع
اختبار «hello» فقط وإعلان عمل المحادثة كلها.
الخطوة 4
سلّم سلوك المحادثة
استخدم عدة تبادلات بدل إجابة جذابة واحدة.
أكمل اختبارًا من ثلاثة تبادلات حول موضوعك الوهمي واحتفظ بسجل أزلت منه المعلومات الحساسة. كرّر التعافي من فشل الإرسال بعد أي إصلاح.
تحقق من أن إعادة المحاولة لا تفقد المسودة أو تكرر تبادلًا ناجحًا. سجل الاختبارات غير المتاحة بأنها لم تُنفذ. لا يسترجع هذا المثال ملاحظات موثوقة من الموقع ولا يضمن صحة الأجوبة؛ ويضيف درس chatbot المعتمد على المحتوى التالي مهمة بمصادر مرفقة والتحقق منها.
مثال عملي
ينبغي أن يوضح دليلك ما سأله الزائر وما جاءه وكيف استعاد المسار عمله بعد طلب فاشل.
جرّب بنفسك
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
قدّم سجل المحادثة وملاحظة فشل الطلب وإعادة المحاولة الفعلية.
ما المطلوب إنجازه سجل محادثة متعدد الأدوار قصير ونتيجة فعلية للفشل وإعادة المحاولة، بعد إزالة الأسرار.
عرض حل نموذجي مشروح
مثال مخطط ثلاثة تبادلات: «1. اشرح خادم الموقع. 2. بسّط ذلك الجواب. 3. أعط مثالًا واحدًا لمساعدة الخادم لهذا الموقع». يتضمن السجل المكتمل الردود الفعلية بجوار الأسئلة كي يمكن تقييم العلاقة بينها.
مثال ملاحظة تعافٍ: «احتفظ إرسال رُفض عمدًا بمسودته؛ وأضافت إعادة المحاولة تبادلًا ناجحًا واحدًا، لا اثنين». قبل الاستخدام العام، ما زال المثال المقصور على المالك يحتاج إلى مصادقة وضوابط استخدام مستديمة ومراقبة التكلفة؛ وليس نظام إجابات يستند إلى مصادر.
- يتضمن ثلاثة تبادلات مترابطة وسياقًا كافيًا لتقييم الأجوبة.
- يسجل التعافي من فشل الإرسال دون ضياع مسودة أو تكرار تبادل ناجح.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
مهمتك: اجعل المعلّم جديرًا بمتابعة الحوار
قيّم الصلة بدل عد الطلبات الناجحة فقط.
غيّر تعليمات الخادم إلى معلّم HTML/CSS موجز. أجرِ ثلاث جولات: اسأل عن مرساة معطلة، واقترح زوج href/id غير صحيح، واسأل لماذا يفشل. استخدم شيفرة مصطنعة، لا مصدرًا خاصًا.
احتفظ بنص محادثة محجوب البيانات الحساسة وعلّق على ما إذا كانت الإجابة تعالج كل رسالة أخيرة. كرر إرسالًا فاشلًا وأثبت أن إعادة المحاولة تُبقي المحادثة متماسكة. قبل الوصول العام، خطط لمصادقة فعلية وحصص دائمة لكل مستخدم وشرح لوجهة إرسال الرسائل.
مثال محلول
يسمي المعلّم المفيد قيم href/id غير المتطابقة. نصائح عامة عن تسمية المتغيرات تفوّت إجابة المتعلّم المحددة، حتى إن كانت صحيحة تقنيًا.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
Extra implementation exercise
أنجز نص محادثة لثلاث جولات وملاحظة فشل وإعادة محاولة واحدة.
عرض حل نموذجي مشروح
عدّل نص التعليمات في دالة الخادم إلى معلّم HTML/CSS موجز. لا تغيّر متغير واجهة أمامية أو تنقل generate إلى المجلد العام. الدالة المرجعية نسخة كاملة بالتعليمات المعدّلة.
تقييم نموذجي: يسأل المستخدم لماذا لا تصل <a href='#work'> إلى <section id='projects'>. تسمي الاستجابة ذات الصلة عدم تطابق href/id هذا. يقترح المستخدم بعد ذلك href='#projects'؛ فتفحص متابعة ذات صلة هذا التصحيح تحديدًا. تفشل نصائح عامة لتسمية المتغيرات في هذا الاختبار حتى لو كانت حالة HTTP هي 200.
أرسل برمز تدريب خاطئ في دور لاحق. يجب أن تبقى المحادثة المقبولة سليمة وأن يحتفظ حقل النص بالمسودة غير المرسلة. صحح الوصول وأعد المحاولة؛ لا تضف زوج user/assistant جديدًا إلا بعد رد صحيح. نص المحادثة النموذجي هذا دليل تقييم، وليس ادعاء بنتيجة مولدة فعلية.
- تستجيب المتابعات للرسائل السابقة الفعلية.
- يحافظ الفشل على المسودة والسجل، ويظل مفتاح المزوّد خاصًا.
خطأ شائع
تقييم تكامل ذكاء اصطناعي بنجاح HTTP وحده.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تتيح للناس تسجيل الدخول إلى موقعك
- كيف تُبقي صفحة خاصة
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تتيح للمستخدمين رفع الصور
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تجعل روبوت محادثة يجيب من محتواك الخاص
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تعاين تغييرات موقعك قبل النشر
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها
- كيف تجد الأخطاء في موقعك المنشور وتصلحها