"Nasıl yapılır?" rehberleri

Akıllı Android uygulamaları geliştirme: AppFunctions'ı kullanarak Android'in akıllı sistemine entegre etme

Okuma süresi: 6 dk.
Ben Weiss'ın profilini görüntüle
Ben Weiss Geliştirici İlişkileri Mühendisi

Temel bir Android uygulamasını kişiselleştirilmiş, akıllı ve temsilci tabanlı bir deneyime dönüştürdüğümüz "Akıllı Android uygulamaları geliştirme" blog yayını serisine tekrar hoş geldiniz. Önceki yazımızda, bulutta barındırılan ve hibrit yapay zeka özellikleri oluşturmak için Firebase AI Logic'ten nasıl yararlanabileceğinizi incelemiştik.

Geleneksel mobil kullanıcı arayüzleri, odaklanma gerektiren ve uygulamalı görevlerde mükemmel performans gösterir. Android'in akıllı sistemi ise karmaşık ve çok adımlı işlemleri daha da kolaylaştırmak için tamamlayıcı özellikler sunar. AppFunctions, geleneksel kullanıcı arayüzlerini tamamlayarak güçlü ve yeni bir giriş noktası sağlar: Cihazdaki ayrıcalıklı bir temsilci, uygulama özelliklerine arka planda erişebilir. Bu özellik, özellikle kullanıcılar araç kullanırken, yürürken veya başka işlerle uğraşırken faydalı olabilir.

Bu makalede, Android AppFunctions'ı kullanarak bu özellikleri nasıl tasarladığımızı ve seyahat planlama uygulamamız JetPacker'a nasıl entegre ettiğimizi göstereceğiz. Özellik seçimlerimizin ardındaki mantığı inceleyecek, geliştirmeyi hızlandırmak için kullandığımız özel araçları tartışacak ve her şeyin çalışmasını sağlayan koda dalacağız.

Yapay zekaya hazır özellikler tasarlama: Kullanıcılarınız için önemli olan seçimler yapma

Akıllı sisteme hangi özellikleri sağlayacağımızı seçmek için sesli veya yazılı komutun ekranlara dokunmaktan daha hızlı olduğu görevleri aradık. Bu yan yana ekran kaydedicisi kaydında bu farkı net bir şekilde görebilirsiniz: Solda, bir harcamayı kaydetmek için birden fazla ekrana dokunan bir kullanıcı; sağda, aynı görevin ayrıcalıklı bir ajan aracılığıyla arka planda anında tamamlanması.

İlk tercihimiz harcama takibiydi. Seyahat sırasında kahve masrafını kaydetmek genellikle telefonun kilidini açma, uygulamayı açma, aktif seyahati bulma, masraflar sekmesine gitme, ekle düğmesine dokunma, makbuzun fotoğrafını çekme ve sonucu kontrol etme gibi birçok dokunma işlemi gerektirir. addExpense ve getExpenses özellikleri AppFunctions olarak sunulduğunda zorlu işleri sistem temsilcisi üstlenir. Kullanıcı, "Paris gezime beş dolarlık bir kahve harcaması ekle" dediğinde temsilci, arka planda otomatik olarak doğru gezi kimliğini arar ve harcamayı ekler. Böylece manuel kullanıcı arayüzü akışını tamamen atlar.

Seyahat planı yönetimine de öncelik verdik. Yoğun bir seyahat planında bir sonraki etkinliğin ne olduğunu bulmak için genellikle yoğun bir zaman çizelgesi görünümünde gezinmek gerekir. Kullanıcı, sisteme getItinerary ve addItineraryEvent bilgilerini vererek "Paris'te bir sonraki etkinliğim ne?" diye sorup hemen yanıt alabilir.

Son olarak, eller serbest not alma özelliğine odaklandık. Kalabalık bir sokakta yürürken hatırlatıcı veya not yazmak zor ve tehlikelidir. Sesli not özelliğini kullanıma sunarak kullanıcının "Uçuş harikaydı, güzel bir gün batımı gördüm ve iyi uyuyabildim" demesini sağlayabilirsiniz. Ayrıcalıklı temsilci, addVoiceNote AppFunction'ı kullanarak bu sesli notu otomatik olarak metne dönüştürür ve doğrudan seyahat veritabanına kaydeder.

