پیکربندی Gemini در Firebase در محیط های کاری

Firebase Studio با ویژگی‌های کدنویسی مبتنی بر هوش مصنوعی زیر، گردش کار توسعه شما را تسهیل می‌کند:

  • تکمیل کد پیشنهادی هنگام تایپ

  • کمک هوش مصنوعی با چت یا از طریق رابط خط فرمان (CLI)، که از فضای کاری آگاه است و کاملاً با کد شما یکپارچه شده است. این رابط می‌تواند کد را تولید، ترجمه و توضیح دهد. و با بررسی و تأیید شما، Gemini در Firebase می‌تواند مستقیماً با فضای کاری شما تعامل داشته باشد تا فایل‌ها را به‌روزرسانی کند، دستورات ترمینال را اجرا کند، خروجی دستورات را تفسیر کند و مراحل بعدی را تعیین کند. برای اطلاعات بیشتر به «چت با Gemini در Firebase Studio را امتحان کنید» مراجعه کنید.

  • اقدامات درون‌خطی که می‌توانید روی بخش‌های انتخاب‌شده از کد انجام دهید. برای مثال، می‌توانید از Gemini بخواهید کد انتخاب‌شده را خواناتر کند.

  • کمک در مورد کد درون خطی.

شما می‌توانید با تنظیم تنظیمات Gemini در Firebase و اضافه کردن فایل‌های قوانین هوش مصنوعی، نحوه‌ی کمک آن به خودتان را سفارشی کنید:

از Gemini در Firebase در فضای کاری خود استفاده کنید

از Gemini در Firebase برای افزایش بهره‌وری کدنویسی خود از طریق پنل چت ، ترمینال یا پشتیبانی کد درون‌خطی استفاده کنید.

  1. از چت یا کمک کدنویسی درون‌خطی در فضای کاری خود استفاده کنید:

    • برای استفاده از چت: در فضای کاری باز خود، روی جرقه جمینی در پایین فضای کاری کلیک کنید.

    • برای استفاده از Gemini CLI : ترمینال را باز کنید و برای رابط Gemini CLI gemini را وارد کنید، یا برای استفاده از Gemini CLI در حالت غیرتعاملی، از دستور gemini -p استفاده کنید.

    • برای استفاده از دستیار کد درون‌خطی: شروع به تایپ کد خود کنید و برای پذیرش پیشنهادات Tab فشار دهید.

  2. توجه داشته باشید که دو گزینه زیر به طور پیش‌فرض فعال هستند:

    • پیشنهاداتی هنگام تایپ ، که تکمیل کد درون‌خطی را فراهم می‌کند.
    • نمایه‌سازی کدبیس ، که سفارشی‌سازی بهتر و پاسخ‌های مفیدتری را فراهم می‌کند.

    برای تغییر این انتخاب‌ها برای تنظیمات فضای کاری خود در آینده:

    همچنین می‌توانید فایل‌ها و دایرکتوری‌های خاصی را از فهرست‌بندی هوش مصنوعی مستثنی کنید. به بخش «حذف فایل‌ها از Gemini با استفاده از .aiexclude files» مراجعه کنید.

میانبرهای جمینی در Firebase

برای باز کردن سریع چت با Gemini : Ctrl+Shift+Space (یا Cmd+Shift+Space در MacOS) را فشار دهید.

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

  1. با فشار دادن Ctrl+Shift+P (یا Cmd+Shift+P در MacOS) پالت فرمان را باز کنید.

  2. جستجو برای Gemini .

    لیستی از دستورات Gemini ظاهر می‌شود.

تنظیمات تکمیل کد خود را تنظیم کنید

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

توجه داشته باشید که تکمیل کد به طور پیش‌فرض فعال است .

برای فعال یا غیرفعال کردن تکمیل کد، تنظیمات تکمیل کد خود را با استفاده از یکی از روش‌های زیر تنظیم کنید:

  • اگر از فایل settings.json استفاده می‌کنید، "IDX.aI.enableInlineCompletion" روی true یا false تنظیم کنید.

  • برای به‌روزرسانی تنظیمات در فضای کاری Firebase Studio :

    1. کلیک نماد چرخ دنده مدیریت (واقع در پایین سمت چپ فضای کاری)، سپس تنظیمات را انتخاب کنید، یا Ctrl+, ( Cmd+, در مک) را فشار دهید.

      اگر App Prototyping agent در Prototyper view, click نماد تغییر کد Switch to Code to open Code view.

    2. تب Workspace را انتخاب کنید، سپس تنظیمات Firebase Studio > AI > Enable Inline Completion را جستجو کنید.

    3. برای غیرفعال کردن تکمیل کد، گزینه‌ی «فعال کردن تکمیل کد درون‌خطی هنگام تایپ» را از حالت انتخاب خارج کنید.

