بااستفاده از عامل «نمونه‌سازی برنامه»، یک برنامه وب پشته کامل را توسعه دهید، منتشر کنید، و بر آن نظارت کنید

این راهنما به شما نشان می‌دهد که چگونه از App Prototyping agent برای توسعه و انتشار سریع یک برنامه پشته کامل با کمک Gemini استفاده کنید. از پیام‌واره زبان طبیعی برای تولید برنامه Next.js استفاده خواهید کرد که اقلام غذایی را از تصویر یا دوربین درون مرورگر ارائه‌شده توسط کاربر واردشده به سیستم شناسایی می‌کند و دستورالعملی تولید می‌کند که حاوی مواد تشکیل‌دهنده شناسایی‌شده است. سپس کاربران می‌توانند انتخاب کنند که دستور غذا در پایگاه داده قابل‌جستجویی ذخیره شود.

سپس برنامه را پالایش و بهبود می‌دهید و درنهایت آن را در Firebase App Hosting منتشر می‌کنید.

دیگر فناوری‌هایی که درطول این راهنما استفاده خواهید کرد عبارت‌اند از:

مرحله ۱: تولید کردن برنامه

  1. به سیستم «حساب Google» خود وارد شوید و Firebase Studio را باز کنید.

  2. در فیلد نمونه‌سازی برنامه با هوش مصنوعی، پیام‌واره زیر را وارد کنید که برنامه دستورالعمل مبتنی بر تصویر ایجاد می‌کند که از دوربین مرورگر و هوش مصنوعی زایا استفاده می‌کند.

    برای مثال، می‌توانید پیام‌واره‌ای مانند زیر وارد کنید تا یک برنامه تولید دستور غذا ایجاد کنید:

    Use secure coding practices to create an error-free web app that lets
    users upload a photo or take a picture with their browser
    camera. The app identifies the food in the picture and generates a
    recipe and accompanying image that includes that food.
    
    If no food product is identified, generate a random dessert recipe.
    
  3. درصورت تمایل، تصویری را برای همراهی با پیام‌واره‌تان بارگذاری کنید. برای مثال، می‌توانید تصویری را بارگذاری کنید که حاوی آرایش رنگ‌هایی است که می‌خواهید برنامه‌تان از آن استفاده کند و به Firebase Studio بگویید از آن استفاده کند. تصاویر باید کمتر از ۳ مبی‌بایت باشند.

  4. روی ساختن نمونه نخستین با هوش مصنوعی کلیک کنید.

    ‫App Prototyping agent براساس پیام‌واره شما طرح اولیه برنامه را تولید می‌کند و نام پیشنهادی برنامه، ویژگی‌های موردنیاز، و دستورالعمل‌های سبک را برمی‌گرداند.

  5. طرح اولیه را مرور کنید. درصورت لزوم، چند تغییر ایجاد کنید. برای مثال، می‌توانید نام برنامه یا آرایش رنگ‌های پیشنهادی را بااستفاده از یکی از این گزینه‌ها تغییر دهید:

    • روی سفارشی‌سازی کلیک کنید و طرح را مستقیماً ویرایش کنید. تغییرات را انجام دهید و روی ذخیره کلیک کنید.

    • در فیلد توضیح دهید... در صفحه گپ، سؤالات شفاف‌سازی و بافت اضافه کنید. همچنین می‌توانید تصاویر بیشتری بارگذاری کنید.

  6. روی نمونه نخستین این برنامه کلیک کنید.

  7. App Prototyping agent شروع به کدنویسی برنامه شما می‌کند.

    • چون برنامه‌تان از هوش مصنوعی استفاده می‌کند، از شما خواسته می‌شود Gemini API کلید اضافه یا تولید کنید. اگر روی «تولید خودکار» کلیک کنید، App Prototyping agent یک پروژه Firebase و یک کلید Gemini API برای شما فراهم می‌کند.

مرحله ۲: آزمایش، پالایش، اشکال‌زدایی، و تکرار

