FAQ 및 문제 해결

iOS+ Android 웹 Flutter

이 페이지에서는 Gemini API 및 Vertex AI in Firebase SDK에 관해 자주 묻는 질문 (FAQ)에 대한 답변을 제공합니다. 추가 질문이 있는 경우 Google Cloud 문서의 Gemini API FAQ를 확인하세요.

Vertex AI in Firebase SDK를 사용하려면 어떤 API를 사용 설정해야 하나요? 사용 설정하려면 어떻게 해야 하나요?

Vertex AI in Firebase SDK를 사용하려면 프로젝트에 다음 두 API가 사용 설정되어 있어야 합니다.

• Vertex AI API (aiplatform.googleapis.com)
• Vertex AI in Firebase API (firebasevertexai.googleapis.com)

Firebase 콘솔에서 몇 번의 클릭만으로 다음 API를 사용 설정할 수 있습니다.

1. Gemini로 빌드 페이지로 이동합니다.

2. Vertex AI in Firebase 카드를 클릭하여 두 API를 사용 설정하는 워크플로를 실행합니다. 이 워크플로는 Firebase API 키의 허용 목록에 Vertex AI in Firebase API도 추가합니다.

또는 Google Cloud 콘솔을 사용할 수 있습니다 (더 많은 수동 옵션).

1. 이 FAQ 항목 상단에 있는 각 API 링크를 클릭한 다음 각 API 페이지에서 사용 설정을 클릭합니다.

2. Google Cloud 문서의 API 제한사항 추가에 나온 안내에 따라 Firebase API 키의 허용 목록에 Vertex AI in Firebase API를 추가합니다.

참고: Vertex AI in Firebase의 미리보기 버전에는 Firebase ML API (firebaseml.googleapis.com)가 필요했지만, Vertex AI in Firebase가 정식 버전 (GA)으로 제공되므로 이제 이 API는 필요하지 않습니다.

Vertex AI in Firebase SDK를 사용하려면 어떤 권한이 필요한가요?

작업	필수 IAM 권한	기본적으로 필요한 권한이 포함된 IAM 역할
결제를 사용한 만큼만 지불하는 요금제 (Blaze)로 업그레이드	firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment	소유자
프로젝트에서 API 사용 설정	serviceusage.services.enable	편집자 소유자
Firebase 앱 만들기	firebase.clients.create	Firebase 관리자 편집자 소유자

Vertex AI in Firebase SDK와 함께 사용할 수 있는 모델은 무엇인가요?

Vertex AI in Firebase SDK는 Gemini 모델 알아보기에 나열된 Gemini 기반 모델과 함께 사용할 수 있습니다.

Vertex AI in Firebase SDK에서는 PaLM 모델, 조정된 모델, Gemma 기반 모델과 같은 비기반 Gemini 모델을 사용할 수 없습니다.

Google에서는 SDK에 새로운 기능을 자주 추가하므로 출시 노트, 블로그, 소셜 게시물뿐만 아니라 이 FAQ에서 업데이트를 확인하세요.

400 오류 Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.를 해결하려면 어떻게 해야 하나요?

Cloud Storage for Firebase URL을 사용하여 다중 모드 요청을 전송하려고 하면 다음과 같은 400 오류가 발생할 수 있습니다.
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

이 오류는 프로젝트에서 Vertex AI API가 사용 설정되었을 때 필요한 서비스 에이전트가 올바르게 자동 프로비저닝되지 않은 프로젝트로 인해 발생합니다. 이는 일부 프로젝트에서 알려진 문제이며 전 세계적으로 해결하기 위해 노력하고 있습니다.

다음은 프로젝트를 수정하고 이러한 서비스 에이전트를 올바르게 프로비저닝하여 멀티모달 요청에 Cloud Storage for Firebase URL을 포함할 수 있는 해결 방법입니다. 프로젝트의 소유자여야 하며 이 작업 세트는 프로젝트에 대해 한 번만 완료하면 됩니다.

1. gcloud CLI로 액세스하고 인증합니다.
   가장 쉬운 방법은 Cloud Shell에서 하는 것입니다. Google Cloud 문서에서 자세히 알아보세요.

2. 메시지가 표시되면 터미널에 표시된 안내에 따라 gcloud CLI를 Firebase 프로젝트에 대해 실행합니다.

   Firebase 프로젝트 ID가 필요합니다. Firebase Console의 프로젝트 설정 상단에서 확인할 수 있습니다.

3. 다음 명령어를 실행하여 프로젝트에 필요한 서비스 에이전트를 프로비저닝합니다.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. 서비스 상담사가 프로비저닝될 때까지 몇 분 정도 기다린 후 Cloud Storage for Firebase URL이 포함된 다중 모드 요청을 다시 전송합니다.

몇 분 후에도 이 오류가 계속 발생하면 Firebase 지원팀에 문의하세요.

Vertex AI in Firebase 사용 경험에 관한 의견 보내기