تنظیمات ایندکس‌گذاری کدبیس خود را تنظیم کنید

شما می‌توانید کنترل کنید که آیا Gemini کد شما را ایندکس کند یا خیر. ایندکس کردن کد شما هنگام استفاده از چت یا کمک هوش مصنوعی درون خطی، نتایج مفیدتری را ارائه می‌دهد.

توجه داشته باشید که ایندکس‌گذاری کدبیس به طور پیش‌فرض فعال است .

برای فعال یا غیرفعال کردن ایندکس‌گذاری کد، تنظیمات ایندکس‌گذاری کدبیس خود را با استفاده از یکی از روش‌های زیر تنظیم کنید:

  • اگر از فایل settings.json استفاده می‌کنید، "IDX.aI.enableCodebaseIndexing" را روی true یا false تنظیم کنید.

  • برای به‌روزرسانی تنظیمات در فضای کاری Firebase Studio :

    1. کلیک نماد چرخ دنده مدیریت (واقع در پایین سمت چپ فضای کاری)، سپس تنظیمات را انتخاب کنید، یا Ctrl+, (در مک Cmd+, ) را فشار دهید.

      اگر App Prototyping agent در Prototyper view, click نماد تغییر کد Switch to Code to open Code view.

    2. تب Workspace را انتخاب کنید، سپس تنظیمات Firebase Studio > AI > Enable Inline Completion را جستجو کنید.

    3. Firebase Studio > AI را انتخاب کنید: Codebase Indexing را فعال کنید .

    4. برای خاموش کردن ایندکس‌گذاری کد، گزینه‌ی AI: Enable Codebase Indexing را از حالت انتخاب خارج کنید. شما باید تنظیمات ایندکس‌گذاری کد را برای هر یک از فضاهای کاری خود به‌روزرسانی کنید.

دستورالعمل‌های Gemini را با یک فایل قوانین هوش مصنوعی سفارشی کنید

شما می‌توانید با ایجاد یک فایل قوانین هوش مصنوعی، اطلاعات زمینه و اعلان سیستم را اضافه کنید:

  • Gemini CLI فقط از GEMINI.md استفاده می‌کند.
  • جمینی در چت Firebase ، .idx/airules.md را در اولویت قرار می‌دهد، اما اگر .idx/airules.md وجود نداشته باشد، از GEMINI.md استفاده خواهد کرد.

Gemini در Firebase از قوانین شما به عنوان دستورالعمل‌های سیستمی و زمینه استفاده می‌کند و پاسخ‌های خود را برای مورد استفاده شما سفارشی‌سازی می‌کند.

از فایل قوانین هوش مصنوعی برای به اشتراک گذاشتن دستورالعمل‌های سفارشی، بهترین شیوه‌ها و حتی زمینه‌های مهم در مورد پروژه خود با Gemini استفاده کنید تا به اهدافی مانند موارد زیر برسید:

  • تأثیرگذاری بر شخصیت Gemini و تخصصی کردن تخصص آن.
  • اعمال استانداردهای سراسری پروژه، مانند سبک کدنویسی، قراردادها و ترجیحات فناوری.
  • با ارائه اطلاعات ضروری در مورد پروژه خود، میزان اطلاعاتی را که باید به صراحت در کد یا چت به اشتراک بگذارید، کاهش دهید.

فایل قوانین هوش مصنوعی خود را ایجاد و آزمایش کنید

