Định cấu hình Gemini trong không gian làm việc

Firebase Studio hỗ trợ quy trình phát triển của bạn bằng các tính năng mã có sự hỗ trợ của AI sau đây:

  • Đề xuất hoàn thành mã khi bạn nhập.

  • Hỗ trợ AI bằng cách trò chuyện hoặc thông qua giao diện dòng lệnh (CLI), có nhận biết không gian làm việc và được tích hợp đầy đủ với mã của bạn. AI có thể tạo, dịch và giải thích mã. Ngoài ra, sau khi bạn xem xét và phê duyệt, Gemini có thể trực tiếp tương tác với không gian làm việc của bạn để cập nhật tệp, chạy lệnh trên thiết bị đầu cuối, diễn giải đầu ra của lệnh, và xác định các bước tiếp theo. Tìm hiểu thêm tại Dùng thử tính năng trò chuyện với Gemini trong Firebase Studio.

  • Các thao tác nội tuyến mà bạn có thể thực hiện trên các đoạn mã đã chọn. Ví dụ: bạn có thể yêu cầu Gemini làm cho mã đã chọn dễ đọc hơn.

  • Hỗ trợ mã nội tuyến.

Bạn có thể tuỳ chỉnh cách Gemini hỗ trợ bạn bằng cách điều chỉnh chế độ cài đặt và thêm tệp quy tắc AI:

Sử dụng Gemini trong không gian làm việc

Sử dụng Gemini để tăng cường năng suất lập trình thông qua bảng điều khiển trò chuyện, thiết bị đầu cuối hoặc tính năng hỗ trợ mã nội tuyến.

  1. Sử dụng tính năng trò chuyện hoặc hỗ trợ mã nội tuyến trong không gian làm việc:

    • Cách sử dụng tính năng trò chuyện: Trong không gian làm việc đang mở, hãy nhấp vào biểu tượng tia lửa Gemini ở cuối không gian làm việc.

    • Cách sử dụng Gemini CLI: Mở thiết bị đầu cuối và nhập gemini cho giao diện Gemini CLI hoặc sử dụng lệnh gemini -p để sử dụng Gemini CLI ở chế độ không tương tác.

    • Cách sử dụng tính năng hỗ trợ mã nội tuyến: Bắt đầu nhập mã rồi nhấn Tab để chấp nhận các đề xuất.

  2. Xin lưu ý rằng 2 lựa chọn sau đây được bật theo mặc định:

    • Đề xuất khi bạn nhập, cung cấp tính năng hoàn thành mã cùng dòng.
    • Lập chỉ mục cơ sở mã, cung cấp khả năng tuỳ chỉnh tốt hơn và câu trả lời hữu ích hơn.

    Cách thay đổi các lựa chọn này cho chế độ cài đặt không gian làm việc trong tương lai:

    Bạn cũng có thể loại trừ các tệp và thư mục cụ thể khỏi quá trình lập chỉ mục AI. Xem bài viết Loại trừ tệp khỏi Gemini bằng tệp .aiexclude.

Gemini phím tắt

Cách nhanh chóng mở cuộc trò chuyện với Gemini: nhấn Ctrl+Shift+Space (hoặc Cmd+Shift+Space trên macOS).

Cách xem các lệnh Gemini trong bảng lệnh:

  1. Mở bảng lệnh bằng cách nhấn Ctrl+Shift+P (hoặc Cmd+Shift+P trên macOS).

  2. Tìm kiếm Gemini.

    Một danh sách các lệnh Gemini sẽ xuất hiện.

Điều chỉnh chế độ cài đặt hoàn thành mã

Để giúp bạn viết mã, Firebase Studio cung cấp tính năng hoàn thành mã bằng AI , dự đoán và tự động điền mã vào mọi tệp đang mở ngay khi bạn bắt đầu nhập.

Xin lưu ý rằng tính năng hoàn thành mã được bật theo mặc định.

