Добавьте Cloud Firestore и аутентификацию в свое приложение Google AI Studio.

Google AI Studio напрямую интегрируется с Cloud Firestore и Firebase Authentication , позволяя создавать приложения с постоянными данными и безопасными процессами авторизации. При использовании функции «Добавить бэкенд Firebase» в Google AI Studio агент генерирует необходимый код и подключает ваше приложение к проекту Firebase.

Обзор: Добавьте бэкэнд в ваше приложение Google AI Studio.

1. Опишите свою идею : Создайте новое приложение в Google AI Studio и опишите функцию, требующую использования базы данных или аутентификации (например, «Создать общий список дел»).

2. Включите интеграцию с Firebase : выберите «Добавить бэкенд Firebase» . Агент сгенерирует необходимый код, включая файл /src/lib/firebase.ts и файл firestore.rules , а затем подключит ваше приложение к Cloud Firestore и Firebase Authentication .

3. Развертывание : После завершения разверните приложение в Cloud Run , используя опцию « Поделиться > Опубликовать» .

Разберитесь с общей квотой для Cloud Firestore

Все базы данных Cloud Firestore созданные агентом в Google AI Studio, помещаются в одну и ту же «группу» баз данных в вашем проекте Firebase. Все они обладают следующими характеристиками:

• Общая квота : Все базы данных в группе используют общую квоту ( подробности см. ниже ).
• Учетная запись Cloud Billing не требуется : вы можете создавать и тестировать свое приложение без добавления платной подписки. Подробнее о добавлении платной подписки см. ниже .
• Ежедневное обновление : Если вы достигнете дневного лимита квоты (например, 50 000 операций чтения в день), работа сервиса будет приостановлена ​​для всех баз данных в группе и возобновится на следующий день примерно в полночь по тихоокеанскому времени.

Базы данных Cloud Firestore входящие в общую группу квот, имеют следующие общие ограничения:

(Необязательно) Добавьте платную подписку, чтобы получить больше квоты Cloud Firestore

Если ваше приложение станет популярным и вам потребуется выйти за рамки бесплатных ограничений Cloud Firestore , вы можете перейти на тарифный план Blaze с оплатой по мере использования .

1. Добавьте платежную систему (если вы еще этого не сделали) : перейдите в консоль Firebase и свяжите платежный аккаунт с вашим проектом .

2. Обновление базы данных : по умолчанию базы данных Cloud Firestore созданные агентом Google AI Studio, продолжают использовать общую квоту даже после обновления тарифного плана . Чтобы включить полное масштабирование для конкретной базы данных, необходимо вручную исключить ее из группы с помощью команды curl .

   • PROJECT_ID : Идентификатор проекта Firebase; этот идентификатор можно найти в настройках проекта в консоли Firebase .
   • DATABASE_ID : Идентификатор базы данных Cloud Firestore , который будет соответствовать идентификатору вашего апплета; этот идентификатор базы данных можно найти в столбце «Имя» на странице баз данных Cloud Firestore в консоли 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=limited_free_tier" \
   -d '{"limited_free_tier": false}'
   

Генерация Security Rules

Google AI Studio автоматически генерирует Firebase Security Rules на основе логики вашего приложения. Эти Security Rules разработаны таким образом, чтобы по умолчанию разрешать доступ только тем конечным пользователям вашего приложения, которым они владеют.

Обратите внимание, что если вы вручную измените Security Rules непосредственно в консоли Firebase , агент Google AI Studio не узнает об изменениях, и они будут перезаписаны при последующих итерациях приложения. Мы рекомендуем использовать агент Google AI Studio для изменения Firebase Security Rules , чтобы гарантировать сохранение изменений и их соответствие логике вашего приложения.

Используйте существующий проект

Вы также можете попросить агента Google AI Studio подключить Cloud Firestore к существующему проекту Google Cloud , которым вы владеете. Дайте агенту указание использовать ваш существующий проект, используя, например, следующую команду:

Add Firestore to this app using project PROJECT_ID.

• В рамках этого проекта будет создана новая база данных Cloud Firestore с использованием выделенной квоты.
• Будет настроена Firebase Authentication с использованием входа через Google.
• Сервисному аккаунту будет предоставлен доступ к вашей базе данных Cloud Firestore . Для предоставления доступа администратору из Google AI Studio будет создан новый сервисный аккаунт с именем ais-sandbox@ PROJECT_ID .iam.gservice.com , которому будет предоставлено разрешение на доступ к вашей базе данных Cloud Firestore . Этот аккаунт будет связан только с вашими приложениями Google AI Studio .
• Ограничения : Если в проекте Firebase уже есть база данных Cloud Firestore , агент не сможет добавить дополнительную. Вам потребуется создать новый пустой проект для использования.

Используйте консоль Firebase

Вы можете просмотреть данные и настройки своего приложения в консоли Firebase . Чтобы получить доступ к проектам, связанным с Google AI Studio , выполните следующие действия:

1. Перейдите в консоль Firebase и выберите проект с названием AI Studio .
2. В левой панели навигации щелкните Build > Cloud Firestore Database , чтобы просмотреть и отредактировать данные в Cloud Firestore , или щелкните Build > Authentication чтобы настроить параметры Authentication и данные.

Устранение неполадок и часто задаваемые вопросы

Найдите ответы на часто задаваемые вопросы и узнайте, как решать проблемы при интеграции Firebase с вашим приложением Google AI Studio .

Какие методы аутентификации поддерживаются?

Агент Google AI Studio настраивает вход через Google при использовании функции добавления бэкэнда Firebase . Чтобы настроить дополнительные методы, включите их в консоли Firebase и обратитесь к агенту Google AI Studio за помощью в обновлении вашего кода.

Что представляет собой файл firebase-blueprint.json ?

Это промежуточный файл, используемый агентом Google AI Studio для анализа кода вашего приложения. Не изменяйте этот файл вручную, так как это может привести к генерации агентом некорректного кода или небезопасных Security Rules .

Что делать, если я получаю ошибку "Превышен лимит квоты"?

Превышение лимита квоты Cloud Firestore означает, что ваше приложение достигло дневного лимита использования для вашей группы квот базы данных Cloud Firestore . Есть два способа решить эту проблему:

• Вариант 1: Подождать : Квоты обновляются ежедневно около полуночи по тихоокеанскому времени.
• Вариант 2: Обновление : Перейдите на тарифный план Blaze с оплатой по факту использования.
  • Если агент Google AI Studio настроил для вас Cloud Firestore , вам необходимо использовать команду curl , описанную в разделе «Добавление платёжных опций для увеличения квоты Cloud Firestore» , чтобы перевести вашу базу данных в обычный платный режим. Если вы настраивали Cloud Firestore вручную, выполнение команды curl не требуется.

Что делать, если появляется ошибка "Отсутствуют или недостаточны права доступа"?

Эта ошибка возникает, когда ваше приложение пытается прочитать или записать данные в базу данных Cloud Firestore , но запрос отклоняется Security Rules . Это указывает на то, что Security Rules не разрешают попытку выполнения операции на основе текущего состояния аутентификации или пути к данным. Нажмите кнопку «Исправить ошибку» , чтобы агент Google AI Studio попытался исправить Security Rules .

Что произойдёт с моим бэкэндом Firebase, если я удалю приложение Google AI Studio ?

Удаление приложения в Google AI Studio не приводит к автоматическому удалению подключенного проекта Firebase, базы данных Cloud Firestore или конфигураций Firebase Authentication .

Если вы добавили бэкенд Firebase, вам необходимо вручную перейти в консоль Firebase и удалить проект или очистить отдельные ресурсы (например, экземпляр базы данных Cloud Firestore и поставщиков Authentication ), чтобы убедиться, что все данные и конфигурации удалены.

Может ли агент Google AI Studio удалять или редактировать данные в моей базе данных Cloud Firestore ?

Агент Google AI Studio предназначен для подготовки необходимых ресурсов бэкэнда, генерации кода и Security Rules . Хотя сам агент не может напрямую удалять, редактировать или изменять записи данных в вашей базе данных Cloud Firestore , он может записывать код в ваш апплет, предназначенный для выполнения этих действий. Для выполнения задач управления данными, таких как удаление записей, перейдите на страницу базы данных Cloud Firestore в консоли Firebase .

Я работаю в организации, использующей Google Cloud ; могу ли я подключить свое приложение Google AI Studio к существующему проекту в среде Google Cloud моей организации?

Убедитесь, что ваш проект Firebase находится в папке определенной организации Google Cloud :

1. Создайте свой проект Firebase вручную заранее.

2. При настройке бэкенда Firebase в Google AI Studio укажите агенту использовать ваш существующий проект:

   Add Firestore to this app using project PROJECT_ID.
   

Почему я не могу найти некоторые документы в консоли Firebase ?

Когда агент AI Studio сохраняет данные во вложенный путь (например, /users/user1/messages/msg1 ), не создав предварительно родительский документ ( user1 ), он создает так называемый несуществующий родительский документ . Эти документы не отображаются в консоли Firebase , что может затруднить их поиск при просмотре базы данных Cloud Firestore . Хотя это не влияет на работу вашего приложения, вы часто можете описать проблему агенту AI Studio, чтобы он создал отсутствующие родительские документы.

Для получения более подробной информации см. раздел «Несуществующие родительские документы» .

Как выбирается местоположение для моей базы данных Cloud Firestore ?

В настоящее время местоположение вашей базы данных Cloud Firestore выбирается автоматически в зависимости от вашего местоположения и не может быть изменено или указано вручную. Если вы хотите иметь возможность выбирать конкретное местоположение, сообщите нам об этом, перейдя в раздел «Настройки» > «Отправить отзыв» в Google AI Studio .

Как Google использует мои данные (например, код и подсказки) в Google AI Studio ?

Подробную информацию об использовании ваших данных см. в Дополнительных условиях предоставления услуг API Gemini .