پس‌از تولید برنامه اولیه، می‌توانید آن را آزمایش، پالایش، اشکال‌زدایی، و تکرار کنید.

  • بررسی و تعامل با برنامه: پس‌از تکمیل تولید کد، پیش‌نمایشی از برنامه شما ظاهر می‌شود. می‌توانید مستقیماً با پیش‌نمایش تعامل داشته باشید تا آن را آزمایش کنید. در پیش‌دید برنامه بیشتر بدانید.

  • افزودن Cloud Firestore و Firebase Authentication: درطول مرحله تکرار، می‌توانید از App Prototyping agent بخواهید اصالت‌سنجی کاربر و پایگاه داده را بااستفاده از Cloud Firestore و Firebase Authentication اضافه کند. برای مثال، با پیام‌واره‌ای مثل پیام‌واره زیر، به کاربران امکان دهید دستورالعمل‌های پخت را ذخیره و بارگیری کنند:

    Add user authentication to the app. Authenticated users can:
    
      - Download the recipe and its generated image as a PDF (Print).
    
      - Save the recipe as public or private and make accessible to a search
        feature. For now, just save the text, not the image, to the database.
    
    Important: Only authenticated users can download the PDF.
    
  • هر خطایی را به‌محض وقوع برطرف کنید: در اکثر موارد، App Prototyping agent از شما می‌خواهد هر خطایی را که رخ می‌دهد برطرف کنید. روی رفع خطا کلیک کنید تا اجازه دهید برای رفع آن تلاش کند.

    اگر خطاهایی دریافت می‌کنید که از شما خواسته نمی‌شود آن‌ها را به‌طور خودکار برطرف کنید، خطا و هر بافت مرتبطی را (برای مثال، «آیا می‌توانید این خطا را در کد مقداردهی اولیه Firebase من برطرف کنید؟») در پنجره گپ کپی کنید و آن را به Gemini ارسال کنید.

  • آزمایش و تکرار بااستفاده از زبان طبیعی: برنامه‌تان را به‌طور کامل آزمایش کنید و با App Prototyping agent کار کنید تا کد و طرح اولیه را تکرار کنید تا زمانی که از آن راضی باشید.

    وقتی در نمای Prototyper هستید، می‌توانید از ویژگی‌های زیر نیز استفاده کنید:

    • روی نماد حاشیه‌نویسی حاشیه‌نویسی کلیک کنید تا مستقیماً روی پنجره «پیش‌نمایش» طراحی کنید. از ابزارهای شکل، تصویر، و نوشتار موجود، به‌همراه پیام‌واره نوشتاری اختیاری، استفاده کنید تا به‌صورت دیداری توضیح دهید که می‌خواهید App Prototyping agent چه تغییری کند.

    • روی انتخاب نماد انتخاب کلیک کنید تا عنصر خاصی را انتخاب کنید و دستورالعمل‌های مربوط به App Prototyping agent را وارد کنید. این کار به شما امکان می‌دهد به‌سرعت نماد، دکمه، نوشتار، یا عنصر دیگری را هدف قرار دهید. وقتی روی تصویری کلیک می‌کنید، این گزینه را هم دارید که تصویر آرشیوی را از Unsplash جستجو و انتخاب کنید.

    درصورت تمایل، می‌توانید روی نماد
پیوند هم‌رسانی پیوند پیش‌نمایش کلیک کنید تا برنامه‌تان را به‌طور عمومی و موقت بااستفاده از Firebase Studio پیش‌نمایش‌های عمومی هم‌رسانی کنید.

  • ایجاد پروژه Firebase: App Prototyping agent وقتی کارهای زیر را انجام می‌دهید، پروژه Firebase را ازجانب شما فراهم می‌کند:

    • تولید خودکار کلید Gemini API
    • درخواست اتصال برنامه به پروژه Firebase
    • برای متصل کردن برنامه‌تان به سرویس‌های Firebase، مثل Cloud Firestore یا Firebase Authentication، درخواست کمک کنید
    • روی دکمه انتشار کلیک کنید و Firebase App Hosting را راه‌اندازی کنید

    برای تغییر پروژه Firebase متصل به فضای کاری‌تان، App Prototyping agent را با شناسه پروژه‌ای که می‌خواهید به‌جای آن استفاده کنید درخواست کنید. برای مثال، «به پروژه Firebase با شناسه <your-project-id> بروید.»

  • آزمایش برنامه و درستی‌سنجی Cloud Firestore قوانین پایگاه داده: در قاب پیش‌نمایش برنامه، تصویری را بارگذاری کنید که غذاهای مختلفی را نشان می‌دهد تا توانایی برنامه‌تان را در شناسایی مواد تشکیل‌دهنده و تولید و ذخیره دستورالعمل‌ها آزمایش کنید.

    به‌عنوان کاربران مختلف به سیستم وارد شوید و دستورالعمل ایجاد کنید: مطمئن شوید که کاربران اصالت‌سنجی‌شده می‌توانند دستورالعمل‌های خصوصی خودشان را ببینند و همه کاربران دستورالعمل‌های عمومی را ببینند.

    وقتی از App Prototyping agent می‌خواهید Cloud Firestore را اضافه کند، قوانین پایگاه داده Cloud Firestore را برای شما می‌نویسد و مستقر می‌کند. قوانین را در کنسول Firebase مرور کنید.

  • اشکال‌زدایی و تکرار مستقیم در کد: روی نماد
