طلبات فعّالة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعتمد فعالية مخطط تطبيقك وجودة الرمز البرمجي الذي تم إنشاؤه على وضوح طلباتك وتفاصيلها. عند استخدام App Prototyping agent، يُرجى مراعاة الإرشادات التالية لإنشاء طلبات فعّالة عند إنشاء التطبيقات وتصحيح أخطائها:
- تحديد التفاصيل: عليك تحديد ميزات تطبيقك وتفاعلات المستخدمين ومتطلبات البيانات بوضوح، وطلب تقنيات محدّدة حيثما أمكن ذلك. على سبيل المثال، إذا كنت تحاول إنشاء تطبيق ويب يتضمّن عناصر ثلاثية الأبعاد، يمكنك أن تطلب من Gemini استخدام
three.js.
- طلب معلومات عن مهام إضافية لإعداد الخدمات: يمكن لـ Gemini كتابة الرمز البرمجي لتطبيقك، ولكن لا يمكنه إعداد الخدمات أو تفعيل واجهات برمجة التطبيقات أو توفير الموارد (مثل حزمة Cloud Storage أو حساب Stripe).
احرص على إخبار Gemini بأنّه إذا كتب رمزًا برمجيًا لخدمات معيّنة، عليه أيضًا أن يخبرك بكيفية إعداد هذه الخدمات.
- طلب مشروع على Firebase: إذا طلبت من App Prototyping agent مساعدتك في إعداد خدمات Firebase، سيوفّر لك مشروعًا على Firebase نيابةً عنك. على سبيل المثال، يمكنك أن تطلب "ساعدني في إضافة Firestore" أو "ربط تطبيقي بمنصة Firebase".
- استخدام Gemini لتحسين طلبك: يمكنك استخدام Gemini في
Google أو
الدردشة مع
Gemini في Firebase في
طريقة العرض Code أو غيرها
من مساحات Gemini لتحسين طلبك.
- توفير السياق: أدرِج معلومات أساسية عن الغرض من تطبيقك والجمهور المستهدَف وتجربة المستخدم التي تريد تقديمها.
- استخدام الأمثلة: إذا أمكن، قدِّم أمثلة على كيفية تفاعل المستخدمين مع التطبيق أو البيانات التي يجب عرضها.
- التكرار والتحسين: اتّبِع أسلوبًا تكراريًا في عملية التطوير. ننصحك بالبدء بطلب أساسي، ثم إضافة ميزة واختبارها وتحسينها، ثم إضافة ميزة أخرى.
باتّباع هذه الإرشادات، يمكنك تحسين جودة وملاءمة مخططات التطبيقات التي تنشئها أداة Firebase Studio بشكل كبير، بالإضافة إلى تحسين فرص نجاحها عند تصحيح أخطاء تطبيقك.
استخدام طلبات إضافية لتحسين الردود
إذا لم تكن النتائج الأولية على النحو المتوقّع، يمكنك تحسين طلباتك من خلال إضافة المزيد من التفاصيل أو تقديم تعليمات محدّدة:
- إضافة قيود: حدِّد القيود المفروضة على واجهة المستخدِم أو نموذج البيانات أو الميزات.
- تقديم أمثلة: قدِّم أمثلة على كيفية تفاعل المستخدمين مع التطبيق والبيانات التي يجب أن تظهر.
- استخدام الكلمات الرئيسية: استخدِم كلمات رئيسية لوصف الميزات أو الإمكانات التي تريد أن يربطها النموذج اللغوي الكبير بفئة النتائج التي تريدها. على سبيل المثال، يمكنك استخدام Material Design في طلب توضّح فيه أنّك تريد أن يلتزم تطبيقك بمعايير التصميم في Google.
- طلب إجراء تغييرات محدّدة: يمكنك طلب إجراء تغييرات محدّدة على الرمز أو التصميم الذي تم إنشاؤه. أضِف كل طلب ميزة في طلب منفصل.
- طلب التفكير من النموذج: إذا كنت تواجه مشكلة في الحصول على النتائج التي تريدها، جرِّب أن تطلب من النموذج التفكير في الطلب. على سبيل المثال، يمكنك قول "فكِّر خطوة بخطوة. أريد إنشاء مربّع إدخال لتطبيق المهام الخاص بي. يجب أن يحتوي على زر "إضافة مهمة" وزر "إلغاء".
باستخدام هذه الأساليب، يمكنك تحسين طلباتك بشكل متكرّر للحصول على النتائج التي تريدها.
أمثلة على طلبات فعّالة لمخططات التطبيقات
في ما يلي بعض الأمثلة على الطلبات الفعّالة لأنواع مختلفة من التطبيقات:
أداة بسيطة لتتبُّع المهام:
Create a simple web app that displays a list of to-do items.
Users should be able to add new items to the list and mark items as complete.
Provide a way to delete items and export the list as a text file.
Use a clean and modern UI using Google Material Design principles.
تطبيق تحديد الميزانية:
A budgeting and expense tracking app with spending categories, charts, and
budget goals. Include a clean dashboard with key insights. It should include
spending categories, charts, and budget goals. The app should allow users to
manually add expenses or upload csv files. The app should also allow users to
upload receipts, then use AI to convert the receipt into an expense entry that
users can edit. Data should be stored in browser cache, with download and
delete options.
طلب تطبيق ألعاب بمساعدة Gemini (Markdown):
Generate a delightful sliding number puzzle game (15-puzzle) with Javascript,
HTML, and CSS.
- **Setup:** Create a 4x4 grid with numbers 1-15 and one empty space. Use a
**solvable shuffling algorithm** to randomize the start.
- **Gameplay:** Allow clicking tiles **adjacent to the empty space** to slide
them. Count and display the number of moves.
- **Timer:** Include a **countdown timer** starting at **120 seconds**
(2 minutes).
- **End Conditions:**
- If solved (numbers 1-15 in order): Alert with an encouraging winning
statement generated by AI.
- If timer reaches 0: Alert with a funny retort generated by AI.
نصائح لتصحيح الأخطاء
يمكنك استخدام "Gemini في Firebase" للمساعدة في تصحيح الأخطاء في الرمز البرمجي من خلال
المحادثة في مساحة عمل Code
أو App Prototyping agent.
مع أنّ Gemini يمكنه كتابة الرمز البرمجي نيابةً عنك، قد يرتكب أحيانًا أخطاء. وعند رصد خطأ، سيحاول تصحيحه. إذا تبيّن لك أنّها لا تستطيع حل المشكلة المحدّدة في رسالة الخطأ، يمكنك تجربة بعض الأساليب التالية:
وصف المشكلة: في واجهة المحادثة، قدِّم وصفًا واضحًا وموجزًا قدر الإمكان للمشكلة التي تواجهها.
مع أنّ Gemini قد يتمكّن من الوصول إلى سياق مثل رسائل الخطأ والسجلات، قد لا يفهم السياق الكامل. يمكن أن يساعد وصف السلوك
إلى جانب رسالة الخطأ فريق Gemini في حل الأخطاء
بشكل أسرع.
طرح أسئلة محدّدة: لا تتردد في طرح Gemini
أسئلة مباشرة حول الرمز البرمجي. على سبيل المثال، "ما هي الأسباب المحتملة لحدوث خطأ
null pointer exception في هذه الدالة؟" أو "كيف يمكنني منع
هذه الحالة المتسارعة؟"
تقسيم المشاكل المعقّدة: إذا كنت تواجه مشكلة معقّدة، قسِّمها إلى أجزاء أصغر يسهل التعامل معها. اطلب من
Gemini مساعدتك في تصحيح الأخطاء في كل جزء على حدة، وفكِّر في المشاكل خطوة بخطوة.
استخدام حواجز الرموز: عند مشاركة مقتطفات الرموز، استخدِم حواجز الرموز
لضمان تنسيق الرمز بشكل صحيح. ويسهّل ذلك على Gemini قراءة وفهم التعليمات البرمجية.
التكرار والتحسين: قد لا يقدّم Gemini الحل الأمثل دائمًا من المحاولة الأولى. راجِع الردود واطرح أسئلة توضيحية وقدِّم معلومات إضافية حسب الحاجة.
تجنُّب حلقات الطلبات: إذا علق Gemini في حلقة أو تعذّر عليه الإجابة عن سؤالك، حاوِل إعادة صياغة طلبك أو تقديم سياق إضافي. في بعض الأحيان، يمكن أن يساعدك تغيير صياغة سؤالك في أن يفهم Gemini ما تسأل عنه.
إذا لم يؤدِّ تغيير صياغة طلبك إلى حلّ مشكلة التكرار، جرِّب التقنيات التالية:
بدء محادثة جديدة: إذا كنت تستخدم Gemini في Firebase
ضمن مساحة عملك Code
، ابدأ جلسة محادثة جديدة لإعادة ضبط سياق Gemini. يمكن أن يساعد ذلك في التخلّص من أي مفاهيم خاطئة أو افتراضات قد يكون Gemini قد وضعها في المحادثة السابقة.
تقديم أمثلة مضادة: إذا كان Gemini يضع افتراضات غير صحيحة، قدِّم أمثلة مضادة لمساعدته في فهم السلوك الصحيح.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["The effectiveness of your app blueprint and the quality of the generated code\ndepend on the clarity and detail of your prompts. When using\nthe App Prototyping agent, consider the following guidelines for effective\nprompting when generating and debugging apps:\n\n- **Be specific:** Clearly define the features, user interactions, and data requirements of your app. Ask for specific technologies, where possible. For example, if trying to create a web app with 3D elements, you may want to ask Gemini to use `three.js`.\n- **Ask about additional tasks to set up services:** Gemini can write code for your app, but it cannot actually set up services, enable APIs, or provision resources (like a Cloud Storage bucket or a Stripe account). Make sure to tell Gemini that if it writes code for specific services that it should also tell you how to set up those services.\n- **Request a Firebase project:** If you ask the App Prototyping agent to help you set up Firebase services, it will provision a Firebase project on your behalf. For example, you can ask \"Help me add Firestore,\" or \"Connect my app to Firebase.\"\n- **Use Gemini to refine your prompt:** Use [Gemini for\n Google](https://gemini.google.com), [chat with\n Gemini in Firebase](/docs/studio/try-gemini) in Code view, or other Gemini surfaces to refine and optimize your prompt.\n- **Provide context:** Include background information about your app's purpose, target audience, and the user experience you want.\n- **Use examples:** If possible, provide examples of how users should interact with the app or what data should be displayed.\n- **Iterate and refine:** Approach your development *iteratively*. Consider starting with a basic request, then add a feature, test it, refine it, then add another feature.\n\nBy following these guidelines, you can significantly improve the quality and\nrelevance of the app blueprints generated by Firebase Studio and its\nsuccess when debugging your app.\n\nUse additional prompts to refine responses\n\nIf the initial results aren't what you expect, you can refine your prompts by\nadding more detail or providing specific instructions:\n\n- **Add constraints:** Specify constraints on the UI, data model, or features.\n- **Provide examples:** Provide examples of how users should interact with the app and what data should appear.\n- **Use keywords:** Use keywords to describe the features or capabilities you want that the LLM might associate with the class of output you want. For example, you might use *Material Design* in a prompt where you indicate that you want your app to adhere to Google design standards.\n- **Ask for specific changes:** Ask for specific changes to the generated code or blueprint. Add each feature request in a separate request.\n- **Ask the model to reason:** If you're having trouble getting the results you want, try asking the model to reason through the prompt. For example, you could say \"Think step by step. I want to create an input box for my task app. It should contain an 'Add task' button and a 'Cancel' button.\"\n\nBy using these techniques, you can iteratively refine your prompts to get the\nresults you want.\n\nExamples of effective prompts for app blueprints\n\nHere are some examples of effective prompts for different types of apps:\n\n**Simple task tracker:** \n\n Create a simple web app that displays a list of to-do items.\n Users should be able to add new items to the list and mark items as complete.\n Provide a way to delete items and export the list as a text file.\n Use a clean and modern UI using Google Material Design principles.\n\n**Budgeting app:** \n\n A budgeting and expense tracking app with spending categories, charts, and\n budget goals. Include a clean dashboard with key insights. It should include\n spending categories, charts, and budget goals. The app should allow users to\n manually add expenses or upload csv files. The app should also allow users to\n upload receipts, then use AI to convert the receipt into an expense entry that\n users can edit. Data should be stored in browser cache, with download and\n delete options.\n\n**Game app prompt with assistance from Gemini (Markdown):** \n\n Generate a delightful sliding number puzzle game (15-puzzle) with Javascript,\n HTML, and CSS.\n\n - **Setup:** Create a 4x4 grid with numbers 1-15 and one empty space. Use a\n **solvable shuffling algorithm** to randomize the start.\n - **Gameplay:** Allow clicking tiles **adjacent to the empty space** to slide\n them. Count and display the number of moves.\n - **Timer:** Include a **countdown timer** starting at **120 seconds**\n (2 minutes).\n - **End Conditions:**\n - If solved (numbers 1-15 in order): Alert with an encouraging winning\n statement generated by AI.\n - If timer reaches 0: Alert with a funny retort generated by AI.\n\nTips for debugging\n\nYou can use Gemini in Firebase to help you debug your code with\nchat in your **Code** workspace\nor the App Prototyping agent.\n\nWhile Gemini can write code for you, it might sometimes also\nproduce errors. When it detects an error, it will attempt\nto fix it. If you find that it isn't able to resolve the issue given\nthe error message, you can try some of the following techniques:\n\n- **Describe the issue:** In the chat interface, describe the\n problem you're encountering as clearly and concisely as possible.\n While Gemini might have access to context like error messages\n and logs, it might not understand the full context. Describing the behavior\n along with the error message can help Gemini fix errors\n faster.\n\n- **Ask specific questions:** Don't be afraid to ask Gemini\n direct questions about your code. For example, \"What could be causing a\n null pointer exception in this function?\" or \"How can I prevent\n this race condition?\"\n\n- **Break down complex problems:** If you're dealing with a complex\n issue, break it down into smaller, more manageable parts. Ask\n Gemini to help you debug each part separately and think\n through problems step-by-step.\n\n- **Use code fences:** When sharing code snippets, use code fences\n to ensure that the code is properly formatted. This makes it easier\n for Gemini to read and understand your code.\n\n- **Iterate and refine:** Gemini may not always provide the perfect\n solution on the first try. Review the responses, ask clarifying\n questions, and provide additional information as needed.\n\n- **Avoid prompting loops:** If Gemini gets stuck in a loop or is\n unable to answer your question, try rephrasing your prompt or\n providing additional context. Sometimes, just rewording your\n question can help Gemini understand what you're asking.\n\n If rephrasing your prompt doesn't resolve the loop, try\n the following techniques:\n - **Start a new chat:** If you're using Gemini in Firebase\n chat in your Code\n workspace, start a new chat session to reset\n Gemini's context. This can help break free from any\n misconceptions or assumptions that Gemini may have made\n in the previous conversation.\n\n - **Provide counter-examples:** If Gemini is making incorrect\n assumptions, provide counter-examples to help it understand\n the correct behavior.\n\nNext steps\n\n- [Get started with the App Prototyping agent](/docs/studio/get-started-ai).\n- [Develop, publish, and monitor an app following a guided tour of the App Prototyping agent](/docs/studio/solution-build-with-ai).\n- [Develop applications in a\n Firebase Studio workspace](/docs/studio/get-started-workspace)."]]
