Thêm Cloud Firestore và Xác thực vào ứng dụng Google AI Studio

Chế độ Xây dựng trong Google AI Studio có thể tự động thiết lập và tích hợp Cloud Firestore và Firebase Authentication vào các ứng dụng web, giúp bạn dễ dàng xây dựng ứng dụng có bộ nhớ lưu trữ dữ liệu liên tục và quy trình đăng nhập an toàn. Chỉ với một câu lệnh và vài cú nhấp chuột, bạn có thể cho phép tác nhân Google AI Studio thiết lập một dự án Firebase, kết nối ứng dụng của bạn với dự án đó và tạo tất cả mã Cloud Firestore và mã Authentication trực tiếp trong ứng dụng.

Tổng quan: Thêm phần phụ trợ vào ứng dụng Google AI Studio

1. Mô tả ý tưởng: Tạo một ứng dụng mới trong Google AI Studio và mô tả một tính năng yêu cầu cơ sở dữ liệu hoặc xác thực. Ví dụ: bạn có thể nhập câu lệnh: Build a shared to-do list app using Firebase as a backend. (Xây dựng ứng dụng danh sách việc cần làm được chia sẻ bằng Firebase làm phần phụ trợ).

2. Bật tính năng tích hợp Firebase: Trong thẻ xuất hiện, bạn có thể tuỳ chỉnh quy trình thiết lập:

   • Chọn một vị trí (không bắt buộc): Chọn vị trí cho cơ sở dữ liệu và ứng dụng của bạn bằng cách sử dụng trình đơn thả xuống vị trí.
   • Chọn một dự án (không bắt buộc): Nhấp vào biểu tượng Cài đặt icon settings, chọn Google Cloud dự án bạn muốn sử dụng, sau đó nhấp vào Lưu.
   • Xác nhận lựa chọn của bạn: Để tiếp tục, hãy nhấp vào nút Bật Firebase.

   Sau đó, tác nhân sẽ tự động kết nối ứng dụng của bạn với dự án Firebase và tạo mã Cloud Firestore và mã Authentication cần thiết, bao gồm cả tệp /src/lib/firebase.ts và tệp firestore.rules.

3. Triển khai: Sau khi sẵn sàng, hãy sử dụng tuỳ chọn Chia sẻ > Xuất bản để triển khai ứng dụng web của bạn lên Cloud Run. Ứng dụng của bạn sẽ tự động triển khai vào cùng một dự án mà bạn đã chọn trong quá trình thiết lập.

Tìm hiểu về hạn mức dùng chung cho Cloud Firestore

Tất cả cơ sở dữ liệu Cloud Firestore do tác nhân Google AI Studio cung cấp đều được đặt trong cùng một "nhóm" cơ sở dữ liệu trong dự án Firebase của bạn. Tất cả đều có những đặc điểm sau:

• Hạn mức dùng chung: Tất cả cơ sở dữ liệu trong nhóm đều dùng chung một hạn mức sử dụng (xem thông tin chi tiết bên dưới).
• Không bắt buộc phải có tài khoản Cloud Billing: Bạn có thể xây dựng và kiểm thử ứng dụng mà không cần thêm thông tin thanh toán. Xem thông tin chi tiết bên dưới về việc tuỳ chọn thêm thông tin thanh toán.
• Đặt lại hằng ngày: Nếu bạn đạt đến hạn mức hằng ngày (ví dụ: 50.000 lượt đọc/ngày), dịch vụ sẽ tạm dừng cho tất cả cơ sở dữ liệu trong nhóm và tiếp tục vào ngày hôm sau vào khoảng nửa đêm theo Giờ Thái Bình Dương.

Cloud Firestore cơ sở dữ liệu trong nhóm hạn mức dùng chung có các giới hạn sau:

(Không bắt buộc) Thêm thông tin thanh toán để có thêm hạn mức Cloud Firestore

