Thiết lập Gemini trong Firebase 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 hỗ trợ AI sau đây:

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

• Trợ lý AI hỗ trợ tính năng trò chuyện, tính năng này nhận biết được không gian làm việc và tích hợp đầy đủ với mã của bạn. Công cụ này có thể tạo, dịch và giải thích mã. Sau khi bạn xem xét và phê duyệt, Gemini trong Firebase 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 dòng lệnh, diễn giải kết quả lệnh và xác định các bước tiếp theo. Tìm hiểu thêm tại bài viết Thử trò chuyện với Gemini.

• 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 giúp mã đã chọn dễ đọc hơn.

• Trợ giúp mã cùng dòng.

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

• Điều chỉnh chế độ cài đặt tính năng hoàn thành mã.
• Điều chỉnh chế độ cài đặt lập chỉ mục cơ sở mã.
• Tuỳ chỉnh hướng dẫn cho Gemini bằng tệp quy tắc AI.
• Loại trừ tệp khỏi Gemini bằng tệp .aiexclude.
• Sử dụng khoá của riêng bạn: Sử dụng các mô hình Gemini khác trong cuộc trò chuyện

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

Sử dụng Gemini trong Firebase để tăng năng suất lập trình thông qua tính năng hỗ trợ bảng trò chuyện hoặc mã cùng dòng.

1. Sử dụng tính năng hỗ trợ trò chuyện hoặc mã cùng dòng trong workspace:

   • 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 tính năng hỗ trợ mã cùng dòng: Bắt đầu nhập mã và nhấn Tab để chấp nhận các đề xuất.

2. Xin lưu ý rằng hai tuỳ 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ã, giúp bạn tuỳ chỉnh tốt hơn và nhận được các 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:

   • Để cập nhật chế độ cài đặt tính năng hoàn thành mã, hãy xem phần Điều chỉnh chế độ cài đặt tính năng hoàn thành mã.
   • Để cập nhật chế độ cài đặt lập chỉ mục mã, hãy xem phần Điều chỉnh chế độ cài đặt lập chỉ mục mã.

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

Gemini trong lối tắt Firebase

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

Cách xem các lệnh Gemini từ 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 Gemini.

   Danh sách các lệnh Gemini sẽ xuất hiện.

Điều chỉnh chế độ cài đặt tính năng 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ã AI dự đoán và tự động điền mã trong 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 tất mã được bật theo mặc định.