تغییر کد رفتن به کد کلیک کنید تا نمای Code باز شود، جایی که می‌توانید همه فایل‌های برنامه‌تان را ببینید و کدتان را مستقیماً اصلاح کنید. هرزمان بخواهید می‌توانید به حالت Prototyper برگردید.

    وقتی در نمای Code هستید، می‌توانید از ویژگی‌های مفید زیر نیز استفاده کنید:

    • Firebase Studio ویژگی‌های گزارش‌دهی و اشکال‌زدایی داخلی برای بازرسی، اشکال‌زدایی، و ممیزی برنامه شما.

    • کمک هوش مصنوعی بااستفاده از Gemini به‌صورت درون‌خطی در کد شما یا بااستفاده از گپ تعاملی Gemini (هر دو به‌طور پیش‌فرض دردسترس هستند). گپ تعاملی می‌تواند مشکلات را تشخیص دهد، راهکار ارائه دهد، و ابزارهایی را برای کمک به رفع سریع‌تر مشکل برنامه‌تان اجرا کند. برای دسترسی به گپ، روی sparkGemini در پایین فضای کاری کلیک کنید.

    • برای مشاهده پایگاه داده و داده‌های اصالت‌سنجی، به Firebase Local Emulator Suite دسترسی پیدا کنید. برای باز کردن شبیه‌ساز در فضای کاری:

      1. روی نماد
تغییر کد رفتن به Code کلیک کنید و افزونه Firebase Studio را باز کنید (Ctrl+',Ctrl+'، یا Cmd+',Cmd+' در MacOS).

      2. به درگاه‌های پس‌بخش پیمایش کنید و آن را ازهم باز کنید.

      3. در ستون کنش‌ها که مربوط به درگاه ۴۰۰۰ است، روی باز کردن در پنجره جدید کلیک کنید.

  • آزمایش و اندازه‌گیری عملکرد ویژگی هوش مصنوعی زایا: می‌توانید از Genkit Developer UI برای اجرای جریان‌های هوش مصنوعی Genkit، آزمایش، اشکال‌زدایی، تعامل با مدل‌های مختلف، اصلاح پیام‌واره‌ها، و موارد دیگر استفاده کنید.

    برای بار کردن جریان‌های Genkit در Genkit Developer UI و شروع آزمایش:

    1. از پایانه در فضای کاری Firebase Studio، دستور زیر را اجرا کنید تا کلید Gemini API را منبع‌یابی کنید و سرور Genkit را راه‌اندازی کنید:

       npm run genkit:watch
      
    2. روی پیوند Genkit Developer UI کلیک کنید. Genkit Developer UI در پنجره جدیدی باز می‌شود که حاوی جریان‌ها، پیام‌واره‌ها، جاسازها، و مجموعه‌ای از مدل‌های دردسترس مختلف است.

    درباره Genkit Developer UI در ابزارهای توسعه‌دهنده Genkit بیشتر بدانید.

(اختیاری) مرحله ۳: منتشر کردن برنامه با App Hosting

پس‌از آزمایش کردن برنامه و رضایت از آن در فضای کاری‌تان، می‌توانید آن را با Firebase App Hosting در وب منتشر کنید.

وقتی App Hosting را راه‌اندازی می‌کنید، Firebase Studio یک پروژه Firebase برای شما ایجاد می‌کند (اگر قبلاً با تولید خودکار کلید Gemini API یا دیگر سرویس‌های پس‌بست ایجاد نشده باشد) و شما را در پیوند دادن حساب Cloud Billing راهنمایی می‌کند.