Nếu ứng dụng của bạn thu hút được sự chú ý và bạn cần vượt quá hạn mức không mất phí cho Cloud Firestore, bạn có thể nâng cấp dự án lên gói giá Blaze (trả tiền theo mức dùng).

1. Thêm thông tin thanh toán (nếu bạn chưa thực hiện): Chuyển đến Firebase bảng điều khiển và liên kết một tài khoản thanh toán với dự án của bạn.

2. Nâng cấp cơ sở dữ liệu: Theo mặc định, cơ sở dữ liệu Cloud Firestore do tác nhân Google AI Studio tạo sẽ tiếp tục sử dụng hạn mức dùng chung ngay cả sau khi bạn nâng cấp gói giá. Để bật tính năng mở rộng quy mô có tính phí đầy đủ cho một cơ sở dữ liệu cụ thể, bạn phải di chuyển cơ sở dữ liệu đó ra khỏi nhóm theo cách thủ công bằng lệnh curl.

   • PROJECT_ID : Mã dự án Firebase; tìm mã này trong phần Cài đặt dự án của bảng điều khiển Firebase.

   • DATABASE_ID : Mã cơ sở dữ liệu Cloud Firestore, mã này sẽ khớp với mã ứng dụng nhỏ của bạn; tìm mã cơ sở dữ liệu này trong cột Tên trên trang cơ sở dữ liệu Cloud Firestore trong bảng điều khiển Firebase.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
   -d '{"free_tier_limited": false}'
   

Security Rules thế hệ

Tác nhân Google AI Studio tự động tạo Firebase Security Rules dựa trên logic của ứng dụng. Các Security Rules này được thiết kế để "từ chối theo mặc định", nghĩa là người dùng cuối của ứng dụng chỉ có thể truy cập vào dữ liệu mà họ sở hữu.

Xin lưu ý rằng nếu bạn điều chỉnh Security Rules theo cách thủ công ngay trong bảng điều khiển Firebase, thì tác nhân Google AI Studio sẽ không biết về các thay đổi đó, và các thay đổi này sẽ bị ghi đè trong các lần lặp lại ứng dụng tiếp theo. Bạn nên sử dụng tác nhân Google AI Studio để điều chỉnh Firebase Security Rules nhằm đảm bảo các thay đổi của bạn được giữ nguyên và phù hợp với logic của ứng dụng.

Sử dụng dự án hiện có

Khi bật tính năng tích hợp Firebase lần đầu tiên, bạn có thể chọn một dự án Google Cloud hiện có mà bạn sở hữu (không bắt buộc):

1. Trong thẻ bật lên, hãy nhấp vào biểu tượng Cài đặt icon settings.
2. Chọn dự án của bạn, sau đó nhấp vào Lưu.

Khi lặp lại ứng dụng, bạn cũng có thể hướng dẫn tác nhân sử dụng một dự án khác bằng một câu lệnh như:

Add Firestore to this app using project PROJECT_ID.

Khi bạn chọn một dự án, các thao tác sau sẽ diễn ra:

• Một cơ sở dữ liệu Cloud Firestore mới sẽ được cung cấp vào dự án đó bằng hạn mức dùng chung.
• Firebase Authentication với tính năng Đăng nhập bằng Google sẽ được định cấu hình.
• Một tài khoản dịch vụ sẽ được cấp quyền truy cập vào cơ sở dữ liệu Cloud Firestore của bạn. Để cho phép quyền truy cập của quản trị viên từ Google AI Studio, một tài khoản dịch vụ mới có tên là ais-sandbox@PROJECT_ID.iam.gservice.com sẽ được cấp quyền truy cập vào cơ sở dữ liệu Cloud Firestore của bạn. Tài khoản này chỉ được liên kết với các ứng dụng Google AI Studio của bạn.
• Giới hạn: Nếu dự án Firebase đã có Cloud Firestore cơ sở dữ liệu, thì tác nhân sẽ không thể thêm một cơ sở dữ liệu khác. Bạn cần chọn một dự án khác hoặc tạo một dự án mới, trống để sử dụng.