Để bật hoặc tắt tính năng hoàn thành mã, hãy điều chỉnh chế độ cài đặt hoàn thành mã bằng một trong những phương thức sau:

  • Nếu bạn sử dụng tệp settings.json, hãy đặt "IDX.aI.enableInlineCompletion" thành true hoặc false.

  • Cách cập nhật chế độ cài đặt trong không gian làm việc Firebase Studio:

    1. Nhấp vào Biểu tượng bánh răng Quản lý (nằm ở dưới cùng bên trái của không gian làm việc), sau đó chọn Cài đặt hoặc nhấn Ctrl+, (Cmd+, trên máy Mac).

      Nếu bạn đang sử dụng App Prototyping agent trong Prototyper chế độ xem, hãy nhấp vào Biểu tượng chuyển đổi mã Chuyển sang chế độ xem Code (Mã) để mở chế độ xem Code.

    2. Chọn thẻ Không gian làm việc, sau đó tìm chế độ cài đặt Firebase Studio > AI > Bật tính năng hoàn thành nội tuyến .

    3. Để tắt tính năng hoàn thành mã, hãy bỏ chọn tuỳ chọn Bật tính năng hoàn thành mã nội tuyến khi bạn nhập.

Điều chỉnh chế độ cài đặt lập chỉ mục cơ sở mã

Bạn có thể kiểm soát việc Gemini lập chỉ mục mã của bạn hay không. Việc lập chỉ mục mã sẽ cung cấp kết quả hữu ích hơn khi sử dụng tính năng trò chuyện hoặc hỗ trợ AI nội tuyến.

Xin lưu ý rằng tính năng lập chỉ mục cơ sở mã được bật theo mặc định.

Để bật hoặc tắt tính năng lập chỉ mục mã, hãy điều chỉnh chế độ cài đặt lập chỉ mục cơ sở mã bằng một trong những phương thức sau:

  • Nếu bạn sử dụng tệp settings.json, hãy đặt "IDX.aI.enableCodebaseIndexing" thành true hoặc false.

  • Cách cập nhật chế độ cài đặt trong không gian làm việc Firebase Studio:

    1. Nhấp vào Biểu tượng bánh răng Quản lý (nằm ở dưới cùng bên trái của không gian làm việc), sau đó chọn Cài đặt hoặc nhấn Ctrl+, (Cmd+, trên máy Mac).

      Nếu bạn đang sử dụng App Prototyping agent trong Prototyper chế độ xem, hãy nhấp vào Biểu tượng chuyển đổi mã Chuyển sang chế độ xem Code (Mã) để mở chế độ xem Code.

    2. Chọn thẻ Không gian làm việc, sau đó tìm chế độ cài đặt Firebase Studio > AI > Bật tính năng hoàn thành nội tuyến.

    3. Chọn Firebase Studio > AI: Bật tính năng lập chỉ mục cơ sở mã .

    4. Để tắt tính năng lập chỉ mục mã, hãy bỏ chọn AI: Bật tính năng lập chỉ mục cơ sở mã. Bạn phải cập nhật chế độ cài đặt lập chỉ mục mã cho từng không gian làm việc.

Tuỳ chỉnh hướng dẫn cho Gemini bằng tệp quy tắc AI

Bạn có thể thêm thông tin về ngữ cảnh và lời nhắc hệ thống bằng cách tạo tệp quy tắc AI:

  • Gemini CLI chỉ sử dụng GEMINI.md.
  • Tính năng trò chuyện của Gemini ưu tiên .idx/airules.md nhưng sẽ sử dụng GEMINI.md nếu .idx/airules.md không tồn tại.

Gemini sử dụng các quy tắc của bạn làm hướng dẫn và ngữ cảnh hệ thống, tuỳ chỉnh câu trả lời cho trường hợp sử dụng của bạn.

Sử dụng tệp quy tắc AI để chia sẻ lời nhắc tuỳ chỉnh, các phương pháp hay nhất và thậm chí cả ngữ cảnh quan trọng về dự án của bạn với Gemini để đạt được các mục tiêu như:

  • Tác động đến tính cách của Gemini và chuyên môn hoá kiến thức chuyên môn của AI.
  • Áp dụng các tiêu chuẩn trên toàn dự án, chẳng hạn như kiểu mã hoá, quy ước và lựa chọn ưu tiên về công nghệ.
  • Giảm lượng thông tin bạn cần chia sẻ một cách rõ ràng trong mã hoặc cuộc trò chuyện bằng cách cung cấp ngữ cảnh cần thiết về dự án của bạn.

Tạo và kiểm thử tệp quy tắc AI