AppFunctions tarafından desteklenen Android MCP

Bu deneyimin tamamı Android MCP üzerine kuruludur. Bu tasarımda uygulama, yerel bir MCP sunucusu olarak çalışır. Uygulama özelliklerinizi uzak API'ler yerine doğrudan cihaz üzerinde akıllı sisteme sağlarsınız.

Android AppFunctions, bu konsepti hayata geçiren API'dir. Ek açıklamalı Kotlin işlevlerini okur ve bunları, ayrıcalıklı temsilcinin cihazda yerel olarak keşfedip çağırabileceği, tür açısından güvenli, korumalı alan içine alınmış araç tanımlarına derler.

Android MCP diagram.png
Uygulamalarımızı, Android platformunu ve sistem aracılarının AppFunctions'ı nasıl koordine ettiğini vurgulayan diyagram.

Android MCP modelinde uygulamanız, yapılandırılmış araçları sunan yerel bir MCP sunucusu olarak çalışır. Android platformu ise merkezi araç kaydı görevi görür. MCP istemci tarafında, temsilci uygulamaları, kayıt defterine erişmek için sistem ayrıcalıklı izinler verildikten sonra akıllı sisteme kaydedilir.

Kullanıcı, kayıtlı bir temsilciyle etkileşime girdiğinde temsilcinin LLM'si, isteğin bir AppFunction tarafından işlenip işlenemeyeceğini belirler, platformun meta verilerini sorgular ve arka planda uygun kayıtlı işlevleri yürütür. Bu yerel MCP istemci-sunucu tasarımı size tam kontrol sağlar: Temsilcinin tam olarak hangi özelliklere erişebileceğini seçerken uygulamanızın geri kalan verilerini gizli tutabilirsiniz.

Android becerileriyle geliştirme sürecini nasıl hızlandırdık?

Entegrasyon sürecini kolaylaştırmak için AppFunctions geliştirme becerisinden yararlandık. AppFunctions geliştirme becerisi, eksiksiz bir geliştirme yardımcısıdır. Tüm yaşam döngüsü boyunca bize rehberlik etti: Parametreleri serileştirmek için Kotlin veri sınıflarını eşleme, gerekli Service giriş noktalarını oluşturma, LLM'nin parametre sınırlarını anlamasını sağlamak için KDoc dokümanlarımızı hassaslaştırma ve ADB kullanarak otomatik testler ayarlama.

Uygulama özelliklerini akıllı sisteme sağlama

Teorik bilgileri bir kenara bırakıp uygulamaya geçelim.

Yapılandırma ve bağımlılık kurulumu

AppFunctions bağımlılıklarını ekleyerek başlayacağız. Biri API, diğeri ise Kotlin Sembol İşleme derleyicisi için.

implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10")

Özel veri türlerini modelleme

Temsilciyle paylaşılan tüm özel nesneler @AppFunctionSerializable ile ek açıklama içermelidir. TripSerializable.kt dosyamızda gezi veri modelimizi tanımlıyoruz:

@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>,
)

@AppFunction ek açıklamasını kullanarak özellik sağlama

Ardından beceri, veritabanı sorgularını gerçekleştiren Kotlin işlevlerini yazdı ve bunları @AppFunction ile ekledi. Bunu searchTrip'te görebiliriz:

/**
 * 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
}

AppFunctions varsayılan olarak kullanıcı arayüzü iş parçacığında çalıştığından arka plan dağıtıcısına geçmek için withContext(Dispatchers.IO) kullanırız. Ayrıca, KDoc'umuzu net, emir kipi fiiller kullanacak ve parametre kısıtlamalarını belirtecek şekilde hassaslaştırıyoruz. Bu dokümanlar doğrudan aracın şemasına derlenir. Ayrıcalıklı temsilci, parametreleri çözmek ve çalışma zamanı hatalarını işlemek için bu şemayı kullanır.

Hizmet giriş noktası ve Hilt entegrasyonu

Bu özellikleri akıllı sisteme kaydetmek için AppFunctionService sınıfını genişleten soyut bir temel sınıf oluştururuz. Bunu @AppFunctionServiceEntryPoint ile ek açıklama olarak ekleriz:

@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...
}

Derleme sırasında KSP, serviceName parametresiyle tanımlanan nihai somut hizmet alt sınıfını (JetPackerAppFunctionService) oluşturur. Ayrıca uygulamanın manifest dosyasında app_metadata.xml öğesini de kaydederiz. Bu dosya, JetPacker'ın beyan edilen AppFunctions'ı için genel operasyonel kurallar sağlar.

AppFunctions'ınızı test etme ve doğrulama

Uygulandıktan sonra AppFunctions'ın kayıtlı ve doğru şekilde çalıştığını doğrulamanız gerekir.

Android 17 veya daha yeni sürümlerin yüklü olduğu cihazlarda ya da emülatörlerde, işlevlerinizi listelemek ve çağırmak için terminalinizden ADB komutlarını kullanabilirsiniz. adb shell cmd app_function list-app-functions komutunu çalıştırdığınızda paketiniz için kayıtlı tüm işlevler gösterilir. Ardından, ham bir JSON parametre dizesi iletirken adb shell cmd app_function execute-app-function komutunu çalıştırarak belirli bir işlevi yürütebilir ve veritabanı entegrasyonunu test edebilirsiniz.

Bu ADB komutları yerine AppFunctions Testing Agent'ı kullanarak yapılandırmanızı inceleyebilir, AppFunctions'ı listeleyip çalıştırabilir ve hatta AppFunctions'ın gerçek bir görüşme akışında nasıl davrandığını görebilirsiniz.

Sonlandırılıyor

AppFunctions kullanılarak akıllı sisteme katkıda bulunabilecek uygulama özellikleri hakkında düşünürken kod ve dokümanlar hakkındaki düşüncelerimizi biraz değiştirmemiz gerekir. AppFunctions, uygulamalar için bu yeni etkileşim modelini kullanmanıza olanak tanır. Bu model, uygulama özelliklerine erişmek için bir temsilci kullanmanızı sağlar.

İlk olarak, AppFunctions geliştirme becerisi, özellikleri keşfetmenize, uygulamalarınız için AppFunctions'ı uygulamanıza ve hassaslaştırmanıza yardımcı olan önemli bir yaşam döngüsü aracıdır. İkinci olarak, KDoc yorumları derlenmiş bir API öğesidir. Net parametre açıklamaları, sistem temsilcisinin yürütme doğruluğunu doğrudan etkiler. Son olarak, Android MCP, uygulamaların yapay zeka ajanlarıyla güvenli bir şekilde ortak çalışmasına olanak tanıyan yerel öncelikli yürütme sağlar.

Uygulama özelliklerini AppFunctions aracılığıyla eklemek, uygulamanızı akıllı sisteme hazır hale getirir. Uygulamalarınızı temsilci çağına nasıl uyarladığınızı bizimle paylaşın.

Daha fazla bilgi

Bu blog yayını serisinin diğer bölümlerine göz atın:
1. Bölüm: Uygulamanın tanıtımı ve genel bakış.
2. Bölüm: Cihaz üzerinde zeka. Seyahat planı özeti, makbuz ayrıştırma ve yerel ses işleme gibi gizlilik öncelikli özellikler oluşturmak için ML Kit'in üretken yapay zeka API'lerini ve Gemini Nano'yu ayrıntılı olarak inceleyin.
3. bölüm: Hibrit ve bulut tabanlı akıl yürütme. LLM yanıtlarını Google Haritalar ve web bağlamı gibi gerçek dünya verilerine dayandırmak için Firebase AI Logic'i nasıl kullanacağınızı öğrenin.
4. bölüm (bu yayın): Sistem entegrasyonu. AppFunctions'ı kullanarak Android Intelligence System ile entegrasyon.
5. bölüm (yakında): Uygulama içi temsilci tabanlı iş akışları. Uygulamayı, A2UI ve ADK tarafından desteklenen uçtan uca rezervasyon asistanıyla genişletin.

Android geliştirme hakkında daha fazla bilgi edinmek ister misiniz? Android Geliştiricileri'ni YouTube veya LinkedIn'de takip edin.

Bu blog yayınındaki tüm kod snippet'leri aşağıdaki telif hakkı bildirimine tabidir:

Copyright 2026 Google LLC.
SPDX-License-Identifier: Apache-2.0
Yazan:
Okumaya devam et