Sử dụng bảng điều khiển Firebase

Bạn có thể xem dữ liệu và chế độ cài đặt của ứng dụng trong bảng điều khiển Firebase. Để truy cập vào các dự án được liên kết với Google AI Studio, hãy làm theo các bước sau:

1. Chuyển đến bảng điều khiển Firebase và chọn dự án có nhãn AI Studio.
2. Trong ngăn điều hướng bên trái, hãy nhấp vào Xây dựng > Cloud Firestore Cơ sở dữ liệu để xem và chỉnh sửa dữ liệu trong Cloud Firestore, hoặc nhấp vào Xây dựng > Authentication để định cấu hình chế độ cài đặt và dữ liệu Authentication.

Khắc phục sự cố và câu hỏi thường gặp

Tìm câu trả lời cho các câu hỏi thường gặp và tìm hiểu cách giải quyết vấn đề khi tích hợp Firebase với ứng dụng Google AI Studio.

Google Cloud / Dự án và vị trí Firebase của tôi được chọn như thế nào?

Khi yêu cầu phần phụ trợ Firebase cho một ứng dụng, bạn có thể chọn một vị trí và dự án trong thẻ xuất hiện (không bắt buộc):

• Chọn một vị trí (không bắt buộc): Chọn vị trí cho cơ sở dữ liệu và ứng dụng của bạn bằng cách sử dụng trình đơn thả xuống vị trí.
• Chọn một dự án (không bắt buộc): Nhấp vào biểu tượng Cài đặt settings, chọn Google Cloud dự án mà bạn muốn sử dụng, sau đó nhấp vào Lưu.

Hãy ghi nhớ những điều sau:

• Vị trí cơ sở dữ liệu là vĩnh viễn: Sau khi chọn một vị trí cho cơ sở dữ liệu, bạn không thể thay đổi vị trí đó cho dự án đó. Lựa chọn này sẽ được sử dụng làm lựa chọn mặc định cho các dịch vụ phụ trợ khác.
• Tính nhất quán của dự án: Để đảm bảo quá trình tích hợp liền mạch, Google AI Studio sẽ tự động sử dụng cùng một dự án cho cả phần phụ trợ và quá trình triển khai. Bạn không thể sử dụng các dự án khác nhau cho các dịch vụ khác nhau trong cùng một ứng dụng.

Những phương thức xác thực nào được hỗ trợ?

Tác nhân Google AI Studio thiết lập tính năng Đăng nhập bằng Google khi bạn yêu cầu thiết lập Authentication. Để thiết lập các phương thức bổ sung, hãy bật các phương thức đó trong bảng điều khiển Firebase và yêu cầu tác nhân Google AI Studio hỗ trợ cập nhật cơ sở mã của bạn.

Tôi có thể tạo ứng dụng di động (như Android hoặc iOS) bằng Google AI Studio không?

Hiện tại, tác nhân Google AI Studio chỉ có thể tạo ứng dụng web. Tìm hiểu thêm về những nội dung được hỗ trợ trong tài liệu về tác nhân Google AI Studio.

Tuy nhiên, xin lưu ý rằng giống như tất cả ứng dụng web, các ứng dụng do Google AI Studio tạo có thể được truy cập dưới dạng ứng dụng web dành cho thiết bị di động từ các trình duyệt được cài đặt trên thiết bị di động.

Tệp firebase-blueprint.json là gì?

Đây là một tệp trung gian do tác nhân Google AI Studio sử dụng để hiểu cơ sở mã của ứng dụng. Đừng sửa đổi tệp này theo cách thủ công, vì có thể khiến tác nhân tạo mã không chính xác hoặc không an toàn Security Rules.

Tôi nên làm gì nếu gặp lỗi "Đã vượt quá hạn mức"?