Cách tạo và kiểm thử tệp quy tắc AI:

  1. Tạo một tệp mới tại ~/GEMINI.md (cho Gemini CLI) hoặc .idx/airules.md (cho tính năng trò chuyện của Gemini) trong không gian làm việc Firebase Studio. Bạn có thể sử dụng một trong những lựa chọn sau:

    • Trong Explorer (Ctrl+Shift+E), hãy nhấp chuột phải vào thư mục mẹ rồi chọn Tệp mới. Đặt tên cho tệp rồi nhấn Enter.
    • Trong thiết bị đầu cuối, hãy sử dụng trình chỉnh sửa văn bản mà bạn muốn để mở GEMINI.md hoặc .idx/airules.md.

  2. Thêm nội dung vào tệp. Bạn có thể muốn thêm thông tin về tính cách mà Gemini nên sử dụng (chẳng hạn như "Bạn là một nhà phát triển chuyên nghiệp và trợ lý hữu ích, biết mọi thứ về Next.js"), các tiêu chuẩn về mã hoá và cuộc trò chuyện, cũng như ngữ cảnh về dự án. Hãy xem Ví dụ sau đây để biết ví dụ về tệp quy tắc AI.

  3. Lưu tệp và mở Gemini CLI hoặc Gemini.

  4. Để bắt đầu sử dụng quy tắc AI, bạn có thể làm theo một trong những cách sau:

    • Tạo lại không gian làm việc bằng cách làm mới trang. Sau khi bạn tạo lại, Gemini sẽ sử dụng tệp quy tắc trong cuộc trò chuyện. Các thay đổi đối với tệp quy tắc AI sẽ được phản ánh ngay lập tức.
    • Nếu không muốn tạo lại không gian làm việc, bạn có thể hỏi Gemini để load GEMINI.md hoặc load airules.md. Nếu bạn thay đổi tệp trong phiên hiện tại, bạn có thể cần nhắc lại Gemini để tải lại tệp quy tắc.

  5. Đặt câu hỏi về mã của bạn. Gemini phản hồi bằng thông tin mà bạn đưa vào tệp quy tắc làm ngữ cảnh.

Ví dụ

Sau đây là một ví dụ cơ bản về tệp quy tắc mà bạn có thể sử dụng cho một trò chơi thông thường được phát triển bằng 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.

Loại trừ tệp khỏi Gemini bằng tệp .aiexclude

Bạn có thể kiểm soát những tệp trong cơ sở mã của mình cần được ẩn khỏi Gemini bằng cách đưa tệp .aiexclude vào dự án. Điều này cho phép bạn kiểm soát chi tiết ngữ cảnh dự án mà bạn chia sẻ với Gemini.

Tương tự như tệp .gitignore, tệp .aiexclude theo dõi các tệp không được chia sẻ với Gemini, bao gồm cả trải nghiệm trò chuyện cũng như các tính năng AI hoạt động trong trình chỉnh sửa. Tệp .aiexclude hoạt động trên các tệp trong hoặc dưới thư mục chứa tệp đó.

Các tệp được .aiexclude bao gồm sẽ không được Gemini lập chỉ mục khi Lập chỉ mục cơ sở mã được bật. Ngoài ra, .aiexclude sẽ ảnh hưởng đến tính năng hỗ trợ cùng dòng cho các tệp được bao gồm theo những cách sau:

  • Hỗ trợ trò chuyện: Gemini sẽ không thể trả lời câu hỏi hoặc đưa ra đề xuất về các tệp được .aiexclude bao gồm.
  • Hoàn thành mã: Đề xuất hoàn thành mã sẽ không có sẵn khi chỉnh sửa các tệp được bao gồm.
  • Hỗ trợ nội tuyến: Bạn có thể tạo mã mới nhưng không thể sửa đổi mã hiện có khi chỉnh sửa các tệp được bao gồm.

Các môi trường phát triển khác như Android Studio cũng có thể tuân theo tệp .aiexclude

Cách viết tệp .aiexclude

