1. قبل البدء
لقد تطوّرت عملية تطوير البرامج. لا يقتصر عمل المطوّرين الأكثر نجاحًا على كتابة الرموز البرمجية، بل ينسّقون أيضًا بين أدوات الذكاء الاصطناعي ووكلاء الذكاء الاصطناعي لإنشاء تطبيقات أفضل وأسرع. توفّر منظومة أدوات Google حزمة شاملة لجميع مراحل النشاط: إنشاء واجهة المستخدم، وإنشاء النماذج الأولية للتطبيقات وتفعيلها، وتطوير الميزات التي تستخدم الذكاء الاصطناعي، والدمج الآمن والقابل للتوسّع في الخلفية. في هذا الدرس التطبيقي حول الترميز، ستستخدم Google Stitch لتصميم واجهة المستخدم، وGoogle AI Studio لإنشاء الرموز البرمجية ونشر التطبيق، وFirebase لتطوير ميزات تستخدم الذكاء الاصطناعي وتخزين المعلومات في خلفية آمنة وقابلة للتوسّع.
التطبيق الذي ستنشئه في هذا الدرس التطبيقي حول الترميز يُسمى Decide For Me، وهو مساعد في اتخاذ القرارات للأشخاص المترددين الذين يواجهون خيارات مصيرية (مثل الانتقال إلى شقة جديدة أو تغيير المهنة أو اختيار هواية). يُدخل المستخدم معضلة وأولوياته في الحياة، ويستخدم التطبيق الذكاء الاصطناعي لمساعدة المستخدم في اتخاذ القرار بناءً على ما يقلل من خيبة الأمل على المدى الطويل. يمنح التطبيق أيضًا المستخدم خطوة أولى ملموسة. يجب أن يكون الإصدار النهائي من تطبيقك مشابهًا لما يلي:

أهداف الدورة التعليمية
- تصميم واجهات المستخدم باستخدام Google Stitch
- يمكنك إنشاء تطبيق ويب بالبرمجة الوصفية باستخدام Google AI Studio.
- استخدِم Firebase لتطوير ميزات تستخدم الذكاء الاصطناعي وتخزين المعلومات في السحابة الإلكترونية.
- نشر تطبيق ويب في مرحلة الإنتاج باستخدام Google AI Studio (المستنِد إلى Cloud Run)
2. تصميم واجهة المستخدم باستخدام Stitch
- نزِّل صورة النموذج التجريبي (
DecideForMeScreen.jpeg) واحفظها في مجلد على جهازك يمكنك العثور عليها فيه. - انتقِل إلى Stitch، وابحث عن حقل الإدخال، ثم حدِّد الخيار الويب. (في هذا الدرس التطبيقي حول الترميز، سنركّز على تجربة الويب، ولكن يمكنك أيضًا استخدام Stitch لإنشاء شاشات للأجهزة الجوّالة).
- حمِّل صورة النموذج التجريبي:
- انقر على + (زر الإضافة).
- انقر على تحميل ملفات.
- أرفِق الصورة التي نزّلتها في خطوة الإعداد (
DecideForMeScreen.jpeg). يتيح لك هذا النموذج المرسوم يدويًا اختبار إمكانات Stitch المتعددة الوسائط.
- انسخ الطلب التالي والصقه في حقل الإدخال:
# General Guidance Create a modern, clean, and highly polished UI for a web application called "Decide For Me" - a hyper-rational decision assistant. CRITICAL: Replicate the exact layout, structure, and element placement shown in the hand-drawn mockup file DecideForMeScreen.jpeg. Do not add any extra menus, sidebars, buttons, or top/bottom navigation bars that are not explicitly drawn in the file. Stick strictly to the skeleton provided in the mockup. # Layout & Structure - Two-Column Split Screen: - Left Side (Main Chat Area): Takes up roughly 70-75% of the screen width. It should feel like a premium, focused workspace. - Right Side (Configuration Panel): A sidebar taking up 25-30% of the screen width with a distinct, subtle background color to separate it from the chat. # Right Panel: Configuration Screen - Header: Title it "My Priorities" with a clean, minimalist typography. - Content Card: A styled card containing a text box or paragraph area showcasing the user's priorities. - Interactions: Include a clear "Edit Priorities" button. When clicked, this area should visually toggle into an editable textarea or input field. # Left Panel: Chat & Dilemma Decision Screen - Chat History: A clean vertical flow of message bubbles. - The first message bubble must be aligned to the left (system message) and say: "Tell me your dilemma". Use a friendly, neutral background color for this bubble. - Bottom Input Area: Instead of a traditional single-line chat bar, create a unified, beautiful "Decision Submission" layout positioned at the bottom: - Dual Input Fields: Place two horizontal or cleanly stacked input fields. - Input 1 label: "Option A" - Input 2 label: "Option B" - Action Button: A prominent, styled "Go" action button to trigger the reasoning loop. # Theme & Aesthetic - Vibe: Hyper-rational, clean, trustworthy, and modern. Use a sophisticated color palette (e.g., deep slates, clean whites/grays, and a sharp accent color like a subtle indigo or teal for active states and buttons). - Spacing & Typography: Use generous whitespace, soft rounded corners (border-radius) for cards and buttons, and a highly legible sans-serif font. - انقر على سهم الإنشاء في أسفل يسار حقل الإدخال. تُنشئ Stitch الشاشة ونظام تصميم كامل، بما في ذلك تشكيلة الألوان وخيارات الخطوط والأيقونات والمظهر العام لعناصر في واجهة المستخدم:

3- إنشاء التطبيق باستخدام Google AI Studio
- أنشئ مشروع Firebase:
- سجِّل الدخول إلى وحدة تحكُّم Firebase باستخدام حساب Google نفسه الذي استخدمته في Stitch.
- انقر على الزر لإنشاء مشروع جديد، ثم أدخِل اسم المشروع (على سبيل المثال،
Decider App).
- انقر على متابعة.
- راجِع بنود Firebase واقبلها إذا طُلب منك ذلك، ثم انقر على متابعة.
- (اختياري) فعِّل ميزة "المساعدة بالذكاء الاصطناعي" في وحدة تحكّم Firebase (المعروفة باسم "Gemini في Firebase").
- في هذا الدرس التطبيقي حول الترميز، لا تحتاج إلى "إحصاءات Google"، لذا أوقِف خيار "إحصاءات Google".
- انقر على إنشاء مشروع، وانتظِر حتى يتم توفير مشروعك، ثم انقر على متابعة.
- تصدير الشاشة التي أنشأتها في Stitch إلى Google AI Studio:
- انقر على التصميم الذي تم إنشاؤه في Stitch.
- انقر على تصدير في أعلى يسار الشاشة.
- تأكَّد من أنّ الخيار المحدّد هو Google AI Studio.
- انتقِل للأسفل إلى حقل الوصف.
- انسخ الطلب التالي والصقه في حقل الوصف. استبدِل [FIREBASE_PROJECT_ID] برقم تعريف المشروع الفعلي من الخطوة 1 (إذا لم تتذكّر رقم تعريف مشروعك، يمكنك العثور عليه في "إعدادات المشروع"):
# General Guidance Build the "Decide For Me" app: A hyper-rational decision assistant for chronically indecisive people facing life choices (moving apartments, changing careers, picking a hobby). The user enters a dilemma and their top priorities in life. The app will help with the decision. Follow the instructions below to build it: # UI Instructions Using the design artifacts exported from Stitch (the PNG image and HTML file), build a fully functional web application that accurately mirrors the design and layout. # App Architecture & Initialization Instructions - Initialize the latest Firebase JS SDK for client-side services. Use the Firebase project with ID [FIREBASE_PROJECT_ID]. - Enable Firebase Authentication in this project using the Google provider. If a user is not logged in, show a clean, minimalist sign-in state. If the user is logged in, take them directly to the dilemma decision screen. - Initialize Firebase App Check in debug mode with the following code: `self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;` `initializeAppCheck(app, { /* App Check options */ });` # State & Database Management Instructions - User Priorities: - Once authenticated, pull the user's saved priorities from Firebase Firestore at the path: `users/{userId}`. Each document should contain one string field: 'priorities'. - Bind this data to the Right Panel ("My Priorities"). - When the user clicks the "Edit" button, toggle the view to a textarea, with a 'save' button. When saved, write the updated string back to `users/{userId}`. - Make sure to implement and deploy strong Security Rules for Firestore. # UI Stream Update & Display Instructions - Once the user submits option A and option B in the dilemma decision screen, display both options as a single message on the user side of the chat. Then, display a sleek loading state in the main chat panel. Leave the app in this "loading" state and do nothing else, we will process both options and build the server-side thinking later. - انقر على الإنشاء باستخدام Google AI Studio. سيؤدي ذلك إلى فتح Google AI Studio في علامة تبويب جديدة ونقل ملفات التصميم والطلب:
- تأكَّد من نقل الطلب بالكامل.
- إذا ظهر لك جزء فقط من الطلب، الصِق الطلب بالكامل مرة أخرى.
- انقر على إنشاء. يبدأ Google AI Studio في إنشاء تطبيق Decide For Me وفقًا لطلبك وتصميم واجهة المستخدم:
- أثناء إنشاء الواجهة، يقترح Gemini تصميمات بديلة لواجهة المستخدم (تجاهَل هذه التصميمات في هذا الدرس التطبيقي حول الترميز، ولكن يمكنك اختيار تصميمات مختلفة في المستقبل).
- عندما يُطلب منك تفعيل Firebase، انقر على تفعيل.
- افحص التطبيق الذي تم إنشاؤه وتحقَّق منه:
- اختبِر التطبيق في علامة التبويب معاينة.
- انتقِل إلى علامة التبويب الرمز لمراجعة جميع الملفات والرموز التي تم إنشاؤها.
- أنشأ Google AI Studio أيضًا مشروعًا على Firebase، وفعّل مصادقة Firebase وFirestore، وضبط إعدادات Firebase في قاعدة الرموز البرمجية. ستتمكّن من الوصول إلى مشروع Firebase هذا والعمل عليه في الخطوة التالية من هذا الدرس التطبيقي حول الترميز.
4. تسجيل الرمز المميّز لتصحيح الأخطاء في ميزة "فحص التطبيقات"
عندما ينشئ Google AI Studio التطبيق، يتم إنشاء مشروع Firebase وربط تطبيقك به. يجب الوصول إلى مشروع Firebase هذا وتسجيل بيئة التطوير من خلال خدمة أمان مهمة تُسمى "فحص التطبيقات من Firebase".
الوصول إلى مشروع Firebase
- ابحث عن رقم تعريف مشروع Firebase الذي أنشأه Google AI Studio:
- انتقِل إلى علامة التبويب الرمز البرمجي في Google AI Studio.
- افتح ملف
firebase-applet-config.json. - انسخ قيمة الحقل
projectId.
- انتقِل إلى وحدة تحكُّم Firebase وابحث عن المشروع باستخدام هذا المعرّف.
تسجيل الرمز المميّز لتصحيح الأخطاء
يمكن لتطبيقك استخدام ميزة فحص التطبيقات من Firebase لحماية خدمات الخلفية ونماذج الذكاء الاصطناعي من إساءة الاستخدام من خلال التأكّد من أنّ الزيارات الواردة تأتي فقط من تطبيقات شرعية.
بما أنّ تطبيقك يعمل في بيئة النسخة الحصرية من Google AI Studio، فإنّه يستخدم مقدّم خدمة تصحيح الأخطاء في ميزة "فحص التطبيقات" (self.FIREBASE_APPCHECK_DEBUG_TOKEN = true). وعند تحميل تطبيق الويب، يُخرج Firebase تلقائيًا رمز تصحيح أخطاء إلى وحدة تحكّم المطوّرين في المتصفّح.
- للعثور على الرمز المميّز لتصحيح الأخطاء، اتّبِع الخطوات التالية:
- في Google AI Studio، افتح أدوات المطوّرين في المتصفّح أثناء عرض معاينة تطبيقك:
- Chrome أو Edge أو Firefox: اضغط على F12 (أو انقر بزر الماوس الأيمن في أي مكان في المعاينة واختَر فحص)، ثم اختَر علامة التبويب وحدة التحكّم.
- نظام التشغيل macOS: اضغط على Cmd+Option+I، ثم اختَر علامة التبويب وحدة التحكّم.
- في سجلّات وحدة التحكّم، ابحث عن رسالة تصحيح الأخطاء في ميزة "فحص التطبيقات":
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work. - انسخ سلسلة الرموز المميّزة (بدون علامات الاقتباس).
- في Google AI Studio، افتح أدوات المطوّرين في المتصفّح أثناء عرض معاينة تطبيقك:
- تسجيل الرمز المميّز لتصحيح الأخطاء:
- في وحدة تحكُّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.
- ابحث عن تطبيق الويب في القائمة، وانقر على قائمة الخيارات الإضافية (⋮)، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.
- انقر على إضافة رمز تصحيح الأخطاء، والصِق الرمز الذي نسخته، وأدخِل اسمًا مثل
Google AI Studio Preview، ثم انقر على حفظ.