Việc đạt đến hạn mức Cloud Firestore có nghĩa là ứng dụng của bạn đã đạt đến hạn mức sử dụng hằng ngày cho nhóm hạn mức dùng chung của cơ sở dữ liệu Cloud Firestore. Có hai cách để giải quyết vấn đề này:

• Cách 1: Chờ: Hạn mức sẽ được đặt lại hằng ngày vào khoảng nửa đêm theo Giờ Thái Bình Dương.
• Cách 2: Nâng cấp: Nâng cấp lên gói giá Blaze (trả tiền theo mức dùng).
  • Nếu tác nhân Google AI Studio thiết lập Cloud Firestore cho bạn, thì sau đó, bạn phải sử dụng lệnh curl được mô tả trong phần Thêm thông tin thanh toán để có thêm hạn mức Cloud Firestore để chuyển cơ sở dữ liệu của bạn sang trạng thái có tính phí thông thường. Nếu bạn thiết lập Cloud Firestore theo cách thủ công, thì không cần chạy lệnh curl.

Tôi nên làm gì nếu gặp lỗi "Thiếu hoặc không đủ quyền"?

Lỗi này xảy ra khi ứng dụng của bạn cố gắng đọc hoặc ghi dữ liệu vào cơ sở dữ liệu Cloud Firestore, nhưng yêu cầu bị Security Rules từ chối. Lỗi này cho biết rằng Security Rules không cho phép thao tác đã thử dựa trên trạng thái xác thực hoặc đường dẫn dữ liệu hiện tại. Nhấp vào nút Khắc phục lỗi để nhắc tác nhân Google AI Studio cố gắng sửa Security Rules.

Điều gì sẽ xảy ra với phần phụ trợ Firebase khi tôi xoá ứng dụng Google AI Studio?

Việc xoá ứng dụng trong Google AI Studio không tự động xoá dự án Firebase, cơ sở dữ liệu Cloud Firestore hoặc cấu hình Firebase Authentication được kết nối.

Nếu đã thêm phần phụ trợ Firebase, bạn phải chuyển đến bảng điều khiển Firebase theo cách thủ công và xoá dự án hoặc dọn dẹp các tài nguyên riêng lẻ (chẳng hạn như thực thể cơ sở dữ liệu Cloud Firestore và nhà cung cấp dịch vụAuthentication) để đảm bảo xoá tất cả dữ liệu và cấu hình.

Tác nhân Google AI Studio có thể xoá hoặc chỉnh sửa dữ liệu trong cơ sở dữ liệu Cloud Firestore của tôi không?

Tác nhân Google AI Studio được thiết kế để giúp cung cấp các tài nguyên phụ trợ cần thiết và tạo mã cũng như Security Rules. Mặc dù bản thân tác nhân không thể trực tiếp xoá, chỉnh sửa hoặc thao tác với các mục nhập dữ liệu trong Cloud Firestore cơ sở dữ liệu, nhưng tác nhân có thể ghi mã vào ứng dụng của bạn được thiết kế để thực hiện các thao tác này. Để thực hiện các tác vụ quản lý dữ liệu, chẳng hạn như xoá các mục nhập, hãy chuyển đến trang cơ sở dữ liệu Cloud Firestore trong bảng điều khiển Firebase.

Tôi thuộc một tổ chức sử dụng Google Cloud; tôi có thể kết nối ứng dụng Google AI Studio của mình với một dự án hiện có trong môi trường Google Cloud của tổ chức không?

Có. Đảm bảo dự án Firebase của bạn được đặt trong thư mục tổ chức Google Cloud của bạn, sau đó kết nối dự án bằng một trong các phương thức sau:

• Trong quá trình bật: Khi bạn bật tính năng tích hợp Firebase lần đầu tiên trong Google AI Studio, hãy chọn dự án hiện có của bạn trong thẻ xuất hiện. Nhấp vào biểu tượng Cài đặt settings, chọn dự án của bạn, sau đó nhấp vào Lưu.

