Firebase의 Vertex AI SDK를 사용하여 Gemini API 시작하기

이 가이드에서는 Vertex AI Gemini API: 선택한 플랫폼에 맞는 Vertex AI in Firebase SDK입니다.

기본 요건

이 가이드는 Xcode를 사용하여 Apple 플랫폼 (예: iOS)

• 개발 환경과 Apple 플랫폼 앱이 다음 요구사항을 충족하는지 확인합니다.

  • Xcode 15.0 이상
  • 앱에서 iOS 15 이상 또는 macOS 12 이상을 타겟팅해야 합니다.

• (선택사항) 샘플 앱을 확인합니다.

  샘플 앱 다운로드

  SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 Apple 플랫폼 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.

1단계: Firebase 프로젝트 설정 및 앱을 Firebase에 연결

Firebase 프로젝트와 Firebase에 연결된 앱이 이미 있는 경우

1. Firebase 콘솔에서 다음으로 이동합니다. Gemini로 빌드 페이지를 참고하세요.

2. Vertex AI in Firebase 카드를 클릭하여 다음 작업을 완료하는 데 도움이 되는 워크플로를 실행합니다. (콘솔에 Vertex AI)를 클릭하면 이 태스크가 완료됩니다.)

   • 사용한 만큼만 지불하는 Blaze 요금제를 사용하도록 프로젝트를 업그레이드합니다.

   • 프로젝트에
     aiplatform.googleapis.com 및 firebaseml.googleapis.com API를 사용 설정합니다.

3. 이 가이드의 다음 단계로 진행하여 앱에 SDK를 추가합니다.

아직 Firebase 프로젝트와 Firebase에 연결된 앱이 없는 경우

2단계: SDK 추가

Firebase 프로젝트가 설정되고 앱이 Firebase에 연결되면(이전 단계 참고) 이제 앱에 Vertex AI in Firebase SDK를 추가할 수 있습니다.

Vertex AI in Firebase 라이브러리를 사용하면 Vertex AI Gemini API용 Firebase SDK의 일부로 포함되어 있습니다. Apple 플랫폼 (firebase-ios-sdk) Vertex AI in Firebase 라이브러리의 경우 Swift Package Manager를 사용해 Firebase를 설치하고 관리해야 합니다. 종속 항목이 포함됩니다 CocoaPods와 같은 다른 패키지 관리자는 현재 지원됩니다.

1. 앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.

2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

     https://github.com/firebase/firebase-ios-sdk
   

3. 최신 SDK 버전을 선택합니다.

4. FirebaseVertexAI-Preview 라이브러리를 선택합니다.

   완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

3단계: Vertex AI 서비스 및 생성 모델 초기화

API를 호출하려면 먼저 Vertex AI 서비스와 생성형 모델을 초기화해야 합니다.

1. FirebaseVertexAI 모듈을 가져옵니다.

   import FirebaseVertexAI
   

2. Vertex AI 서비스와 생성형 모델을 초기화합니다.

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
   

시작 가이드를 완료했다면 Gemini 모델 및 (선택사항) 사용 사례와 앱에 적합한 위치를 선택합니다.

4단계: Vertex AI Gemini API 호출

이제 앱을 Firebase에 연결하고 SDK를 추가했으며 Vertex AI 서비스와 생성 모델 Vertex AI Gemini API를 호출할 준비가 되었습니다.

generateContent()를 사용하여 텍스트 전용 프롬프트에서 텍스트를 생성할 수 있습니다. 요청:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

그 밖에 무엇을 할 수 있을까요?

Gemini 모델 자세히 알아보기

Gemini API의 다른 기능 사용해 보기

• 응답을 스트리밍하는 방법을 비롯하여 텍스트 전용 프롬프트에서 텍스트를 생성하는 방법을 자세히 알아보세요.
• 다음에서 텍스트 생성 멀티모달 프롬프트 (텍스트, 이미지, PDF, 동영상, 오디오 포함)
• 멀티턴 대화 (채팅)를 빌드합니다.
• 함수 호출을 사용하여 연결 생성하는 방법을 알아보겠습니다

콘텐츠 생성을 제어하는 방법 알아보기

• 권장사항, 전략, 프롬프트 예시를 포함하여 프롬프트 설계 이해하기
• 강도 및 최대 출력 토큰과 같은 모델 매개변수를 구성합니다.
• 안전 설정을 사용하여 유해하다고 간주될 수 있는 대답이 표시될 가능성을 조정합니다.

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