برای منتشر کردن برنامه‌تان:

  1. روی انتشار کلیک کنید تا پروژه Firebase را راه‌اندازی کنید و برنامه‌تان را منتشر کنید. پانل انتشار برنامه ظاهر می‌شود.

  2. در مرحله پروژه Firebase، App Prototyping agent پروژه Firebase مرتبط با فضای کاری را نمایش می‌دهد. اگر پروژه Firebase ازقبل وجود نداشته باشد، App Prototyping agent پروژه جدیدی برای شما ایجاد می‌کند. برای ادامه، روی بعدی کلیک کنید.

  3. در مرحله پیوند دادن حساب Cloud Billing، یکی از گزینه‌های زیر را انتخاب کنید:

    • حساب Cloud Billing را که می‌خواهید به پروژه Firebase پیوند دهید انتخاب کنید.

    • اگر حساب Cloud Billing ندارید یا می‌خواهید حساب جدیدی ایجاد کنید، روی ایجاد حساب Cloud Billing کلیک کنید. با این کار، کنسول Google Cloud باز می‌شود که در آن می‌توانید حساب سلف‌سرویس Cloud Billing جدیدی ایجاد کنید. پس‌از ایجاد حساب، به Firebase Studio برگردید و حساب را از فهرست پیوند دادن Cloud Billing انتخاب کنید.

  4. روی بعدی کلیک کنید. Firebase Studio حساب صورت‌حساب را به پروژه مرتبط با فضای کاری شما پیوند می‌دهد، که یا هنگام تولید خودکار کلید Gemini API یا هنگام کلیک کردن روی انتشار ایجاد شده است.

  5. روی راه‌اندازی سرویس‌ها کلیک کنید. App Prototyping agent شروع به تأمین خدمات Firebase می‌کند.

  6. روی اکنون منتشر شود کلیک کنید. Firebase Studio سرویس‌های Firebase را راه‌اندازی می‌کند و سپس عرضه App Hosting را شروع می‌کند. ممکن است چند دقیقه طول بکشد تا تکمیل شود. برای کسب اطلاعات بیشتر درباره آنچه در پشت صحنه اتفاق می‌افتد، فرایند ساخت App Hosting را ببینید.

  7. وقتی مرحله انتشار تکمیل شد، نمای کلی برنامه با یک نشانی وب و اطلاعات آماری برنامه که با قابلیت مشاهده App Hosting ارائه می‌شود ظاهر می‌شود. برای استفاده از دامنه سفارشی (مانند example.com یا app.example.com) به‌جای دامنه تولیدشده توسط Firebase، می‌توانید دامنه سفارشی اضافه کنید در کنسول Firebase.

برای اطلاعات بیشتر درباره App Hosting، آشنایی با App Hosting و نحوه عملکرد آن را ببینید.

(توصیه‌شده) مرحله ۴: آزمایش کردن برنامه منتشرشده

وقتی انتشار کامل شد و برنامه‌تان در Firebase مستقر شد، Cloud Firestore و Firebase Authentication برای آزمایش در تولید آماده‌اند.

تولید نمایه‌ها برای پایگاه داده Cloud Firestore

وقتی برنامه‌تان را در Cloud Firestore مستقر می‌کنید، نمایه‌ها به‌طور خودکار تولید نمی‌شوند. این یعنی پس‌از انتشار، ممکن است لازم باشد برای پُرسمان‌هایتان نمایه تولید کنید.

ممکن است این مورد را در پیام‌های خطا یا در کنسول توسعه‌دهنده مرورگرتان ببینید.