Để bật hoặc tắt tính năng tự động hoàn thành mã, hãy điều chỉnh chế độ cài đặt tính năng tự động hoàn thành mã bằng một trong các 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 Quản lý (ở 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 view, click Switch to Code to open Code view.

  2. Chọn thẻ Workspace (Không gian làm việc), sau đó tìm chế độ cài đặt Firebase Studio > AI > Enable Inline Completion (Firebase Studio > AI > Bật tính năng hoàn thành cùng dòng).

  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ã cùng dòng 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 có 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 bạn sử dụng tính năng hỗ trợ trò chuyện hoặc hỗ trợ AI cùng dòng.

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 các 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 Quản lý (ở 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 view, click Switch to Code to open Code view.

  2. Chọn thẻ Workspace (Không gian làm việc), sau đó tìm chế độ cài đặt Firebase Studio > AI > Enable Inline Completion (Firebase Studio > AI > Bật tính năng hoàn thành cùng dòng).

  3. Chọn Firebase Studio > AI: Enable Codebase Indexing (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: Enable Codebase Indexing (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 trong Firebase 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 của hệ thống bằng cách tạo tệp quy tắc AI (.idx/airules.md). Gemini trong Firebase sử dụng các quy tắc của bạn làm hướng dẫn và ngữ cảnh của hệ thống, đảm bảo rằng các câu trả lời của Gemini được tuỳ chỉnh cho trường hợp sử dụng của bạn.

Sử dụng tệp quy tắc AI để chia sẻ câu lệnh tuỳ chỉnh, các phương pháp hay nhất và thậm chí là 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ư:

• Ảnh hưởng đến tính cách của Gemini và chuyên môn của nó.
• Áp dụng các tiêu chuẩn trên toàn dự án, chẳng hạn như kiểu lập trình, 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ẻ rõ ràng trong mã hoặc cuộc trò chuyện bằng cách cung cấp bối cảnh cần thiết về dự án của bạn.

Các quy tắc mà bạn định cấu hình sẽ được Gemini sử dụng trong tính năng trò chuyệ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 .idx/airules.md trong không gian làm việc Firebase Studio (trong cùng thư mục với tệp dev.nix). Bạn có thể sử dụng một trong các tuỳ chọn sau:

   • Trong Explorer (Trình khám phá) (Ctrl+Shift+E), hãy nhấp chuột phải vào .idx rồi chọn New file (Tệp mới). Đặt tên tệp là airules.md rồi nhấn Enter.
   • Trên 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ở .idx/airules.md.

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

3. Lưu tệp và mở Gemini trong Firebase.

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 trong Firebase 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 trong cuộc trò chuyện.
   • Nếu không muốn tạo lại không gian làm việc, bạn có thể hỏi Gemini bằng cách trò chuyện với load airules.md. Nếu thực hiện thay đổi đối vớ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 cách sử dụ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à 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 giải trí đượ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 nào trong cơ sở mã sẽ bị ẩn khỏi Gemini bằng cách đưa các 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 ở hoặc dưới thư mục chứa tệp đó.

Các tệp thuộc phạm vi của .aiexclude sẽ không được Gemini lập chỉ mục khi bạn bật tính năng Lập chỉ mục cơ sở mã. 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 bảo hiểm theo những cách sau:

• Hỗ trợ qua tính năng 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 thuộc phạm vi của .aiexclude.
• Hoàn tất mã: Tính năng hoàn tất mã được đề xuất sẽ không hoạt động khi chỉnh sửa các tệp được bao phủ.
• Hỗ trợ cùng dòng: 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 bảo vệ.

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

Cách viết tệp .aiexclude

Tệp .aiexclude tuân theo cú pháp giống 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ả tệp trong thư mục và tất cả thư mục con. Điều này cũng giống như một tệp chứa **/*.
• Tệp .aiexclude không hỗ trợ phủ định (đặt tiền tố cho mẫu bằng !).

Ví dụ

Dưới đây là một số cấu hình tệp .aiexclude mẫu:

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

  apikeys.txt
  

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

  *.key
  

• Chỉ chặn tệp apikeys.txt ở 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ả tệp trong thư mục my/sensitive/dir và tất 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 theo 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 trong cuộc trò chuyện Firebase sử dụng. Bạn có thể chọn mô hình tích hợp, mô hình được định cấu hình trong cửa sổ trò chuyện (bao gồm cả mô hình Gemini 2.5) hoặc bất kỳ mô hình Gemini nào mà bạn có quyền truy cập.

Để biết danh sách tất cả các mô hình hiện có, hãy xem mô hình Gemini.

Để đị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 trong Firebase, hãy nhấp vào trình đơn thả xuống tên mô hình, sau đó nhấp vào đường liên kết phím Gemini API. Cài đặt người dùng sẽ xuất hiện.

3. Trong trường IDX > AI: Gemini Api Key (IDX > AI: Khoá Gemini API), hãy nhập khoá 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 tính năng trò chuyện.

Để đị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 tính năng trò chuyện từ danh sách tại mô hình Gemini. Ví dụ: bạn sẽ nhập gemini-2.0-flash-lite để sử dụng mô hình Gemini 2.0 Flash‑Lite ổn định mới nhất.

2. Trong cửa sổ trò chuyện Gemini trong Firebase, 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 mà bạn đã chọn vào trường IDX > AI: Gemini Model (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.

Các bước tiếp theo

• Dùng thử Gemini trong Firebase.