Panduan ini menunjukkan cara untuk mulai melakukan panggilan ke Vertex AI Gemini API langsung dari aplikasi Anda menggunakan Vertex AI in Firebase SDK untuk platform pilihan Anda.
Prasyarat
Panduan ini mengasumsikan bahwa Anda sudah terbiasa menggunakan Android Studio untuk mengembangkan aplikasi untuk Android.
Pastikan lingkungan pengembangan dan aplikasi Android Anda memenuhi persyaratan berikut:
- Android Studio (versi terbaru)
- Aplikasi Android Anda harus menargetkan API level 21 atau yang lebih tinggi.
(Opsional) Lihat aplikasi contoh.
Anda dapat mencoba SDK dengan cepat, melihat implementasi lengkap dari berbagai penggunaan kasus penggunaan, atau menggunakan aplikasi contoh jika Anda tidak memiliki aplikasi Android 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
Di konsol Firebase, buka Halaman Membuat aplikasi dengan Gemini.
Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas-tugas berikut. (Perhatikan bahwa jika Anda melihat tab di konsol untuk Vertex AI, maka tugas ini selesai.)
Upgrade project Anda untuk menggunakan paket harga Blaze bayar sesuai penggunaan.
Aktifkan dua API berikut untuk project Anda:
aiplatform.googleapis.com
danfirebaseml.googleapis.com
.
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
Langkah 2: Tambahkan SDK
Setelah project Firebase disiapkan dan aplikasi Anda telah terhubung ke Firebase (lihat langkah sebelumnya), Anda kini dapat menambahkan Vertex AI in Firebase SDK ke aplikasi.
Vertex AI in Firebase SDK untuk Android (firebase-vertexai
) menyediakan
akses ke Vertex AI Gemini API.
Dalam file konfigurasi Gradle modul (level aplikasi)
(seperti <project>/<app-module>/build.gradle.kts
), tambahkan dependensi untuk
Vertex AI in Firebase SDK untuk Android:
Kotlin+KTX
dependencies {
// ... other androidx dependencies
// add the dependency for the Vertex AI in Firebase SDK for Android
implementation("com.google.firebase:firebase-vertexai:16.0.0-beta04")
}
Java
Untuk Java, Anda perlu menambahkan dua library tambahan.
dependencies {
// ... other androidx dependencies
// add the dependency for the Vertex AI in Firebase SDK for Android
implementation("com.google.firebase:firebase-vertexai:16.0.0-beta04")
// Required for one-shot operations (to use `ListenableFuture` from Guava Android)
implementation("com.google.guava:guava:31.0.1-android")
// Required for streaming operations (to use `Publisher` from Reactive Streams)
implementation("org.reactivestreams:reactive-streams:1.0.4")
}
Langkah 3: Lakukan inisialisasi layanan Vertex AI dan model generatif
Sebelum dapat melakukan panggilan API, Anda perlu melakukan inisialisasi Vertex AI model generatif dan generatif.
Kotlin+KTX
Untuk Kotlin, metode dalam SDK ini adalah fungsi penangguhan dan harus dipanggil dari cakupan coroutine.// 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
val generativeModel = Firebase.vertexAI.generativeModel("gemini-1.5-flash")
Java
Untuk Java, metode streaming dalam SDK ini menampilkanPublisher
dari library Reactive Stream.
// 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
GenerativeModel gm = FirebaseVertexAI.getInstance()
.generativeModel("gemini-1.5-flash");
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
Setelah menyelesaikan panduan memulai, pelajari cara memilih model Gemini dan (secara 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 untuk memanggil Vertex AI Gemini API.
Anda dapat menggunakan generateContent()
untuk membuat teks dari perintah hanya teks
permintaan:
Kotlin+KTX
Untuk Kotlin, metode dalam SDK ini adalah fungsi penangguhan dan harus dipanggil dari cakupan coroutine.// 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
val generativeModel = Firebase.vertexAI.generativeModel("gemini-1.5-flash")
// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
val response = generativeModel.generateContent(prompt)
print(response.text)
Java
Untuk Java, metode dalam SDK ini menampilkanListenableFuture
// 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
GenerativeModel gm = FirebaseVertexAI.getInstance()
.generativeModel("gemini-1.5-flash");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
// Provide a prompt that contains text
Content prompt = new Content.Builder()
.addText("Write a story about a magic backpack.")
.build();
// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
@Override
public void onSuccess(GenerateContentResponse result) {
String resultText = result.getText();
System.out.println(resultText);
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
Kamu bisa apa lagi?
Pelajari lebih lanjut model Gemini
Pelajari tentang model yang tersedia untuk berbagai kasus penggunaan dan mereka kuota dan harga.
Coba kemampuan Gemini API lainnya
- Pelajari lebih lanjut cara membuat teks dari dialog khusus teks, termasuk cara menampilkan respons secara bertahap.
- Buat teks dari dialog multimodal (termasuk teks, gambar, PDF, video, dan audio).
- Membuat percakapan multi-giliran (chat).
- Gunakan panggilan fungsi untuk menghubungkan generatif ke sistem dan informasi eksternal.
Pelajari cara mengontrol pembuatan konten
- Memahami desain prompt, termasuk praktik terbaik, strategi, dan contoh perintah.
- Mengonfigurasi parameter model seperti suhu dan token output maksimum.
- Gunakan setelan keamanan untuk menyesuaikan kemungkinan mendapatkan respons yang mungkin dianggap berbahaya.
Beri masukan tentang pengalaman Anda dengan Vertex AI in Firebase