Membangun aplikasi Android yang cerdas: Mengintegrasikan ke dalam sistem kecerdasan Android menggunakan AppFunctions
Waktu baca: 6 menit
Selamat datang kembali di rangkaian postingan blog "Membangun aplikasi Android yang cerdas". Di sini, kita akan mengubah aplikasi Android dasar menjadi pengalaman yang dipersonalisasi, cerdas, dan agentic. Dalam postingan sebelumnya, kami membahas cara memanfaatkan Firebase AI Logic untuk membangun fitur AI hybrid dan yang dihosting di cloud.
UI seluler tradisional unggul dalam tugas-tugas yang terfokus dan praktis, dan sistem kecerdasan Android memperkenalkan fitur pelengkap untuk mempermudah tindakan kompleks yang memerlukan banyak langkah. Dengan melengkapi antarmuka pengguna tradisional, AppFunctions menyediakan titik entri baru yang efektif: Agen dengan hak istimewa di perangkat dapat mengakses fitur aplikasi di latar belakang. Hal ini dapat sangat membantu saat pengguna sedang mengemudi, berjalan, atau melakukan multitasking.
Dalam artikel ini, kami akan menunjukkan cara kami mendesain dan mengintegrasikan kemampuan ini ke dalam aplikasi perencanaan perjalanan kami, JetPacker, menggunakan AppFunctions Android. Kita akan mempelajari alasan di balik pilihan fitur kami, membahas alat khusus yang kami gunakan untuk mempercepat pengembangan, dan mempelajari kode yang membuat semuanya berfungsi.
Mendesain fitur siap AI: membuat pilihan yang penting bagi pengguna Anda
Untuk memilih fitur yang akan disediakan ke sistem kecerdasan, kami mencari tugas yang perintah suara atau teksnya secara objektif lebih cepat daripada mengetuk layar. Dalam rekaman layar berdampingan ini, Anda dapat melihat kontras ini dengan jelas: di sebelah kiri, pengguna mengetuk beberapa layar untuk mencatat pengeluaran; di sebelah kanan, tugas yang sama diselesaikan secara instan di latar belakang melalui agen dengan hak istimewa.
Pilihan pertama kami adalah pelacakan pengeluaran. Mencatat pengeluaran kopi selama perjalanan biasanya memerlukan beberapa ketukan—membuka kunci ponsel, membuka aplikasi, menemukan perjalanan yang aktif, membuka tab pengeluaran, mengetuk tombol tambah, mengambil foto tanda terima, dan memeriksa hasilnya. Dengan menyediakan fitur addExpense dan getExpenses sebagai AppFunctions, agen sistem akan menangani tugas berat. Saat pengguna mengatakan, "Tambahkan pengeluaran kopi seharga lima dolar ke perjalanan saya ke Paris", agen akan otomatis menelusuri ID perjalanan yang benar di latar belakang dan menyisipkan pengeluaran, sehingga melewati seluruh alur UI manual.
Kami juga memprioritaskan pengelolaan itinerari. Menemukan aktivitas berikutnya dalam itinerari perjalanan yang padat biasanya memerlukan scroll di tampilan linimasa yang padat. Dengan memberikan getItinerary dan addItineraryEvent ke sistem, pengguna cukup bertanya, "Apa yang akan saya lakukan selanjutnya di Paris?" dan mendapatkan jawaban langsung.
Terakhir, kami berfokus pada pencatatan handsfree. Mengetik pengingat atau catatan saat berjalan di jalan yang ramai itu sulit dan tidak aman. Dengan mengekspos kemampuan catatan suara, pengguna dapat mengatakan, "Penerbangannya luar biasa, saya melihat matahari terbenam yang indah dan berhasil tidur nyenyak", dan agen dengan akses istimewa akan otomatis mentranskripsikan dan menyimpannya langsung ke database perjalanan menggunakan AppFunction addVoiceNote.
MCP Android yang didukung oleh AppFunctions
Seluruh pengalaman ini dibangun di Android MCP. Dengan desain ini, aplikasi bertindak sebagai server MCP lokal. Daripada API jarak jauh, Anda menyediakan fitur aplikasi langsung ke sistem kecerdasan di perangkat.
Android AppFunctions adalah API yang mewujudkan konsep ini. Alat ini membaca fungsi Kotlin yang dianotasi dan mengompilasinya menjadi definisi alat yang di-sandbox dan aman dari jenis, yang dapat ditemukan dan dipanggil oleh agen dengan hak istimewa secara lokal di perangkat.
Dalam model MCP Android, aplikasi Anda bertindak sebagai server MCP lokal yang mengekspos alat terstruktur, sedangkan platform Android berfungsi sebagai registry alat pusat. Di sisi klien MCP, aplikasi agen didaftarkan ke sistem kecerdasan setelah diberi izin istimewa sistem untuk mengakses registry.
Saat pengguna berinteraksi dengan agen terdaftar, LLM-nya akan menentukan apakah permintaan dapat ditangani oleh AppFunction, mengkueri metadata platform, dan menjalankan fungsi terdaftar yang sesuai di latar belakang. Desain klien-server MCP lokal ini memberi Anda kontrol penuh: Anda dapat memilih fitur mana yang dapat diakses oleh agen, sehingga data aplikasi Anda yang lain tetap bersifat pribadi.
Cara kami mempercepat pengembangan dengan keterampilan Android
Untuk menyederhanakan proses integrasi, kami memanfaatkan kemampuan pengembangan AppFunctions. Kemampuan pengembangan AppFunctions adalah pendamping pengembangan yang lengkap. Gemini memandu kami melalui seluruh siklus proses: memetakan class data Kotlin untuk melakukan serialisasi parameter, membuat titik entri Service yang diperlukan, menyempurnakan dokumentasi KDoc kami untuk memastikan LLM memahami batasan parameter, dan menyiapkan pengujian otomatis menggunakan ADB.
Menyediakan fitur aplikasi ke sistem kecerdasan
Cukup dengan teori, mari kita pelajari penerapannya.
Penyiapan konfigurasi dan dependensi
Kita mulai dengan menambahkan dependensi AppFunctions. Satu untuk API dan satu untuk compiler Kotlin Symbol Processing.
implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10")Membuat model jenis data kustom
Setiap objek kustom yang dipertukarkan dengan agen harus dianotasi dengan @AppFunctionSerializable. Dalam file TripSerializable.kt, kita menentukan model data perjalanan:
@AppFunctionSerializable(isDescribedByKDoc = true) data class TripSerializable( /** The trip's unique identifier. */ val id: String, /** The trip's title. */ val title: String, /** The trip's destination location. */ val location: String, /** The trip's start date in milliseconds. */ val startDate: Long, /** The trip's end date in milliseconds. */ val endDate: Long, /** A list of participants. */ val participants: List<String>, )
Menyediakan fitur menggunakan anotasi @AppFunction
Selanjutnya, skill ini menulis fungsi Kotlin yang menjalankan kueri database dan menganotasinya dengan @AppFunction. Kita dapat melihatnya di searchTrip:
/** * Looks for trips based on optional filters like id, title (name), location, and dates. * * @param id The unique identifier of the trip. * @param title The title or name of the trip. * @param location The destination location. * @param startDate The minimum start date in milliseconds. * @param endDate The maximum end date in milliseconds. * @return A list of trips matching the filters. */ @AppFunction(isDescribedByKDoc = true) suspend fun searchTrip( id: String? = null, title: String? = null, location: String? = null, startDate: Long? = null, endDate: Long? = null ): List<TripSerializable> { return withContext(Dispatchers.IO) { // implementation }
Karena AppFunctions berjalan di UI thread secara default, kita menggunakan withContext(Dispatchers.IO) untuk beralih ke dispatcher latar belakang. Selain itu, kami menyempurnakan KDoc untuk menggunakan kata kerja imperatif yang jelas dan menentukan batasan parameter. Dokumentasi ini dikompilasi langsung ke dalam skema alat, yang digunakan agen dengan hak istimewa untuk menyelesaikan parameter dan menangani error runtime.
Titik entri layanan dan integrasi Hilt
Untuk mendaftarkan fitur ini ke sistem kecerdasan, kita membuat class dasar abstrak yang memperluas AppFunctionService. Kita menganotasinya dengan @AppFunctionServiceEntryPoint:
@RequiresApi(36) @AndroidEntryPoint @AppFunctionServiceEntryPoint( serviceName = "JetPackerAppFunctionService", appFunctionXmlFileName = "jetpacker_app_function_service" ) abstract class BaseJetPackerAppFunctionService : AppFunctionService() { @Inject internal lateinit var tripDao: TripDao // DAOs and database references are injected here... }
Selama kompilasi, KSP menghasilkan subclass layanan konkret akhir, JetPackerAppFunctionService, seperti yang dideklarasikan dengan parameter serviceName. Kita juga mendaftarkan app_metadata.xml dalam manifes aplikasi. File ini menyediakan aturan operasional global untuk AppFunction yang dideklarasikan JetPacker.
Menguji dan memverifikasi AppFunctions Anda
Setelah diimplementasikan, Anda harus memverifikasi bahwa AppFunction Anda terdaftar dan berfungsi dengan benar.
Dengan menjalankan perangkat atau emulator yang menggunakan Android 17 atau yang lebih baru, Anda dapat menggunakan perintah ADB dari terminal untuk mencantumkan dan memanggil fungsi. Menjalankan adb shell cmd app_function list-app-functions akan menampilkan semua fungsi yang terdaftar untuk paket Anda. Kemudian, Anda dapat menjalankan fungsi tertentu dan menguji integrasi databasenya dengan menjalankan adb shell cmd app_function execute-app-function sambil meneruskan string parameter JSON mentah.
Selain perintah ADB ini, Anda juga dapat menggunakan Agen Pengujian AppFunctions untuk memeriksa konfigurasi, mencantumkan, dan menjalankan AppFunctions, serta melihat perilaku AppFunctions dalam alur percakapan yang sebenarnya.
Kesimpulan
Saat memikirkan fitur aplikasi yang dapat dikontribusikan ke sistem kecerdasan menggunakan AppFunctions, kita perlu sedikit mengubah cara berpikir tentang kode dan dokumentasi. AppFunctions memungkinkan Anda menggunakan model interaksi baru ini untuk aplikasi, yang memungkinkan penggunaan agen untuk mengakses fitur aplikasi.
Pertama, kemampuan pengembangan AppFunctions adalah alat siklus proses yang penting, yang membantu Anda menemukan fitur, mengimplementasikan, dan menyempurnakan AppFunctions untuk aplikasi Anda. Kedua, komentar KDoc adalah aset API yang dikompilasi; deskripsi parameter yang jelas berdampak langsung pada akurasi eksekusi agen sistem. Terakhir, MCP Android menyediakan eksekusi lokal-first yang memungkinkan aplikasi berkolaborasi dengan aman dengan agen AI.
Dengan berkontribusi pada fitur aplikasi melalui AppFunctions, aplikasi Anda akan siap untuk sistem kecerdasan. Beri tahu kami cara Anda menyesuaikan aplikasi untuk era agentic.
Pelajari lebih lanjut
Baca bagian lain dari rangkaian postingan blog ini:
Bagian 1: Pengantar aplikasi dan ringkasan tingkat tinggi.
Bagian 2: Kecerdasan di perangkat. Pelajari lebih dalam API GenAI ML Kit dan Gemini Nano untuk membangun fitur yang mengutamakan privasi seperti ringkasan itinerari, penguraian tanda terima, dan pemrosesan audio lokal.
Bagian 3: Penalaran hybrid dan cloud. Pelajari cara menggunakan Firebase AI Logic untuk mendasarkan jawaban LLM pada data dunia nyata seperti Google Maps dan konteks web.
Bagian 4 (postingan ini!): Integrasi sistem. Mengintegrasikan dengan sistem kecerdasan Android menggunakan AppFunctions.
Bagian 5 (segera hadir): Agentic Workflows dalam aplikasi. Perluas aplikasi dengan asisten pemesanan menyeluruh yang didukung oleh A2UI dan ADK.
Tertarik untuk mempelajari lebih lanjut Pengembangan Android? Ikuti Android Developers di YouTube atau LinkedIn.
Semua cuplikan kode dalam postingan blog ini mengikuti pemberitahuan hak cipta berikut:
Copyright 2026 Google LLC. SPDX-License-Identifier: Apache-2.0
-
PetunjukSelamat datang kembali di rangkaian postingan blog "Membangun aplikasi Android yang cerdas". Di sini, Anda akan mengubah aplikasi Android dasar menjadi pengalaman yang dipersonalisasi, cerdas, dan agentic. Dalam postingan sebelumnya, Anda telah mempelajari cara terhubung ke sistem kecerdasan menggunakan AppFunctions.
Jolanda Verhoef • Waktu baca: 9 menit -
PetunjukSelamat datang kembali di rangkaian postingan blog "Membangun aplikasi Android yang cerdas". Di sini, kita akan mengubah aplikasi Android dasar menjadi pengalaman yang dipersonalisasi, cerdas, dan agentic.
Thomas Ezan, Jolanda Verhoef, Caren Chang • Waktu baca: 8 menit -
PetunjukSelamat datang kembali di rangkaian postingan blog "Membangun aplikasi Android yang cerdas". Di sini, kita akan mengubah aplikasi Android dasar menjadi pengalaman yang dipersonalisasi, cerdas, dan agentic. Dalam postingan sebelumnya, kami memperkenalkan Jetpacker, aplikasi demo yang akan kami gunakan di sepanjang seri ini.
Caren Chang • Waktu baca: 6 menit
Dapatkan insight pengembangan Android terbaru yang dikirim ke kotak masuk Anda setiap minggu.