5- اختبار التطبيق
بعد ربط مشروعك وتسجيل الرمز المميّز لتصحيح الأخطاء في ميزة "فحص التطبيقات"، اختبِر الميزات الأساسية: "المصادقة" وFirestore.
- اختبِر مصادقة المستخدم واحفظ الأولويات:
- في معاينة تطبيق Decide For Me في Google AI Studio، اختبِر شاشة المصادقة من خلال تسجيل الدخول باستخدام حساب Google.
- احفظ أولوياتك في الحياة باستخدام اللوحة اليمنى (أولوياتي).
- التحقّق من المصادقة في وحدة تحكُّم Firebase:
- انتقِل إلى وحدة تحكُّم Firebase وافتح المصادقة.
- تأكَّد من أنّ حساب Google الذي استخدمته للمصادقة في تطبيق Decide For Me مدرَج هناك:

- التحقّق من مساحة تخزين بيانات Firestore:
- افتح Firestore في وحدة تحكُّم Firebase.
- تأكَّد من تخزين أولوياتك في مستند ضمن المسار
users/{userId}:

6. إنشاء مسار Decider مستنِد إلى الذكاء الاصطناعي باستخدام Firebase
سيستخدم تطبيقك الذكاء الاصطناعي لتنفيذ إجراءات اتخاذ القرار نيابةً عني. يمكنك استخدام Firebase لإنشاء مسار Decider المستنِد إلى الذكاء الاصطناعي.
إعداد Firebase AI Logic
- فعِّل Gemini Developer API في Firebase AI Logic:
- افتح Firebase AI Logic في وحدة تحكّم Firebase، ثم انقر على البدء.
- اختَر Gemini Developer API واتّبِع التعليمات في وحدة التحكّم لتفعيل واجهة برمجة التطبيقات.
- اضبط إعدادات Firebase AI Logic:
- انتقِل إلى علامة التبويب الإعدادات.
- فعِّل خيار فرض وضع النماذج فقط على مفروض.
- فعِّل خيار فرض وضع المستخدمين الذين تمت مصادقتهم على مفروض.
إنشاء نموذج طلب من الخادم
في هذا الدرس التطبيقي حول الترميز، ستستخدم نماذج الطلبات من الخادم لتفاعلاتك مع Gemini API من خلال Firebase AI Logic.
قبل المتابعة في استخدام النموذج، راجِع ما يلي لفهم أهمية تخزين إعدادات النموذج وتعليمات النظام والطلبات من جهة الخادم:
- حماية الملكية الفكرية: يتم سحب الطلبات من جهاز العميل والحفاظ على أمانها في الخلفية.
- منع هجمات حقن الطلبات: يمكن للعميل ملء متغيّرات محدّدة فقط باستخدام عملية التحقّق من صحة المخطّط في الخلفية.
- التعديل بدون إصدارات جديدة من التطبيق: يمكنك تعديل الطلبات وتعليمات النظام وإعدادات النماذج في وحدة التحكّم بدون إصدار نسخة جديدة من التطبيق.
في ما يلي كيفية إنشاء نموذج طلب خادم واختباره:
- أنشئ نموذج الطلب من الخادم:
- انتقِل إلى علامة التبويب نماذج الطلبات.
- انقر على إنشاء نموذج.
- انقر على نموذج فارغ.
- أنشِئ نموذجك الأول باستخدام المعلومات التالية:
- اسم النموذج: Decider Flow
- رقم تعريف النموذج:
decider-flow - الإعدادات (frontmatter)
model: "gemini-3.5-flash-lite" input: schema: priorities: "string, user's core priorities" optionA: "string, option A under consideration" optionB: "string, option B under consideration" output: format: json schema: verdict: string justification: string firstStep: string - الطلب وتعليمات النظام (اختياري)
يُرجى إضافة{role "system"} You are the Decider Agent, a multi-stage reasoning engine that combines the roles of an honest and polite behavioral economist, a long-term strategic forecaster, and an executive decision coach. Your job is to take a user's dilemma and their core priorities, run them through a rigorous, adversarial 3-phase thinking process, and output a highly analytical, reasoning-backed final verdict. You must be direct, sharp, and realistic. Do not give generic platitudes or claim that "both options are great." You must force a clear choice. {role "user"} # Context & Inputs You are analyzing a critical life decision for the user. Base your entire multi-phase reasoning flow strictly on these three specific inputs: - User's Core Priorities: {{priorities}} - Option A under consideration: {{optionA}} - Option B under consideration: {{optionB}} Execute your reasoning flow through the following three phases: # Phase 1: Cynical Breakdown (Input-Driven Analysis) Analyze {{optionA}} and {{optionB}} strictly through the lens of the user's explicit {{priorities}}. Do not evaluate them in a vacuum. - Identify the hidden flaws, compromises, and psychological costs embedded in both choices. - Pinpoint exactly how {{optionA}} could directly conflict with or undermine their {{priorities}}. - Pinpoint exactly how {{optionB}} could directly conflict with or undermine their {{priorities}}. - Uncover any cognitive biases (like status quo bias or loss aversion) the user might be falling for in either option. # Phase 2: Long-Term Regret Projection Project the user 5 years into the future. Apply the Regret Minimization Framework to both paths: - The {{optionA}} Timeline: Quantify the absolute worst-case, deep, structural 5-year regret of choosing this path. Focus heavily on failures of courage vs. failures of action based on their {{priorities}}. - The {{optionB}} Timeline: Quantify the matching 5-year regret for this path. - Contrast these two timelines. Which option carries the kind of regret that fundamentally breaks the user's {{priorities}}? # Phase 3: Final Recommendation & Action Step Synthesize the cynical critiques and long-term regret scores. Weigh them against the user's {{priorities}} to determine which choice minimizes long-term disappointment. - Verdict: You must declare either {{optionA}} or {{optionB}} as the definitive winner. No compromise, no "it depends," and no hybrid options. - Justification: Provide a sharp, reasoning-backed explanation showing why the losing option was eliminated based on the Phase 1 and Phase 2 analysis. - First Step: Give one microscopic, low-friction task the user can execute within the next 15 minutes to commit to or move toward the chosen verdict.{}إضافية حول{role "system"}و{role "user"}لكتابة تعليمات النظام والطلب بالصيغة الصحيحة:
- إدخال الاختبار
{ "priorities": "Be financially stable, have a good work-life balance where I can travel twice a year", "optionA": "Buy a house for 615000 British pounds with a mortgage of 2800 per month for the next 35 years", "optionB": "Keep renting for 2400 per month for the foreseeable" }
- انقر على حفظ النموذج.
- اختبِر النموذج:
- انقر على إجراء اختبار الطلب.
- ابحث عن ردّ الاختبار وتأكَّد من أنّه يحتوي على جميع الحقول التي حدّدتها في الطلب (
verdictوjustificationوfirstStep). - إذا كان كل شيء يتطابق مع الردّ المتوقّع، يمكنك قفل النموذج باستخدام رمز القفل في أعلى يسار النموذج لضمان ثبات الإصدار ومنع التعديلات غير المقصودة.
أصبح النموذج جاهزًا للاستخدام في تطبيقك.
7. استخدام نموذج طلب Decider في التطبيق
اجعل تطبيق الويب يستخدم النموذج:
- ارجع إلى تطبيقك في Google AI Studio.
- اطلب من وكيل Google AI Studio تنفيذ إجراء اتخاذ القرار نيابةً عني:
- انسخ الطلب التالي:
Now let's implement the "Decide For Me" button action. When clicked, it should call the Firebase AI Logic SDK using a Template Generative Model. The prompt is stored in a prompt template with the id "decider-flow". When calling the API, pass the following variables as the input payload object: - priorities - optionA - optionB The API will return a JSON object. Handle the response asynchronously and extract: - verdict - justification - firstStep Once the data is received, update the UI state to append a new message to the chat array. Ensure it renders as a system chat bubble positioned on the left side of the chat screen, mapping these three fields clearly into the bubble's layout. Please provide the necessary front-end component state updates and the Firebase SDK call. - ألصِق الطلب في حقل إدخال المحادثة في Google AI Studio وانقر على إرسال.
- انسخ الطلب التالي:
- التحقّق من الإعدادات واختبار مساعد اتخاذ القرار:
- انتظِر إلى أن ينتهي Google AI Studio من إضافة Firebase AI Logic إلى تطبيقك.
- انتقِل إلى علامة التبويب الرمز وتأكَّد من توفّر مفتاح واجهة برمجة التطبيقات في ملف
firebase-applet-config.json. إذا لم يكن مفتاح واجهة برمجة التطبيقات Firebase في ملف الإعداد، اطلب من Google AI Studio استيراده. - انتقِل إلى علامة التبويب معاينة
- أرسِل الخيارَين "أ" و"ب"، وتأكَّد من أنّ الذكاء الاصطناعي يعرض القرار والتبرير والخطوة الأولى.
كمرجع، من المفترض أن يبدو الرمز الذي أنشأه Google AI Studio مشابهًا لما يلي:
const aiInstance = getAI(app);
const templateModel = getTemplateGenerativeModel(aiInstance);
const result = await templateModel.generateContent('decider-flow', {
priorities: priorities,
optionA: optA,
optionB: optB
});
const rawText = result.response.text();
// Parse response text to extract fields
const cleaned = rawText.replace(/```json|```/g, '').trim();
const parsedData: { verdict?: string; justification?: string; firstStep?: string } = JSON.parse(cleaned);
const verdict = parsedData.verdict;
const justification = parsedData.justification;
const firstStep = parsedData.firstStep;
تصحيح أخطاء الطلبات ومراقبتها
إذا واجه تطبيقك أخطاءً أو تعذّر عليه إنشاء ردّ أو أردت فحص عدد زيارات واجهة برمجة التطبيقات بالتفصيل، استخدِم أدوات الإحصاءات والمراقبة المضمّنة في Firebase AI Logic:
- في وحدة تحكُّم Firebase، انتقِل إلى خدمات الذكاء الاصطناعي > AI Logic > علامة التبويب تتبّع استخدام الذكاء الاصطناعي.
- اطّلِع على المقاييس الكمية في لوحة البيانات:
- حجم الطلبات وحالتها: تحقَّق مما إذا كانت الطلبات الواردة تصل إلى الخلفية وتعرض الرمز
200 OKأو يتعذّر تنفيذها بسبب أخطاء في العميل أو الخادم. - وقت الاستجابة: يمكنك فحص الرسم البياني لوقت الاستجابة من أجل التحقّق من وقت الاستجابة من البداية إلى النهاية.
- عدد الرموز المميّزة: يمكنك مراقبة استخدام الرموز المميّزة في الطلبات والردود لكل طلب.
- حجم الطلبات وحالتها: تحقَّق مما إذا كانت الطلبات الواردة تصل إلى الخلفية وتعرض الرمز
- فحص آثار الطلبات الفردية لتصحيح الأخطاء بشكل مفصّل:انقر على أثر طلب معيّن في جدول الآثار لفحص حمولته.
- المدخلات: تأكَّد من أنّه تم تمرير المتغيّرات (
prioritiesوoptionAوoptionB) بشكل صحيح من تطبيق العميل. - النتائج: يمكنك الاطّلاع على النص الأوّلي الذي أنشأه النموذج للتحقّق مما إذا كان قد عرض ملف JSON صالحًا يتطابق مع المخطّط.
- تفاصيل الخطأ: إذا تعذّر تنفيذ طلب، راجِع سجلّ أخطاء التتبُّع لمعرفة الأسباب، مثل رموز فحص التطبيقات المميّزة غير الصالحة أو رفض المصادقة أو حدود الحصة أو أخطاء التحقّق من الطلبات.
- المدخلات: تأكَّد من أنّه تم تمرير المتغيّرات (
- تحديد المشاكل في Google AI Studio وحلّها:
- إذا رصدت خطأ في التتبُّع (على سبيل المثال، تحليل استجابة JSON غير صحيح أو مَعلمات غير متوفّرة)، انسخ رسالة الخطأ أو الحمولة.
- ارجع إلى Google AI Studio واطلب من المساعد إصلاح المشكلة في رمز التطبيق.
8. اختياري: نشر التطبيق
بعد أن يعمل تطبيقك في وضع المعاينة، انشره في قناة الإصدار العلني.
لحماية نقاط نهاية Firebase في مرحلة الإنتاج، عليك ضبط مقدّم خدمة مصادقة في مرحلة الإنتاج لاستخدامه مع ميزة فحص التطبيقات من Firebase (في هذا الدرس التطبيقي حول الترميز، ستستخدم الإصدار الثالث من خدمة reCAPTCHA).
يجب نشر تطبيقك أولاً للحصول على عنوان URL المنشور الدقيق الخاص به لتتمكّن من تسجيل النطاق المحدّد باستخدام reCAPTCHA بدلاً من السماح لجميع تطبيقات "ai.studio".
انشر تطبيقك واضبط إعدادات reCAPTCHA:
- نشر تطبيق الويب باستخدام Google AI Studio:
- في Google AI Studio، انقر على نشر في شريط التنقّل العلوي.
- انقر على البدء، وراجِع اسم التطبيق ووصفه أو خصِّصهما، ثم انقر على نشر التطبيق.
- انتظِر حتى ينتهي Google AI Studio من إنشاء تطبيقك ونشره (يستغرق ذلك عادةً من دقيقة إلى دقيقتين).
- انسخ عنوان URL المخصّص للبث المباشر الذي تم إنشاؤه (على سبيل المثال،
https://decide-for-me-123.ai.studio) وسجِّل نطاقه (على سبيل المثال،decide-for-me-123.ai.studio).
- إنشاء مفاتيح الإصدار الثالث من خدمة reCAPTCHA في Google reCAPTCHA:
- انتقِل إلى وحدة تحكّم المشرف في Google reCAPTCHA.
- أدخِل تصنيفًا (على سبيل المثال،
Decide For Me - Production). - اختَر نوع reCAPTCHA > الإصدار الثالث من خدمة reCAPTCHA (المستند إلى النتيجة).
- في قسم النطاقات، أضِف النطاق الدقيق الذي تم نشر تطبيقك عليه (على سبيل المثال،
decide-for-me-123.ai.studio، مع حذفhttps://وأي مسارات) أو نطاقًا خاصًا إذا كنت تخطط لاستخدامه. - اقبل بنود الخدمة وانقر على إرسال.
- أبقِ علامة التبويب هذه مفتوحة: ستحتاج إلى كل من مفتاح الموقع الإلكتروني (مفتاح العميل العام) والمفتاح السري (مفتاح الخادم الخاص).
- سجِّل مفتاحك السري في وحدة تحكُّم Firebase:
- انتقِل إلى ميزة فحص التطبيقات في وحدة تحكُّم Firebase.
- انتقِل إلى علامة التبويب التطبيقات.
- ابحث عن تطبيق الويب في القائمة، وانقر عليه (أو انقر على قائمة الخيارات الإضافية ⋮)، ثم اختَر الإصدار الثالث من خدمة reCAPTCHA.
- الصِق مفتاح reCAPTCHA السرّي في الحقل وانقر على حفظ.
- اضبط تطبيق العميل لاستخدام
ReCaptchaV3Provider:- في Google AI Studio، انتقِل إلى لوحة المحادثة واطلب من المساعد تحديث إعدادات فحص التطبيقات لمرحلة الإنتاج:
Please update our Firebase App Check initialization to use ReCaptchaV3Provider with the reCAPTCHA site key "YOUR_RECAPTCHA_SITE_KEY", while retaining support for debug tokens in non-production environments. - إذا كنت تراجع الرمز مباشرةً في علامة التبويب الرمز، تأكَّد من أنّ إعداد ميزة "فحص التطبيقات" يتطابق مع هذه البنية:
import { initializeAppCheck, ReCaptchaV3Provider } from "firebase/app-check"; const appCheck = initializeAppCheck(app, { provider: new ReCaptchaV3Provider("YOUR_RECAPTCHA_SITE_KEY"), isTokenAutoRefreshEnabled: true }); - بعد تعديل الرمز، أعِد نشر تطبيقك في Google AI Studio لإرسال إعدادات "فحص التطبيقات" المعدَّلة إلى موقعك الإلكتروني المنشور.
- في Google AI Studio، انتقِل إلى لوحة المحادثة واطلب من المساعد تحديث إعدادات فحص التطبيقات لمرحلة الإنتاج:
- التحقّق من عدد الزيارات في مرحلة الإنتاج ومراقبة ميزة "فحص التطبيقات":
- افتح عنوان URL الخاص بتطبيقك المنشور في نافذة تصفّح متخفٍ، وسجِّل الدخول باستخدام حساب Google، واختبِر إرسال معضلة.
- ارجع إلى فحص التطبيقات في وحدة تحكُّم Firebase، وافحص علامتَي التبويب واجهات برمجة التطبيقات والمراقبة للتأكّد من تسجيل الطلبات بنجاح في Firestore وFirebase AI Logic.
9. الخاتمة
تهانينا! لقد أنشأت تطبيقًا مفيدًا يتضمّن ميزات تستخدم الذكاء الاصطناعي من الصفر، وذلك باستخدام أدوات في Google Builder Stack. هذه ليست سوى البداية، فهناك الكثير مما يمكنك فعله باستخدام أدوات Google. لديك الآن مشروع على Firebase وGoogle Cloud. يمكنك استكشاف جميع الخدمات المتاحة لك.
انتقِل إلى هذا الرابط للحصول على شارة Completed Builder Journey.
لمواصلة رحلتك، انتقِل إلى goo.gle/builders للانتقال إلى التمرين التالي.
إذا كنت تستخدم حاليًا Antigravity 2.0، وهي منصة Google المخصّصة لتنسيق عمل عدة وكلاء مستقلين بالتوازي، يمكنك تصدير مشروعك بسرعة من Google AI Studio واستيراده إلى Antigravity لمواصلة العمل عليه محليًا. تتوفّر في Antigravity مهارات الوكلاء في Firebase التي يمكن تثبيتها بنقرة واحدة. توفّر هذه المهارات أيضًا دعمًا لتطوير التطبيقات للأجهزة الجوّالة، ما يساعدك في تكرار هذا التطبيق في بيئات Android وiOS إذا أردت ذلك.