Tệp .aiexclude tuân theo cùng cú pháp như tệp .gitignore, với những điểm khác biệt sau:

  • Tệp .aiexclude trống sẽ chặn tất cả các tệp trong thư mục và tất cả các thư mục con. Điều này giống như một tệp chứa **/*.
  • Tệp .aiexclude không hỗ trợ phủ định (tiền tố mẫu bằng !).

Ví dụ

Sau đây là một số ví dụ về cấu hình tệp .aiexclude:

  • Chặn tất cả các tệp có tên apikeys.txt trong hoặc dưới thư mục chứa tệp .aiexclude:

    apikeys.txt

  • Chặn tất cả các tệp có đuôi tệp .key trong hoặc dưới thư mục chứa tệp .aiexclude:

    *.key

  • Chỉ chặn tệp apikeys.txt trong cùng thư mục với .aiexclude, nhưng không chặn bất kỳ thư mục con nào:

    /apikeys.txt

  • Chặn tất cả các tệp trong thư mục my/sensitive/dir và tất cả các thư mục con. Đường dẫn phải tương ứng với thư mục chứa tệp .aiexclude:

    my/sensitive/dir/

Mang khoá của riêng bạn: Sử dụng các mô hình Gemini khác trong cuộc trò chuyện

Bạn có thể định cấu hình mô hình Gemini mà Gemini trò chuyện sử dụng. Bạn có thể chọn mô hình tích hợp, các mô hình được định cấu hình trong cửa sổ trò chuyện hoặc bất kỳ Gemini mô hình nào mà bạn có quyền truy cập.

Để biết danh sách tất cả các mô hình có sẵn, hãy xem bài viết Gemini mô hình.

Cách định cấu hình khoá và chọn một mô hình Gemini khác:

  1. Trong không gian làm việc đang mở, hãy nhấp vào biểu tượng tia lửa Gemini ở cuối không gian làm việc (hoặc thẻ Gemini).

  2. Trong cửa sổ trò chuyện Gemini, hãy nhấp vào Biểu tượng Cài đặt AI Cài đặt AI. Cài đặt người dùng sẽ xuất hiện.

  3. Trong trường IDX > AI: Khoá API Gemini, hãy nhập khoá Gemini API của bạn.

  4. Trong trình đơn thả xuống IDX > AI: Nhà cung cấp mô hình, hãy chọn Gemini API.

Giờ đây, bạn có thể chọn bất kỳ mô hình Gemini nào được định cấu hình sẵn trong cuộc trò chuyện.

Cách định cấu hình mô hình Gemini không có trong trình đơn thả xuống:

  1. Xác định mô hình Gemini mà bạn muốn sử dụng trong cuộc trò chuyện trong danh sách tại Gemini mô hình. Ví dụ: bạn sẽ nhập gemini-3-pro-preview để sử dụng mô hình xem trước Gemini 3 Pro.

  2. Trong cửa sổ trò chuyện Gemini, hãy nhấp vào bộ chọn mô hình, sau đó chọn Mã mô hình tuỳ chỉnh. Cài đặt người dùng sẽ mở ra.

  3. Sao chép tên mô hình bạn đã chọn vào trường IDX > AI: Mô hình Gemini.

  4. Đóng cửa sổ trò chuyện, sau đó mở lại bằng cách nhấp vào biểu tượng tia lửa Gemini ở cuối không gian làm việc để làm mới danh sách mô hình.

Tuỳ chỉnh Gemini CLI

  • Cài đặt: Tạo tệp .gemini/settings.json để thay đổi giao diện, bật hoặc tắt tính năng thu thập số liệu thống kê về mức sử dụng, điều chỉnh các công cụ mà Gemini CLI có quyền truy cập, định cấu hình tính năng kiểm tra điểm kiểm tra và nhiều tính năng khác.
  • Cài đặt: Xem Gemini CLI tài liệu để biết thêm thông tin về cách điều chỉnh chế độ cài đặt.
  • Biến môi trường: Gemini CLI tự động tải các biến môi trường từ tệp .env. Đây là nơi bạn nên lưu trữ GEMINI_API_KEY (bắt buộc), cũng như tuỳ chọn đưa vào mô hình Gemini mà bạn muốn sử dụng, Mã dự án Google Cloud và nhiều thông tin khác.
  • Hướng dẫn: Để điều chỉnh ngữ cảnh mà Gemini CLI sử dụng khi làm theo hướng dẫn, hãy tạo tệp GEMINI.md. Điều này cho phép bạn đưa ra hướng dẫn dành riêng cho dự án, hướng dẫn về kiểu mã hoá hoặc thông tin cơ bản có liên quan cho Gemini, giúp câu trả lời của AI phù hợp và chính xác hơn với nhu cầu của bạn. Xin lưu ý rằng việc tạo tệp này sẽ cung cấp cùng một hướng dẫn cho Gemini, trừ phi bạn cũng tạo tệp .idx/airules.md (trong trường hợp đó, Gemini CLI sẽ sử dụng GEMINI.md và Gemini sẽ sử dụng airules.md).

Xem tài liệu về Gemini CLI để biết thêm thông tin về cách điều chỉnh chế độ cài đặt, biến môi trường và hướng dẫn.

Các bước tiếp theo