Đị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 lập trình sử dụng AI sau đây:

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

• Trợ lý AI có tính năng trò chuyện, nhận biết không gian làm việc và tích hợp đầy đủ với mã của bạn. Gemini 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ể tương tác trực tiếp với không gian làm việc của bạn để cập nhật tệp, chạy lệnh trong dòng lệnh, diễn giải kết quả 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 dòng 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 đoạn mã đã chọn dễ đọc hơn.

• Trợ giúp lập trình cùng dòng.

Quan trọng: Hướng dẫn này mô tả cuộc trò chuyện tương tác mặc định của Gemini. Các ứng dụng được tạo bằng App Prototyping agent sẽ mặc định sử dụng chế độ xem cuộc trò chuyện Prototyper trong Code. Để sử dụng Gemini cuộc trò chuyện tương tác, trong mục Gemini, hãy nhấp vào +, sau đó chọn Cuộc trò chuyện mới. Để quay lại cuộc trò chuyện với Prototyper, hãy nhấp vào Cuộc trò chuyện gần đây, rồi chọn Cuộc trò chuyện với Prototyper. Để biết thông tin về tính năng trò chuyện của Prototyper, hãy xem bài viết Bắt đầu sử dụng App Prototyping agent.

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:

• Đ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 toàn bộ mã nguồn.
• Tuỳ chỉnh chỉ dẫn cho Gemini bằng tệp quy tắc AI.
• Loại trừ tệp khỏi Gemini bằng .aiexclude tệp.
• Sử dụng khoá của riêng bạn: Dùng các mô hình Gemini khác trong cuộc trò chuyện
• Điều chỉnh cách Gemini đề xuất hoặc áp dụng các thay đổi về mã xử lý ứng dụng.

Quan trọng: Gemini có thể tạo ra kết quả có vẻ hợp lý nhưng thực tế lại không chính xác. Công cụ này có thể đưa ra thông tin không chính xác và không thể hiện quan điểm của Google. Xác thực tất cả kết quả từ Gemini trước khi sử dụng và không sử dụng mã được tạo chưa qua kiểm thử trong môi trường thực tế. Đừng nhập thông tin nhận dạng cá nhân (PII) hoặc dữ liệu người dùng vào cuộc trò chuyện.

Sử dụng Gemini trong không gian làm việc của bạn

Sử dụng Gemini để nâng cao 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 trợ giúp mã cùng dòng.

Lưu ý: Nếu bạn đang sử dụng App Prototyping agent trong chế độ xem Prototyper, hãy nhấp vào Switch to Code (Chuyển sang chế độ xem Mã) để mở chế độ xem Code.

1. Sử dụng tính năng hỗ trợ lập trình cùng dòng hoặc trò chuyện trong không gian làm việc của bạn:

   • 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 spark Gemini ở cuối không gian làm việc.

   • Cách sử dụng tính năng trợ giúp lập trình cùng dòng: Bắt đầu nhập mã và nhấn phím Tab để chấp nhận đề 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 toàn bộ mã nguồn, giúp tuỳ chỉnh tốt hơn và đưa ra 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ừ các tệp và thư mục cụ thể khỏi quá trình lập chỉ mục của AI. Xem phần Loại trừ tệp khỏi Gemini bằng tệp .aiexclude.

Gemini lối tắt

