Mulai gunakan GeminiIAP API menggunakan Vertex akhir AI di SDK Firebase


Panduan ini menunjukkan cara mulai melakukan panggilan ke Vertex AI Gemini API langsung dari aplikasi menggunakan Vertex AI in Firebase SDK untuk platform yang Anda pilih.

Prasyarat

Panduan ini mengasumsikan bahwa Anda sudah terbiasa mengembangkan aplikasi dengan Flutter.

  • Pastikan lingkungan pengembangan dan aplikasi Flutter Anda memenuhi persyaratan berikut:

    • Dart 3.2.0+
  • (Opsional) Lihat aplikasi contoh.

    Mendownload aplikasi contoh

    Anda dapat mencoba SDK dengan cepat, melihat implementasi lengkap berbagai kasus penggunaan, atau menggunakan aplikasi contoh jika tidak memiliki aplikasi Flutter sendiri. Untuk menggunakan aplikasi contoh, Anda harus menghubungkannya ke project Firebase.

Langkah 1: Siapkan project Firebase dan hubungkan aplikasi Anda ke Firebase

Jika Anda sudah memiliki project Firebase dan aplikasi yang terhubung ke Firebase

  1. Di Firebase console, buka halaman Build with Gemini.

  2. Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas berikut:

  3. Lanjutkan ke langkah berikutnya dalam panduan ini untuk menambahkan SDK ke aplikasi Anda.

Jika Anda belum memiliki project Firebase dan aplikasi yang terhubung ke Firebase

  1. Login ke Firebase console.

  2. Klik Create project, lalu gunakan salah satu opsi berikut:

    • Opsi 1: Buat project Firebase yang sepenuhnya baru (dan project Google Cloud yang mendasarinya secara otomatis) dengan memasukkan nama project baru di langkah pertama alur kerja "Create project".

    • Opsi 2: "Tambahkan Firebase" ke project Google Cloud yang ada dengan memilih nama project Google Cloud dari menu drop-down di langkah pertama alur kerja "Create project".

    Perhatikan bahwa saat diminta, Anda tidak perlu menyiapkan Google Analytics untuk menggunakan SDK Vertex AI in Firebase.

  3. Di Firebase console, buka halaman Build with Gemini.

  4. Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas berikut:

  1. Instal alat command line yang diperlukan:

    1. Instal Firebase CLI jika Anda belum melakukannya.

    2. Login ke Firebase menggunakan Akun Google Anda dengan menjalankan perintah berikut:

      firebase login
      
    3. Instal FlutterFire CLI dengan menjalankan perintah berikut dari direktori mana saja:

      dart pub global activate flutterfire_cli
      
  2. Konfigurasikan aplikasi Anda untuk menggunakan Firebase:

    Gunakan FlutterFire CLI untuk mengonfigurasi aplikasi Flutter agar dapat terhubung ke Firebase.

    Dari direktori project Flutter Anda, jalankan perintah berikut untuk memulai alur kerja konfigurasi aplikasi:

    flutterfire configure
    

    Fungsi alur kerja flutterfire configure adalah sebagai berikut:

    • Meminta Anda memilih platform (iOS, Android, Web) yang didukung di aplikasi Flutter. Untuk setiap platform yang dipilih, FlutterFire CLI akan membuat aplikasi Firebase baru di project Firebase Anda.

      Anda dapat memilih untuk menggunakan project Firebase yang ada atau membuat project Firebase baru. Jika Anda sudah memiliki aplikasi yang terdaftar di project Firebase yang ada, FlutterFire CLI akan mencoba mencocokkannya berdasarkan konfigurasi project Flutter Anda saat ini.

    • Membuat file konfigurasi Firebase (firebase_options.dart) dan menambahkannya ke direktori lib/ aplikasi Flutter Anda.

  3. Pada langkah berikutnya dalam panduan ini, Anda akan menambahkan Vertex AI in Firebase SDK ke aplikasi dan menyelesaikan inisialisasi yang diperlukan khusus untuk menggunakan SDK dan Gemini API.


Langkah 2: Tambahkan SDK

Setelah project Firebase disiapkan dan aplikasi terhubung ke Firebase (lihat langkah sebelumnya), Anda kini dapat menambahkan SDK Vertex AI in Firebase ke aplikasi.

Plugin Vertex AI in Firebase untuk Flutter (firebase_vertexai) menyediakan akses ke Vertex AI Gemini API.

  1. Dari direktori project Flutter Anda, jalankan perintah berikut untuk menginstal plugin inti dan plugin Vertex AI in Firebase:

    flutter pub add firebase_core && flutter pub add firebase_vertexai
    
  2. Dalam file lib/main.dart, impor plugin inti Firebase, plugin Vertex AI in Firebase, dan file konfigurasi yang Anda buat sebelumnya:

    import 'package:firebase_core/firebase_core.dart';
    import 'package:firebase_vertexai/firebase_vertexai.dart';
    import 'firebase_options.dart';
    
  3. Selain itu, di file lib/main.dart, lakukan inisialisasi Firebase menggunakan objek DefaultFirebaseOptions yang diekspor oleh file konfigurasi:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. Build ulang aplikasi Flutter Anda:

    flutter run
    

Langkah 3: Lakukan inisialisasi layanan Vertex AI dan model generatif

Sebelum dapat melakukan panggilan API, Anda perlu melakukan inisialisasi layanan Vertex AI dan model generatif.

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');

Setelah menyelesaikan panduan memulai, pelajari cara memilih model Gemini dan (opsional) lokasi yang sesuai untuk kasus penggunaan dan aplikasi Anda.

Langkah 4: Panggil Vertex AI Gemini API

Setelah menghubungkan aplikasi ke Firebase, menambahkan SDK, dan melakukan inisialisasi layanan Vertex AI dan model generatif, Anda siap memanggil Vertex AI Gemini API.

Anda dapat menggunakan generateContent() untuk membuat teks dari permintaan prompt khusus teks:

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Kamu bisa apa lagi?

Pelajari model Gemini lebih lanjut

Pelajari model yang tersedia untuk berbagai kasus penggunaan serta kuota dan harganya.

Mencoba kemampuan lain Gemini API

Pelajari cara mengontrol pembuatan konten

Anda juga dapat bereksperimen dengan perintah dan konfigurasi model menggunakan Vertex AI Studio.


Berikan masukan tentang pengalaman Anda dengan Vertex AI in Firebase