Vertex AI in Firebase는 2024년 10월 21일에 정식 버전 (GA)으로 출시되었습니다.
Vertex AI in Firebase 라이브러리의 미리보기 버전(FirebaseVertexAI-Preview)을 사용했다면 라이브러리의 GA 버전(FirebaseVertexAI)을 사용하도록 업그레이드하려면 다음을 변경해야 합니다.
다음은 이전에 필요한 변경사항의 대략적인 목록입니다.
- Firebase 프로젝트에서 새로운 필수 API 사용 설정 (모든 사용자에게 필요)
- 라이브러리의 GA 버전으로 업데이트 (모든 사용자에게 필요)
- 추가 변경사항 (사용하는 기능에 따라 필요)
Firebase 프로젝트에서 새로운 필수 API를 사용 설정합니다(모든 사용자에게 필요).
Firebase 프로젝트에서 Vertex AI in Firebase API를 사용 설정하고 Firebase API 키의 허용 목록에 추가해야 합니다. 이는 Vertex AI in Firebase의 GA 버전을 사용해야 하는 새로운 API입니다.
Firebase 콘솔에서 Gemini로 빌드 페이지로 이동합니다.
Vertex AI in Firebase 카드에서 시작하기를 클릭하여 이 API를 사용 설정하고 Firebase API 키의 허용 목록에 추가하는 데 도움이 되는 워크플로를 실행합니다.
콘솔에서 나머지 워크플로는 건너뛸 수 있습니다.
라이브러리의 GA 버전으로 업데이트합니다(모든 사용자에게 필요).
라이브러리의 GA 버전을 사용하도록 앱의 코드베이스를 업데이트하려면 다음 안내를 따르세요.
앱 프로젝트를 연 상태로 Xcode에서 다음 옵션 중 하나를 사용하여 Firebase 패키지를 버전 11.4.0 이상으로 업데이트합니다.
옵션 1: 모든 패키지 업데이트: 파일 > 패키지 > 최신 패키지 버전으로 업데이트로 이동합니다.
옵션 2: Firebase 개별 업데이트: 패키지 종속 항목 섹션에서 Firebase 패키지로 이동합니다. Firebase 패키지를 마우스 오른쪽 버튼으로 클릭한 다음 패키지 업데이트를 선택합니다.
이제 Firebase 패키지에 버전 11.4.0 이상이 표시되는지 확인합니다. 그렇지 않은 경우 지정된 패키지 요구사항에서 버전 11.7.0 이상으로 업데이트할 수 있는지 확인합니다.
Project Editor에서 앱의 타겟을 선택한 다음 Frameworks, Libraries, and Embedded Content 섹션으로 이동합니다.
+버튼을 선택한 다음 Firebase 패키지에서 FirebaseVertexAI를 추가합니다.FirebaseVertexAI-Preview를 선택한 다음
—버튼을 누릅니다.
추가 변경사항(사용하는 기능에 따라 필요)
SDK의 GA 버전에 몇 가지 변경사항이 구현되었습니다. 앱에서 SDK의 GA 버전을 사용하도록 하려면 코드에서 어떤 변경사항을 적용해야 하는지 다음 목록을 검토하세요.
함수 호출
GA 이전에 이 기능을 구현한 경우 스키마를 정의하는 방법을 업데이트해야 합니다. 함수 선언을 작성하는 방법을 알아보려면 업데이트된 함수 호출 가이드를 검토하는 것이 좋습니다.responseSchema를 사용하여 구조화된 출력 (예: JSON) 생성
GA 이전에 이 기능을 구현한 경우 스키마를 정의하는 방법을 업데이트해야 합니다. JSON 스키마를 작성하는 방법을 알아보려면 새 구조화된 출력 가이드를 검토하는 것이 좋습니다.제한 시간
- 요청의 기본 제한 시간을 180초로 변경했습니다.
열거형
대부분의
enum유형을 정적 변수가 있는struct로 바꿨습니다. 이 변경사항을 통해 이전 버전과 호환되는 방식으로 API를 더 유연하게 발전시킬 수 있습니다. 이제switch문을 사용할 때는 향후 SDK에 추가되는 새 값을 비롯하여 알 수 없거나 처리되지 않은 값을 처리하기 위해default:사례를 포함해야 합니다.BlockThreshold열거형의 이름을HarmBlockThreshold로 변경했습니다. 이 유형은 이제struct입니다.다음 열거형 (이제
struct)에서unknown및unspecified사례를 삭제했습니다.HarmCategory,HarmBlockThreshold,HarmProbability,BlockReason,FinishReason새로운 유형을 하위 호환 방식으로 추가할 수 있도록 열거형
ModelContent.Part을Part라는 프로토콜로 대체했습니다. 이 변경사항은 콘텐츠 부분 섹션에 자세히 설명되어 있습니다.
콘텐츠 부분
ThrowingPartsRepresentable프로토콜을 삭제하고 가끔 발생하는 컴파일러 오류를 방지하기 위해ModelContent의 이니셜라이저를 단순화했습니다. 올바르게 인코딩되지 않은 이미지는generateContent에서 사용될 때도 여전히 오류가 발생합니다.ModelContent.Part사례를Part프로토콜을 준수하는 다음struct유형으로 대체했습니다..text~TextPart.data~InlineDataPart.fileData~FileDataPart.functionCall~FunctionCallPart.functionResponse~FunctionResponsePart
유해 카테고리
HarmCategory가 더 이상SafetySetting유형에 중첩되지 않도록 변경했습니다.SafetySetting.HarmCategory라고 하는 경우HarmCategory로 바꿀 수 있습니다.
안전 관련 의견
- 응답에 사용되지 않았으므로
SafetyFeedback유형을 삭제했습니다.
- 응답에 사용되지 않았으므로
인용 메타데이터
CitationMetadata에서citationSources속성의 이름을citations로 변경했습니다.
총 청구 가능 문자 수
- 문자가 전송되지 않는 상황을 반영하도록
CountTokensResponse의totalBillableCharacters속성을 선택사항으로 변경했습니다.
- 문자가 전송되지 않는 상황을 반영하도록
후보 응답
- 다른 플랫폼과 일치하도록
CandidateResponse의 이름이Candidate으로 변경되었습니다.
- 다른 플랫폼과 일치하도록
세대 구성
GenerationConfig의 공개 속성을internal로 변경했습니다. 모두 초기화 프로그램에서 구성할 수 있습니다.
이전과 관련하여 발생할 수 있는 오류
Vertex AI in Firebase의 GA 버전을 사용하도록 이전할 때 이 이전 가이드에 설명된 대로 필요한 변경사항을 모두 완료하지 않으면 오류가 발생할 수 있습니다.
403 오류: Requests to this API firebasevertexai.googleapis.com ... are blocked.
Requests to this API firebasevertexai.googleapis.com ... are blocked.라는 403 오류가 표시되면 일반적으로 Firebase 구성 파일/객체의 API 키에 사용하려는 제품의 허용 목록에 필수 API가 없음을 의미합니다.
앱에서 사용하는 API 키에 키의 'API 제한사항' 허용 목록에 포함된 필수 API가 모두 있는지 확인합니다. Vertex AI in Firebase의 경우 API 키의 허용 목록에 최소한 Vertex AI in Firebase API가 있어야 합니다. 이 API는 Firebase 콘솔을 통해 새 API를 사용 설정할 때 API 키의 허용 목록에 자동으로 추가되었습니다.
Google Cloud 콘솔의 API 및 서비스 > 사용자 인증 정보 패널에서 모든 API 키를 볼 수 있습니다.