برای ایجاد و آزمایش فایل قوانین هوش مصنوعی خود:

  1. یک فایل جدید در ~/GEMINI.md (برای Gemini CLI ) یا .idx/airules.md (برای Gemini در چت Firebase ) در فضای کاری Firebase Studio خود ایجاد کنید. می‌توانید از یکی از گزینه‌های زیر استفاده کنید:

    • از اکسپلورر ( Ctrl+Shift+E )، روی دایرکتوری والد کلیک راست کرده و فایل جدید (New file) را انتخاب کنید. نام فایل را وارد کرده و Enter را بزنید.
    • از طریق ترمینال، با استفاده از ویرایشگر متن دلخواه خود، GEMINI.md یا .idx/airules.md را باز کنید.

  2. محتوا را به فایل اضافه کنید. می‌توانید اطلاعاتی در مورد شخصیتی که Gemini باید از آن استفاده کند (مانند "شما یک توسعه‌دهنده متخصص و دستیار مفید هستید که همه چیز را در مورد Next.js می‌دانید") ، استانداردهای کدنویسی و مکالمه و زمینه پروژه اضافه کنید. برای مثالی از یک فایل قوانین هوش مصنوعی به مثال زیر مراجعه کنید.

  3. فایل را ذخیره کنید و Gemini CLI یا Gemini را در Firebase باز کنید.

  4. برای شروع استفاده از قوانین هوش مصنوعی خود، می‌توانید یکی از موارد زیر را انجام دهید:

    • با رفرش کردن صفحه، فضای کاری را بازسازی کنید. پس از بازسازی، Gemini از فایل قوانین درون چت استفاده خواهد کرد. تغییرات در فایل قوانین هوش مصنوعی باید بلافاصله اعمال شود.
    • اگر نمی‌خواهید فضای کاری خود را از نو بسازید، می‌توانید از Gemini بخواهید که load GEMINI.md یا load airules.md . اگر در طول جلسه فعلی تغییراتی در فایل ایجاد کنید، ممکن است لازم باشد دوباره از Gemini بخواهید که فایل قوانین را بارگذاری کند.

  5. در مورد کد خود سوال بپرسید. Gemini با استفاده از اطلاعاتی که در فایل قوانین به عنوان زمینه قرار داده‌اید، پاسخ می‌دهد.

مثال

در زیر یک مثال ساده از فایل قوانین که می‌توانید برای یک بازی معمولی توسعه داده شده با Next.js استفاده کنید، آمده است:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

حذف فایل‌ها از Gemini با استفاده از فایل‌های .aiexclude

شما می‌توانید با گنجاندن فایل‌های .aiexclude در پروژه خود، کنترل کنید که کدام فایل‌های موجود در کدبیس شما باید از Gemini پنهان بمانند. این به شما امکان می‌دهد تا زمینه پروژه‌ای را که با Gemini به اشتراک می‌گذارید، به صورت جزئی کنترل کنید.

بسیار شبیه به فایل .gitignore ، فایل .aiexclude فایل‌هایی را که نباید با Gemini به اشتراک گذاشته شوند، از جمله تجربه چت و همچنین ویژگی‌های هوش مصنوعی که در ویرایشگر کار می‌کنند، ردیابی می‌کند. فایل .aiexclude روی فایل‌هایی که در دایرکتوری یا پایین‌تر از آن قرار دارند، کار می‌کند.

فایل‌هایی که با .aiexclude پوشش داده می‌شوند، در صورت فعال بودن Codebase Indexing توسط Gemini ایندکس نخواهند شد. علاوه بر این، .aiexclude به روش‌های زیر بر پشتیبانی درون‌خطی برای فایل‌های تحت پوشش تأثیر می‌گذارد:

  • کمک چت : Gemini قادر به پاسخ به سوالات یا ارائه پیشنهاد در مورد فایل‌های تحت پوشش .aiexclude نخواهد بود.
  • تکمیل کد : تکمیل‌های کد پیشنهادی هنگام ویرایش فایل‌های تحت پوشش در دسترس نخواهند بود.
  • کمک درون‌خطی : شما قادر خواهید بود کد جدید تولید کنید، اما هنگام ویرایش فایل‌های تحت پوشش، نمی‌توانید کد موجود را تغییر دهید.

سایر محیط‌های توسعه مانند اندروید استودیو نیز ممکن است فایل‌های .aiexclude را پشتیبانی کنند.

نحوه نوشتن فایل‌های .aiexclude

