Google AI Studio 앱에 Cloud Firestore 및 인증 추가

Google AI Studio는 Cloud Firestore 및 Firebase Authentication와 직접 통합되므로 영구 데이터와 안전한 로그인 흐름을 사용하여 애플리케이션을 빌드할 수 있습니다. Google AI Studio에서 'Firebase 백엔드 추가' 기능을 사용하면 에이전트가 필요한 코드를 생성하고 앱을 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의 공유 할당량 이해하기

Google AI Studio에서 에이전트가 프로비저닝한 모든 Cloud Firestore 데이터베이스는 Firebase 프로젝트의 동일한 데이터베이스 '그룹'에 배치됩니다. 모두 다음과 같은 특징을 공유합니다.

• 공유 할당량: 그룹의 모든 데이터베이스가 사용량 할당량을 공유합니다(아래 세부정보 참고).
• Cloud Billing 계정 불필요: 결제를 추가하지 않고 앱을 빌드하고 테스트할 수 있습니다. 선택적으로 결제를 추가하는 방법에 대한 자세한 내용은 아래를 참고하세요.
• 일일 재설정: 일일 할당량 한도 (예: 일일 읽기 50,000개)에 도달하면 서비스가 그룹 내 모든 데이터베이스에 대해 일시중지되고 다음 날 태평양 표준시 자정에 다시 시작됩니다.

공유 할당량 그룹의 Cloud Firestore 데이터베이스는 다음 한도를 공유합니다.

(선택사항) 결제를 추가하여 Cloud Firestore 할당량 늘리기

앱이 인기를 얻어 Cloud Firestore의 무료 한도를 초과해야 하는 경우 프로젝트를 사용한 만큼만 지불하는 Blaze 요금제로 업그레이드할 수 있습니다.

1. 결제 추가 (아직 추가하지 않은 경우): Firebase 콘솔로 이동하여 결제 계정을 프로젝트에 연결합니다.

2. 데이터베이스 업그레이드: 기본적으로 Google AI Studio 에이전트로 만든 Cloud Firestore 데이터베이스는 요금제를 업그레이드한 후에도 공유 할당량을 계속 사용합니다. 특정 데이터베이스에 대해 전체 유료 확장을 사용 설정하려면 curl 명령어를 사용하여 그룹에서 수동으로 이동해야 합니다.

   • PROJECT_ID : Firebase 프로젝트 ID입니다. Firebase Console의 프로젝트 설정에서 이 ID를 찾으세요.
   • DATABASE_ID : Cloud Firestore 데이터베이스 ID입니다. 이 ID는 애플릿 ID와 일치합니다. Firebase 콘솔의 Cloud Firestore 데이터베이스 페이지에 있는 이름 열에서 이 데이터베이스 ID를 찾을 수 있습니다.

   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는 '기본 거부'로 설계되어 앱의 최종 사용자는 자신이 소유한 데이터에만 액세스할 수 있습니다.

Firebase 콘솔에서 직접 Security Rules를 수동으로 조정하면 Google AI Studio 에이전트가 변경사항을 알지 못하며 후속 앱 반복 중에 덮어쓰게 됩니다. Google AI Studio 에이전트를 사용하여 Firebase Security Rules를 조정하여 변경사항이 유지되고 앱의 논리와 일치하도록 하는 것이 좋습니다.

기존 프로젝트 사용

Google AI Studio 에이전트에게 내가 소유한 기존 Google Cloud 프로젝트에 Cloud Firestore을 프로비저닝해 달라고 요청할 수도 있습니다. 다음과 같은 프롬프트로 기존 프로젝트를 사용하도록 에이전트에게 지시합니다.

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 Console 사용

Firebase 콘솔에서 앱의 데이터와 설정을 확인할 수 있습니다. Google AI Studio와 연결된 프로젝트에 액세스하려면 다음 단계를 따르세요.

1. Firebase 콘솔로 이동하여 AI Studio라는 라벨이 지정된 프로젝트를 선택합니다.
2. 왼쪽 탐색 창에서 빌드 > Cloud Firestore 데이터베이스를 클릭하여 Cloud Firestore의 데이터를 확인하고 수정하거나 빌드 > Authentication를 클릭하여 Authentication 설정과 데이터를 구성합니다.

문제해결 및 FAQ

Firebase를 Google AI Studio 앱과 통합할 때 발생하는 일반적인 질문에 대한 답변을 확인하고 문제를 해결하는 방법을 알아보세요.

지원되는 인증 방법은 무엇인가요?