Để mở nhanh cuộc trò chuyện với Gemini: hãy nhấn tổ hợp phím 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.

   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ã bằng AI, giúp dự đoán và tự động điền mã vào bất kỳ tệp nào đ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 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 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ý (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 chế độ xem Prototyper, hãy nhấp vào Chuyển sang chế độ xem Mã để mở chế độ xem Code.

  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 (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 Enable inline code completion as you type (Bật tính năng hoàn thành mã cùng dòng khi bạn nhập).

Mẹo: Để giữ lại chế độ cài đặt này trên tất cả không gian làm việc, hãy định cấu hình chế độ cài đặt này trong thẻ User (Người dùng). Việc này đảm bảo rằng chế độ cài đặt của bạn được áp dụng cho mọi không gian làm việc mà bạn truy cập bằng tài khoản người dùng của mình. Nếu chia sẻ không gian làm việc, bạn vẫn cần định cấu hình chế độ cài đặt Không gian làm việc.

Điều chỉnh chế độ cài đặt lập chỉ mục toàn bộ mã nguồn

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 trò chuyện hoặc trợ giúp 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.

Lưu ý: Bạn có thể kiểm soát những tệp mà Gemini lập chỉ mục. Tìm hiểu thêm tại bài viết Loại trừ tệp khỏi Gemini bằng tệp .aiexclude.

Để 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 toàn bộ mã nguồn 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ý (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 chế độ xem Prototyper, hãy nhấp vào Chuyển sang chế độ xem Mã để mở chế độ xem Code.

  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 (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 toàn bộ mã nguồn).

  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.

Mẹo: Để giữ lại chế độ cài đặt này trên tất cả không gian làm việc, hãy định cấu hình chế độ cài đặt này trong thẻ User (Người dùng). Việc này đảm bảo rằng chế độ cài đặt của bạn được áp dụng cho mọi không gian làm việc mà bạn truy cập bằng tài khoản người dùng của mình. Nếu chia sẻ không gian làm việc, bạn vẫn cần định cấu hình chế độ cài đặt Không gian làm việc.

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

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

Gemini chat prioritizes .idx/airules.md but will use GEMINI.md if .idx/airules.md doesn't exist.

Gemini sử dụng các quy tắc của bạn làm chỉ dẫn và bối cảnh hệ thống, tuỳ chỉnh câu trả lời cho phù hợp với 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à bối 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 của mô hình này.
• Á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 trò chuyện bằng cách cung cấp bối cảnh thiết yếu 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 tra tệp quy tắc AI:

1. Tạo một tệp mới tại .idx/airules.md (hoặc GEMINI.md) trong không gian làm việc Firebase Studio của bạn. Bạn có thể sử dụng một trong các lựa chọn sau:

   • Trong Explorer (Trình khám phá) (Ctrl+Shift+E), hãy nhấp chuột phải vào thư mục mẹ rồi chọn New file (Tệp mới). Đặt tên tệp rồi nhấn phím Enter.
   • Trong cửa sổ dòng lệnh, hãy 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 nên thêm thông tin về vai trò mà Gemini nên đảm nhận (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ề lập trình và trò chuyện, cũng như bối 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 rồi mở Gemini.

4. Để bắt đầu sử dụng các 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ó hiệu lực 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ể yêu cầu 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 phải 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 sẽ trả lời dựa trên thông tin bạn đưa vào tệp quy tắc làm bối cảnh.

   Gemini sẽ sử dụng (theo thứ tự ưu tiên) .idx/airules.md, GEMINI.md, .gemini/styleguide.md, AGENTS.md hoặc cursorrules.

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 phổ 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.

Mẹo: Các quy tắc AI góp phần vào kích thước ngữ cảnh tổng thể, vì vậy, bạn nên giữ tệp quy tắc AI trong giới hạn hợp lý để đảm bảo hiệu suất mô hình tốt nhất.

Loại trừ tệp khỏi Gemini có .aiexclude tệp

Bạn có thể kiểm soát những tệp nào trong toàn bộ mã nguồn của mình sẽ bị ẩn khỏi Gemini bằng cách đưa các tệp .aiexclude vào dự án của bạn. Nhờ đó, bạn có thể kiểm soát chặt chẽ bối 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 những tệp không nên 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 tại hoặc bên dưới thư mục chứa tệp đó.

Lưu ý: Các tệp bị tệp .gitignore bỏ qua trong kho lưu trữ của bạn sẽ tự động bị loại trừ, ngay cả khi không có trong tệp .aiexclude.

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 toàn bộ mã nguồn. Ngoài ra, .aiexclude sẽ ảnh hưởng đến tính năng hỗ trợ cùng dòng cho các tệp thuộc phạm vi áp dụng theo những cách sau:

• Hỗ trợ qua cuộc 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 thành mã: Bạn sẽ không thấy các đề xuất hoàn thành mã khi chỉnh sửa các tệp được đề cập.
• 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 hỗ trợ.

Các môi trường phát triển khác như Android Studio cũng có thể tuân thủ 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 của tệp đó 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 (thêm tiền tố ! vào mẫu).

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 tại hoặc bên 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 tại hoặc bên 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 thư mục con:

  /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/
  

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

Thử nghiệm: Tính năng này đang trong giai đoạn thử nghiệm.

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

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

Quan trọng: Các chế độ cài đặt của Firebase Studio AI là chế độ cài đặt dành cho Người dùng. Điều này có nghĩa là các chế độ cài đặt này sẽ được giữ nguyên cho bạn trên nhiều máy trạm.

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 spark Gemini ở cuối không gian làm việc (hoặc thẻ Gemini).

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

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

   Lưu ý: Trường này có thể đã được điền sẵn nếu bạn sử dụng App Prototyping agent và công cụ này đã tạo một dự án Firebase và khoá Gemini API cho bạn.

4. Trong trình đơn thả xuống IDX > AI: Model Provider (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ột mẫu 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 từ danh sách tại mô hình Gemini. Ví dụ: bạn sẽ nhập gemini-3-pro-preview để sử dụng mô hình Gemini 3 Pro Preview ở giai đoạn xem trước.

2. Trong cửa sổ trò chuyện của Gemini, hãy nhấp vào bộ chọn mô hình, sau đó chọn Mã mô hình tuỳ chỉnh. Mục 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.

Các bước tiếp theo

• Dùng thử Gemini.