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

Chế độ Build (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 các ứng dụng có bộ nhớ 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à Authentication ngay trong ứng dụng của bạn.

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

1. Mô tả ý tưởng của bạn: 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 phải có 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.

2. Bật tính năng tích hợp Firebase: Khi được tác nhân nhắc, hãy bật Firebase, chọn vị trí cho dự án của bạn và chấp nhận Điều khoản của 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à Authentication cần thiết cho ứng dụng, bao gồm cả tệp /src/lib/firebase.ts và tệp firestore.rules.

3. Triển khai: Khi đã sẵn sàng, hãy dùng lựa chọn Chia sẻ > Xuất bản để triển khai ứng dụng web của bạn lên Cloud Run.

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ả các loại này đề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 chi tiết bên dưới).
• Không cần có tài khoản Cloud Billing: Bạn có thể tạo 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 thêm thông tin thanh toán (không bắt buộc).
• Đặ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á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.

Các cơ sở dữ liệu Cloud Firestore 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ó hạn mức Cloud Firestore cao hơn

Nếu ứng dụng của bạn được nhiều người dùng biết đến và bạn cần vượt quá hạn mức miễn phí cho Cloud Firestore, bạn có thể nâng cấp dự án của mình 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êm): Chuyển đến bảng điều khiển Firebase rồi 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ác 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 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 cách sử dụng lệnh curl.

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

   • DATABASE_ID : Mã nhận dạng cơ sở dữ liệu Cloud Firestore, mã này sẽ khớp với mã nhận dạng applet của bạn; hãy tìm mã nhận dạng 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 lượt tạo

Tác nhân Google AI Studio sẽ tự động tạo Firebase Security Rules dựa trên logic của ứng dụng. Những 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ề những thay đổi đó và những 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ó

Bạn cũng có thể yêu cầu tác nhân Google AI Studio cung cấp Cloud Firestore vào một dự án Google Cloud hiện có mà bạn sở hữu. Hướng dẫn cho 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.

• Một cơ sở dữ liệu Cloud Firestore mới sẽ được cung cấp cho dự án đó bằng hạn mức dùng chung.
• Firebase Authentication sẽ được thiết lập bằng tính năng Đăng nhập bằng Google.
• 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ỉ liên kết với các ứng dụng Google AI Studio của bạn.
• Hạn chế: Nếu dự án Firebase đã có một cơ sở dữ liệu Cloud Firestore, thì tác nhân sẽ không thể thêm một cơ sở dữ liệu khác. Bạn cần 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 rồi 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 Tạo > Cloud Firestore Cơ sở dữ liệu để xem và chỉnh sửa dữ liệu của bạn trong Cloud Firestore, hoặc nhấp vào Tạo > 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 những 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 của bạn.

Làm cách nào để chọn dự án Google Cloud / Firebase?

Khi bạn sử dụng tính năng Thêm phần phụ trợ Firebase, tác nhân Google AI Studio sẽ tự động chọn một dự án Firebase để sử dụng cho các dịch vụ phụ trợ của ứng dụng (Cloud Firestore và Firebase Authentication).

Nếu muốn sử dụng một dự án cụ thể, bạn có thể hướng dẫn tác nhân làm như vậy bằng một câu lệnh như:

Use project PROJECT_ID for the Firebase backend.

Nếu sau này bạn quyết định xuất bản ứng dụng lên Cloud Run, thì bạn cần tiếp tục sử dụng chính dự án này. Việc chọn một dự án khác sẽ dẫn đến lỗi vì dự án đó sẽ không khớp với dự án được dùng cho phần phụ trợ của bạn.

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 sử dụng tính năng Thêm phần phụ trợ Firebase. Để 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 (chẳng hạn 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 Google AI Studiotài liệu về tác nhân.

Tuy nhiên, xin lưu ý rằng giống như mọi ứ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 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 được tác nhân Google AI Studio 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ì việc này có thể khiến tác nhân tạo ra mã không chính xác hoặc Security Rules không an toàn.

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

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

• Cách 1: Chờ: Hạn mức đượ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 Google AI Studio tác nhân thiết lập Cloud Firestore cho bạn, thì bạn phải sử dụng lệnh curl được mô tả trong phần Thêm thông tin thanh toán để nhận thêm hạn mức Cloud Firestore để chuyển cơ sở dữ liệu của bạn sang trạng thái trả 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. Điều này cho biết 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 của tôi khi tôi xoá ứng dụng Google AI Studio?

Việc xoá ứng dụng của bạn 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 một 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ư phiên bản cơ sở dữ liệu Cloud Firestore và nhà cung cấp 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 dữ liệu trong cơ sở dữ liệu Cloud Firestore của bạn, nhưng tác nhân có thể ghi mã vào applet đượ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, 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?

Đảm bảo dự án Firebase của bạn nằm trong một thư mục tổ chức Google Cloud cụ thể:

1. Tạo dự án Firebase theo cách thủ công trước thời hạn.

2. Khi thiết lập phần phụ trợ Firebase trong Google AI Studio, hãy hướng dẫn tác nhân sử dụng dự án hiện có của bạn:

   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 lưu dữ liệu vào một đường dẫn lồng nhau (chẳng hạn như /users/user1/messages/msg1) mà không tạo trước tài liệu mẹ (user1), tác nhân AI Studio sẽ tạo ra cái gọi là tài liệu mẹ không tồn tại. Những tài liệu này không xuất hiện trong bảng điều khiển Firebase, điều này có thể khiến bạn khó tìm thấy chúng khi duyệt qua 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 này 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 chế độ 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 Firestorecác 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 email từ Google Cloud về "khoá API công khai của Google cho dự án Google Cloud". Việc bạn cần làm

Nếu bạn nhận được email từ Google Cloud về "khoá API công khai của Google cho dự án Google Cloud" và khoá API được liệt kê trong email là khoá API Firebase của bạn, hãy đảm bảo rằng khoá API đó đáp ứng các yêu cầu sau để có thể đưa vào mã hoặc tệp cấu hình một cách an toàn. 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 bắt buộc liên quan đến Firebase có trong danh sách cho phép "các quy tắc hạn chế đối với API" của khoá.
• Nó 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 của 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à xem 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