برای تولید نمایه‌ها پس‌از انتشار:

  1. از برنامه منتشرشده: در پانل نمای کلی برنامه (اگر نمایان نیست، روی انتشار کلیک کنید)، پیوند بازدید از برنامه را پیدا کنید و روی آن کلیک کنید.

    از پیش‌نمایش Firebase Studio: کنسول توسعه‌دهنده مرورگرتان را باز کنید و پیام خطای ۲۰۰ را که Cloud Firestore تولید می‌کند پیدا کنید.

  2. همه جریان‌های درون برنامه‌تان را آزمایش کنید. ممکن است خطایی ظاهر شود که چیزی شبیه به این می‌گوید: «خطا در بار کردن دستورالعمل‌ها. این پُرسمان به نمایه نیاز دارد. می‌توانید آن را در اینجا ایجاد کنید:» با پیوندی به کنسول Firebase.

  3. پیوند را دنبال کنید تا به کنسول Firebase بروید و نمایه توصیه‌شده‌ای ظاهر می‌شود.

  4. برای پذیرفتن نمایه توصیه‌شده، روی ذخیره کلیک کنید.

  5. به برنامه‌تان برگردید و صفحه را مجدداً بار کنید.

  6. به آزمایش کردن همه جریان‌ها در برنامه‌تان ادامه دهید تا درصورت لزوم نمایه اضافه کنید.

در مدیریت نمایه‌ها در Cloud Firestore بیشتر بدانید.

مشاهده داده‌های Cloud Firestore و Firebase Authentication در کنسول Firebase

پس‌از انتشار می‌توانید داده‌های زنده را از برنامه‌تان در کنسول Firebase مشاهده کنید.

  • برای مشاهده پایگاه داده Cloud Firestore زنده، کنسول Firebase را باز کنید و از منو پیمایش، ساخت > پایگاه داده Firestore را انتخاب کنید.

    از اینجا می‌توانید داده‌های ذخیره‌شده را بازرسی کنید، قوانین امنیتی‌تان را مشاهده و آزمایش کنید، و نمایه ایجاد کنید. در Cloud Firestore اطلاعات بیشتری دریافت کنید.

  • برای مشاهده داده‌های زنده Firebase Authentication، کنسول Firebase را باز کنید و ساختن > اصالت‌سنجی را از منو پیمایش انتخاب کنید.

    از اینجا می‌توانید پیکربندی اصالت‌سنجی و کاربران برنامه را بازرسی کنید. در Firebase Authentication اطلاعات بیشتری دریافت کنید.

آزمایش کردن قوانین Cloud Firestore در تولید

پس‌از انتشار برنامه، باید دوباره قوانین امنیتی Cloud Firestore را در محیط تولید آزمایش کنید. این کار کمک می‌کند مطمئن شوید که داده‌هایتان برای کاربران مجاز قابل‌دسترس است و دربرابر دسترسی غیرمجاز محافظت می‌شود.

می‌توانید قوانینتان را بااستفاده از همه روش‌های زیر آزمایش کنید:

  • آزمایش برنامه: با برنامه مستقرشده‌تان تعامل برقرار کنید و عملیاتی را انجام دهید که الگوهای مختلف دسترسی به داده (خواندن، نوشتن، حذف کردن) را برای نقش‌ها یا وضعیت‌های مختلف کاربر راه‌اندازی می‌کند. این آزمایش در دنیای واقعی کمک می‌کند مطمئن شوید که قوانینتان به‌درستی در عمل اجرا می‌شوند.

  • Rules Playground: برای بررسی‌های هدفمند، از Rules Playground در کنسول Firebase استفاده کنید. این ابزار به شما امکان می‌دهد درخواست‌ها (خواندن، نوشتن، حذف کردن) را درمقابل پایگاه داده Cloud Firestore بااستفاده از قوانین تولید شبیه‌سازی کنید. می‌توانید وضعیت اصالت‌سنجی کاربر، مسیر داده‌ها، و نوع عملیات را مشخص کنید تا ببینید آیا قوانین شما دسترسی را طبق انتظار مجاز یا ممنوع می‌کنند یا نه.

  • آزمایش واحد: برای آزمایش جامع‌تر، می‌توانید آزمایش‌های واحد برای قوانین امنیتی خود بنویسید. باطن پیش‌نمایش Firebase Studio که با Firebase Local Emulator Suite پشتیبانی می‌شود به شما امکان می‌دهد این آزمایش‌ها را به‌صورت محلی اجرا کنید، و رفتار قوانین تولیدتان را شبیه‌سازی کنید. این روشی قوی برای درستی‌سنجی منطق قانون پیچیده و تأیید پوشش برای سناریوهای مختلف است. پس‌از استقرار، باید دوباره بررسی کنید که آزمایش‌های واحدتان بااستفاده از شبیه‌ساز مطابق انتظار کار می‌کند و همه سناریوها را پوشش می‌دهد.