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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gemini در میانبرهای 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+, در Mac) را فشار دهید.

      اگر از App Prototyping agent در Prototyper view, click نماد سوئیچ کد Switch to Code to open Code view.

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

    3. برای خاموش کردن تکمیل کد، گزینه Enable inline code completion as you type را از حالت انتخاب خارج کنید.

تنظیمات نمایه سازی پایگاه کد خود را تنظیم کنید

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

توجه داشته باشید که نمایه سازی پایگاه کد به طور پیش فرض روشن است .

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

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

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

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

      اگر از 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: Enable Codebase Indexing را انتخاب کنید.

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

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

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

  • Gemini CLI فقط از GEMINI.md استفاده می کند.
  • Gemini در چت 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 خود ایجاد کنید. می توانید از یکی از گزینه های زیر استفاده کنید:

    • از Explorer ( 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 بر روی فایل هایی که در دایرکتوری حاوی آن یا زیر آن قرار دارند عمل می کند.

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

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

سایر محیط‌های توسعه مانند Android Studio نیز ممکن است فایل‌های .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. در فضای کاری باز خود، روی spark Gemini در پایین فضای کاری (یا تب Gemini ) کلیک کنید.

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

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

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

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

  1. مدل Gemini را که می‌خواهید در چت استفاده کنید، از لیست مدل‌های Gemini شناسایی کنید. به عنوان مثال، شما وارد کنید 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 به کدام ابزار دسترسی دارد، ویژگی چک پوینتینگ را پیکربندی کنید، و موارد دیگر.
  • تنظیمات : برای اطلاعات بیشتر در مورد نحوه تنظیم تنظیمات ، اسناد 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 را مرور کنید.

مراحل بعدی