یک فایل .aiexclude از همان سینتکس فایل .gitignore پیروی می‌کند، با این تفاوت‌های زیر:

  • یک فایل خالی .aiexclude ‎ تمام فایل‌های موجود در دایرکتوری و تمام زیر دایرکتوری‌های خود را مسدود می‌کند. این مشابه فایلی است که حاوی **/* ‎ است.
  • فایل‌های .aiexclude از نفی (پیشوند کردن الگوها با ! ) پشتیبانی نمی‌کنند.

مثال‌ها

در اینجا چند نمونه از پیکربندی‌های فایل .aiexclude آورده شده است:

  • تمام فایل‌هایی با نام apikeys.txt را که در دایرکتوری یا پایین‌تر از آن قرار دارند و فایل .aiexclude در آن‌ها قرار دارد، مسدود کنید:

    apikeys.txt

  • تمام فایل‌هایی که پسوند .key دارند و در دایرکتوری حاوی فایل .aiexclude یا پایین‌تر از آن قرار دارند را مسدود می‌کند:

    *.key

  • فقط فایل apikeys.txt را در همان دایرکتوری که فایل .aiexclude قرار دارد، مسدود کنید، اما هیچ زیرشاخه‌ای را مسدود نکنید:

    /apikeys.txt

  • تمام فایل‌های موجود در دایرکتوری my/sensitive/dir و تمام زیرشاخه‌های آن را مسدود کنید. مسیر باید نسبت به دایرکتوری حاوی فایل .aiexclude باشد:

    my/sensitive/dir/

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

شما می‌توانید مدل Gemini که Gemini در چت Firebase از آن استفاده می‌کند را پیکربندی کنید. شما می‌توانید از بین مدل داخلی، مدل‌های پیکربندی‌شده در پنجره چت (از جمله مدل‌های Gemini 2.5 ) یا هر مدل Gemini که به آن دسترسی دارید، یکی را انتخاب کنید.

برای مشاهده لیست تمام مدل‌های موجود، به مدل‌های Gemini مراجعه کنید.

برای پیکربندی کلید خود و انتخاب یک مدل Gemini متفاوت:

  1. در فضای کاری باز خود، روی جرقه جمینی در پایین فضای کاری (یا تب جمینی ) کلیک کنید.

  2. در پنجره چت Gemini در Firebase ، روی منوی کشویی نام مدل کلیک کنید، سپس روی لینک کلید API Gemini کلیک کنید. تنظیمات کاربر ظاهر می‌شود.

  3. در فیلد IDX > AI: Gemini Api Key ، کلید API Gemini خود را وارد کنید.

اکنون می‌توانید هر یک از مدل‌های از پیش تنظیم‌شده‌ی جمینی را در چت انتخاب کنید.

برای پیکربندی یک مدل Gemini که در منوی کشویی نیست:

  1. مدل Gemini مورد نظر خود را برای استفاده در چت از لیست Gemini models انتخاب کنید. برای مثال، وارد کنید gemini-2.0-flash-lite برای استفاده از آخرین مدل پایدار Gemini 2.0 Flash‑Lite .

  2. از پنجره چت Gemini در Firebase ، روی انتخابگر مدل کلیک کنید، سپس شناسه مدل سفارشی را انتخاب کنید. تنظیمات کاربر باز می‌شود.

  3. نام مدلی که انتخاب کرده‌اید را در فیلد IDX > AI: Gemini Model کپی کنید.

  4. پنجره چت را ببندید، سپس با کلیک روی spark Gemini در پایین فضای کاری، آن را دوباره باز کنید تا لیست مدل‌ها به‌روزرسانی شود.

سفارشی‌سازی Gemini CLI

  • تنظیمات : یک فایل .gemini/settings.json ایجاد کنید تا بتوانید قالب را تغییر دهید، جمع‌آوری آمار استفاده را فعال یا غیرفعال کنید، ابزارهایی را که Gemini CLI به آنها دسترسی دارد تنظیم کنید، ویژگی checkpointing را پیکربندی کنید و موارد دیگر.
  • تنظیمات : برای اطلاعات بیشتر در مورد نحوه تنظیم تنظیمات، مستندات Gemini CLI را بررسی کنید.
  • متغیرهای محیطی : Gemini CLI به طور خودکار متغیرهای محیطی را از فایل .env بارگذاری می‌کند. اینجا جایی است که باید GEMINI_API_KEY (الزامی) خود را ذخیره کنید، و همچنین، به صورت اختیاری، مدل Gemini مورد نظر برای استفاده، شناسه پروژه Google Cloud خود و موارد دیگر را نیز وارد کنید.
  • دستورالعمل‌ها : برای تنظیم زمینه‌ای که Gemini CLI هنگام دنبال کردن دستورالعمل‌ها استفاده می‌کند، یک فایل GEMINI.md ایجاد کنید. این به شما امکان می‌دهد دستورالعمل‌های خاص پروژه، راهنماهای سبک کدنویسی یا اطلاعات پیش‌زمینه مرتبط را به Gemini ارائه دهید و پاسخ‌های آن را متناسب‌تر و دقیق‌تر با نیازهای خود تنظیم کنید. توجه داشته باشید که ایجاد این فایل، همان دستورالعمل‌ها را به Gemini در Firebase ارائه می‌دهد، مگر اینکه یک فایل .idx/airules.md نیز ایجاد کنید (که در این صورت Gemini CLI از GEMINI.md و Gemini در Firebase از airules.md استفاده می‌کند).

برای اطلاعات بیشتر در مورد نحوه تنظیم تنظیمات، متغیرهای محیطی و دستورالعمل‌ها ، مستندات Gemini CLI را بررسی کنید.

مراحل بعدی