Google AI Studio 에이전트는 Firebase 백엔드 추가 기능을 사용할 때 Google 로그인을 설정합니다. 추가 방법을 설정하려면 Firebase 콘솔에서 사용 설정하고 Google AI Studio 에이전트에게 코드베이스 업데이트 지원을 요청하세요.

firebase-blueprint.json 파일이란 무엇인가요?

Google AI Studio 에이전트가 앱의 코드베이스를 이해하는 데 사용하는 중간 파일입니다. 이 파일을 수동으로 수정하면 에이전트가 잘못된 코드나 안전하지 않은 Security Rules를 생성할 수 있으므로 수정하지 마세요.

'할당량 초과' 오류가 표시되면 어떻게 해야 하나요?

Cloud Firestore 할당량 한도에 도달하면 앱이 Cloud Firestore 데이터베이스 공유 할당량 그룹의 일일 사용량 한도에 도달한 것입니다. 이 문제를 해결하는 방법은 두 가지입니다.

• 옵션 1: 기다리기: 할당량은 태평양 표준시 기준으로 매일 자정에 재설정됩니다.
• 옵션 2: 업그레이드: 사용한 만큼만 지불하는 Blaze 요금제로 업그레이드합니다.
  • Google AI Studio 에이전트가 Cloud Firestore를 설정한 경우 Cloud Firestore 할당량을 늘리기 위해 결제 추가에 설명된 curl 명령어를 사용하여 데이터베이스를 일반 유료 상태로 이동해야 합니다. Cloud Firestore를 수동으로 설정한 경우 curl 명령어를 실행하지 않아도 됩니다.

'권한이 없거나 충분하지 않습니다'라는 오류가 표시되면 어떻게 해야 하나요?

이 오류는 앱이 Cloud Firestore 데이터베이스에서 데이터를 읽거나 쓰려고 시도하지만 Security Rules에서 요청을 거부할 때 발생합니다. 현재 인증 상태 또는 데이터 경로에 따라 Security Rules에서 시도된 작업을 허용하지 않음을 나타냅니다. 오류 수정 버튼을 클릭하여 Google AI Studio 에이전트가 Security Rules를 수정하도록 프롬프트를 표시합니다.

Google AI Studio 앱을 삭제하면 Firebase 백엔드는 어떻게 되나요?

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 데이터베이스 내에서 데이터 항목을 직접 삭제, 수정 또는 조작할 수 없지만 이러한 작업을 실행하도록 설계된 코드를 애플릿에 작성할 수 있습니다. 항목 삭제와 같은 데이터 관리 작업을 실행하려면 Firebase 콘솔에서 Cloud Firestore 데이터베이스 페이지로 이동합니다.

Google Cloud를 사용하는 조직에 속해 있습니다. Google AI Studio 앱을 조직의 Google Cloud 환경 내 기존 프로젝트에 연결할 수 있나요?

Firebase 프로젝트가 특정 Google Cloud 조직 폴더 내에 있는지 확인합니다.

1. 미리 Firebase 프로젝트를 수동으로 만듭니다.

2. Google AI Studio에서 Firebase 백엔드를 설정할 때 에이전트가 기존 프로젝트를 사용하도록 안내합니다.

   Add Firestore to this app using project PROJECT_ID.
   

Firebase 콘솔에서 특정 문서를 찾을 수 없는 이유는 무엇인가요?

AI Studio 에이전트가 상위 문서(user1)를 먼저 만들지 않고 중첩된 경로(예: /users/user1/messages/msg1)에 데이터를 저장하면 존재하지 않는 상위 문서가 생성됩니다. 이러한 문서는 Firebase 콘솔에 표시되지 않으므로 Cloud Firestore 데이터베이스를 탐색할 때 찾기 어려울 수 있습니다. 이는 앱 실행에는 영향을 미치지 않지만, AI Studio 에이전트에게 문제를 설명하여 누락된 상위 문서를 만들도록 유도할 수 있습니다.

자세한 내용은 존재하지 않는 상위 문서를 참고하세요.

Cloud Firestore 데이터베이스의 위치는 어떻게 선택되나요?

현재 Cloud Firestore 데이터베이스의 위치는 사용자의 위치에 따라 자동으로 선택되며 변경하거나 수동으로 지정할 수 없습니다. 특정 위치를 선택하는 기능을 사용하고 싶다면 Google AI Studio 내에서 설정 > 의견 보내기로 이동하여 알려주세요.

Google은 Google AI Studio에서 내 데이터 (예: 코드 및 프롬프트)를 어떻게 사용하나요?

데이터 사용 방식에 대한 자세한 내용은 Gemini API 추가 서비스 약관을 참고하세요.