• Trong quá trình lặp lại: Nếu đã bật Firebase hoặc muốn chuyển đổi dự án sau này, bạn có thể hướng dẫn tác nhân sử dụng dự án hiện có của bạn bằng một câu lệnh như:

    Add Firestore to this app using project PROJECT_ID.
  

Tại sao tôi không tìm thấy một số tài liệu trong bảng điều khiển Firebase?

Khi tác nhân AI Studio lưu dữ liệu vào một đường dẫn lồng nhau (như /users/user1/messages/msg1) mà không tạo tài liệu mẹ (user1) trước, tác nhân sẽ tạo ra cái gọi là tài liệu mẹ không tồn tại. Các tài liệu này không xuất hiện trong bảng điều khiển Firebase, khiến bạn khó tìm thấy khi duyệt cơ sở dữ liệu Cloud Firestore. Mặc dù điều này không ảnh hưởng đến cách ứng dụng của bạn chạy, nhưng bạn thường có thể mô tả vấn đề cho tác nhân AI Studio để nhắc tác nhân tạo các tài liệu mẹ bị thiếu.

Để biết thêm thông tin, hãy xem phần Tài liệu mẹ không tồn tại.

Tôi có thể chọn vị trí cho cơ sở dữ liệu Cloud Firestore của mình không?

Có. Khi bật tính năng tích hợp Firebase lần đầu tiên trong Google AI Studio, bạn có thể chọn vị trí cho cơ sở dữ liệu Cloud Firestore.

Xin lưu ý rằng vị trí bạn chọn sẽ áp dụng cho tất cả Cloud Firestore cơ sở dữ liệu mà tác nhân Google AI Studio tạo trong dự án Firebase đó. Sau khi thiết lập, bạn không thể thay đổi vị trí này cho các cơ sở dữ liệu đó.

Google sử dụng dữ liệu của tôi (ví dụ: mã và câu lệnh) trong Google AI Studio như thế nào?

Hãy tham khảo Điều khoản dịch vụ bổ sung của Gemini API để biết thông tin chi tiết về cách dữ liệu của bạn được sử dụng.

Tôi nhận được một email từ Google Cloud về "khoá API Google có thể truy cập công khai cho dự án Google Cloud của bạn". Việc bạn cần làm

Nếu bạn đã nhận được một email từ Google Cloud về "khoá API Google có thể truy cập công khai cho dự án Google Cloud của bạn" và khoá API được liệt kê trong email là khoá API Firebase, thì hãy đảm bảo rằng khoá API đáp ứng các yêu cầu sau để an toàn khi đưa vào mã hoặc tệp cấu hình. Bạn có thể xác minh những thông tin sau trong bảng điều khiển API và Dịch vụ > Thông tin xác thực trong bảng điều khiển Google Cloud.

• Đây là khoá API mà bạn sử dụng cho ứng dụng Firebase và chỉ cho các dịch vụ Firebase. Các khoá này thường được gọi là Browser key (auto created by Firebase) hoặc Android key (auto created by Firebase) hoặc iOS key (auto created by Firebase).
• Khoá này có tất cả các API liên quan đến Firebase bắt buộc có trong danh sách cho phép "Hạn chế API" của khoá.
• Khoá này không có bất kỳ API nào khác trong danh sách cho phép "Hạn chế API" . Cụ thể, danh sách này không được có Generative Language API.

Ngoài ra, hãy đảm bảo rằng bạn đang sử dụng Firebase Security Rules và App Check theo đề xuất cho các sản phẩm Firebase mà bạn sử dụng.

Bạn có thể tìm hiểu thông tin chi tiết về khoá API cho Firebase và tìm danh sách các câu hỏi thường gặp trong phần Tìm hiểu về cách sử dụng và quản lý khoá API cho Firebase