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

Akıllı Android uygulamaları geliştirme: Uygulama içi temsilci tabanlı iş akışları

Okuma süresi: 9 dk.
Jolanda Verhoef'in profilini görüntüle
Jolanda Verhoef 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üğünüz "Akıllı Android uygulamaları geliştirme" blog yayını serisine tekrar hoş geldiniz. Önceki yayınımızda, AppFunctions'ı kullanarak akıllı sisteme nasıl bağlanacağınızı öğrenmiştiniz.

Bu yayında, bulutta çalışan otonom uygulama içi temsilci iş akışlarını nasıl oluşturacağınızı öğreneceksiniz.

Bazen bir görev, tek bir cihaz oturumu için çok karmaşık olabilir. Örneğin, eksiksiz bir seyahat planı oluşturmak için uçuş saatlerini koordine etmek, otel odalarını seçmek, müze biletlerini ayırtmak ve restoran rezervasyonlarını planlamak gerekir. Bu çok adımlı işlemi doğrudan bir mobil cihazda çalıştırırsanız uygulama kapatılabilir ve ilerlemeniz kaybolabilir. Tüm bu adımları ve API kimlik bilgilerini bir telefonda yönetmek de kısa sürede karmaşık hale gelir.

Bu uzun süreli, çok adımlı iş akışları için özel bir barındırılan arka uç kullanabilirsiniz. Arka uç, rezervasyon temsilcilerini arka planda çalıştırırken Android uygulaması oturuma bağlanır, ilerleme durumunu görselleştirir ve yalnızca gerektiğinde kullanıcıdan giriş ister.

Bulutta barındırılan bir temsilci tabanlı arka uç kullanmanın birkaç avantajı vardır:

  • Arka planda yürütme: Rezervasyon temsilcileri bulutta otonom olarak çalıştığından, mobil uygulama arka plana geçerse veya internet bağlantısı kesilirse ilerleme durumu hiçbir zaman kaybolmaz.
  • Karmaşık çoklu temsilci düzenlemesi: Bir koordinatör temsilci, rezervasyonları uzmanlaşmış alt temsilcilere devredebilir ve aralarındaki bağımlılıkları yönetebilir.
  • İstemciden bağımsız kullanıcı arayüzü oluşturma: Arka uç, arayüz yapısını dinamik olarak tanımlayarak yeni bir istemci sürümü yayınlamadan kullanıcı arayüzü yerleşimini güncellemenize olanak tanır.
booking-assistant.png
Rezervasyon asistanı, tüm rezervasyon ilerleme durumunu etkinlik türüne göre düzenlenmiş olarak gösterir.

Bu avantajları göz önünde bulundurarak Jetpacker'a uçuş, otel, müze ve restoran rezervasyonlarını koordine eden bir Rezervasyon Asistanı ekledik. Agent Development Kit (ADK) tarafından desteklenen, Agent-User Interaction protokolü (AG-UI) ve Agent-to-User Interface protokolü (A2UI) ile etkileşimli kartları yerel olarak Jetpack Compose'da gönderip görüntüleyen çoklu temsilci sistemini nasıl oluşturduğumuzu inceleyelim.

ADK temsilcileriyle karmaşık iş akışlarını destekleme

Özel REST uç noktaları veya karmaşık web soketleri kullanarak düzenleme akışını manuel olarak koordine etmek yerine Agent Development Kit'i (ADK) kullanabilirsiniz. ADK ile temsilciler tanımlayabilir ve bunları veritabanlarını sorgulamak ve rezervasyonları gerçekleştirmek için Python işlev araçlarıyla donatabilirsiniz.

diagram.png
Android uygulaması, mevcut seyahat planı verilerini sunucuya gönderir. Koordinatör temsilci, hangi alt temsilcilerin tetikleneceğini seçer. Her alt temsilci, sonuçlarını Android uygulamasına geri aktaran paylaşılan bir oturum sırasına gönderir.

Basit bir temsilci tanımlamak ve ADK kullanarak çalıştırmak için aşağıdaki adımları uygulayın:

# server/main.py

# Note: ADK supports many different coding languages. For now, we use the Python version as it includes support for A2UI which we'll use later in this blog post.

from google.adk import Agent
from google.adk.runners import InMemoryRunner
from google.adk.tools import FunctionTool

# Define custom tools to interact with database
def search_flights(destination: str, date: str) -> list[str]:
    # In production, here you would query our flight database and return dynamic results
    return ["10:00 AM", "2:00 PM"]

def reserve_flight(flight_time: str) -> str:
    # In production, here you would save the reservation transaction
    return "Reserved flight at " + flight_time

# Instantiate the booking agent with specialized tools
flight_agent = Agent(
    name="Flight Booker",
    model="gemini-3.1-flash-lite",
    instruction="Help the user search for flights and book a reservation.",
    tools=[
        FunctionTool(search_flights),
        FunctionTool(reserve_flight, require_confirmation=True)
    ]
)

# Run the agent in memory using a session ID
runner = InMemoryRunner(flight_agent)
async for event in runner.run_async(user_id=user_id, session_id=session_id):
    if event.content:
        print("Agent said:", event.content)

Bu kurulumu kullanarak bir temsilci çalıştırdığınızda ADK, yürütme adımlarını sizin için yönetir. Sohbet bağlamını otomatik olarak takip eder, kullanıcı ile model arasında mesajları yönlendirir ve model istediğinde kayıtlı araçları çalıştırır. Bu sayede, çerçeve arka planda düzenlemeyi gerçekleştirirken siz de temiz prosedür mantığı yazmaya odaklanabilirsiniz.

web_debug.png


Bu arka uç temsilcisini Jetpacker uygulamamıza bağlamak için sunucunun, güncellemeleri cihaza anlık olarak aktarması gerekir. Bu işlem, AG-UI protokolü kullanılarak gerçekleştirilir. Temsilcinin, telefondaki etkileşimli bileşenleri (seçenek belirleyiciler ve koltuk düzenleri gibi) dinamik olarak tanımlamak ve güncellemek için yapılandırılmış bir yönteme de ihtiyacı vardır. A2UI protokolü bu noktada devreye girer.

AG-UI ile temsilci-müşteri iletişimini standartlaştırma

Temsilcileri bulutta çalıştırmak ve kullanıcı arayüzünü Android'de oluşturmak için standart bir iletişim kanalı gerekir. Bunun için AG-UI protokolünü kullanacaksınız.

AG-UI, temsilciler ile kullanıcı arayüzü istemcileri arasındaki mesaj türlerini standartlaştıran çift yönlü bir aktarım katmanı protokolüdür. Temsilci, istemciyi yaşam döngüsü olayları, kısa mesajlar, araç çağrıları ve durum yönetimi hakkında bilgilendirebilir. İstemci de kullanıcı kısa mesajlarını, araç çağrısı sonuçlarını ve özel işlem etkinliklerini temsilciye geri gönderebilir.

Sunucu tarafında, standart sunucu tarafından gönderilen etkinlikler (JSON delta içeren event: TEXT_MESSAGE_CONTENT gibi) olarak biçimlendirilmiş güncellemeler sağlar. Android'de Kotlin SDK'sı bu akışı dinler ve yükleri otomatik olarak tür açısından güvenli istemci etkinlikleriyle eşler:

// BookingAssistantViewModel.kt

import com.agui.client.agent.HttpAgent
import com.agui.client.agent.HttpAgentConfig
import com.agui.core.types.RunAgentInput
import com.agui.core.types.UserMessage
import com.agui.core.types.TextMessageStartEvent
import com.agui.core.types.TextMessageContentEvent
import com.agui.core.types.TextMessageEndEvent

val config = HttpAgentConfig(
    agentId = "booking-assistant",
    threadId = threadId,
    url = "https://<your-backend-url>"
)
val agent = HttpAgent(config, httpClient)

// Set up the input with the session thread and user instruction
val input = RunAgentInput(
    threadId = threadId,
    runId = runId,
    messages = listOf(UserMessage("Book a flight to Paris"))
)

// Run the agent flow and collect lifecycle events
agent.runAgentObservable(input)
    .collect { event ->
        when (event) {
            is TextMessageStartEvent -> { /* ... */ }
            is TextMessageContentEvent -> { /* ... */ }
            is TextMessageEndEvent -> {
                // Handle the completed message
            }
        }
    }

Ardından, bu farklı türdeki standartlaştırılmış AG-UI etkinliklerini oluşturmak için bir kullanıcı arayüzü yazabilirsiniz. Bu sayede tipik bir "Chatbot" deneyimi yaşayabilirsiniz:

manage_bookings.png
Kullanıcının asistanla sohbet etmesine olanak tanıyan temel bir arayüz.

A2UI ile temsilcinin kullanıcı arayüzüyle iletişim kurmasını sağlama

Geleneksel chatbot'lar genellikle düz metin veya özel JSON yükleri döndürür. Karmaşık arayüzler oluştururken istemci uygulamanın bu yükleri ayrıştırması ve önceden oluşturulmuş belirli ekranlarla eşlemesi gerekir. Bu durum bir bağımlılık oluşturur: Yeni bir özellik eklediğinizde, düzeni değiştirdiğinizde veya yeni bir kullanıcı etkileşimini desteklediğinizde hem arka uç temsilcisini hem de mobil uygulamayı güncellemeniz gerekir. Bunun için bir uygulama güncellemesi yayınlamanız ve kullanıcıların bu güncellemeyi yüklemesini beklemeniz gerekir.

Bu sorunu çözmek için A2UI protokolünü kullanın. A2UI, temsilcilerin istemcide dinamik olarak oluşturulacak kullanıcı arayüzü bileşenlerini tanımlamasına olanak tanır. İstemci uygulaması, desteklediği bileşenlerin kataloğunu bildirir ve sunucu, bileşen düzenini ve özelliklerini belirten bir JSON yükü gönderir:

{
  "version": "v0.9",
  "updateComponents": {
    "surfaceId": "Flight Reservation",
    "components": [
      {
        "id": "flight_option_picker",
        "component": "InteractiveOptionPicker",
        "properties": {
          "prompt": "Select a flight time:",
          "options": [
            "10:00 AM",
            "2:00 PM"
          ],
          "selectedIdx": null,
          "confirmBtnText": "Confirm Flight"
        }
      }
    ]
  }
}

Sunucu, hangi katalog bileşenlerinin etkin özellik değerleriyle birlikte oluşturulacağını belirterek istemcinin görsel uygulama ayrıntılarını temsilcinin iş akışı durumundan net bir şekilde ayırır.

Arka uç kullanıcı arayüzü şemasını tasarlama

Temsilcinin bu JSON yüklerini doğru şekilde oluşturabilmesi için hangi bileşenlerin mevcut olduğunu ve hangi özellikleri kabul ettiğini bilmesi gerekir.

Bunun için ADK A2UI entegrasyonunu kullanın. A2uiSchemaManager, kataloğumuzdaki her bileşen için istem talimatlarını manuel olarak yazmak yerine JSON şemalarını ve düzen talimatlarını doğrudan sistem isteminde derler. Bu sayede model, geçerli A2UI yükleri oluşturmak için uyması gereken tam yapıyı ve biçimlendirme kurallarını öğrenir:

# server/main.py

from a2ui.schema.manager import A2uiSchemaManager
from a2ui.schema.constants import VERSION_0_9
from a2ui.schema.catalog import CatalogConfig
from a2ui.basic_catalog.provider import BasicCatalog

# Initialize A2UI Schema Manager with custom booking component catalog
schema_manager = A2uiSchemaManager(
    version=VERSION_0_9,
    catalogs=[
        BasicCatalog.get_config(version=VERSION_0_9),
        CatalogConfig.from_path(
            name="https://example.com/catalogs/booking_assistant/v1/catalog.json",
            catalog_path="booking_catalog.json"
        )
    ]
)

# Compile prompt instructions including the A2UI JSON schema
A2UI_SYSTEM_INSTRUCTION = schema_manager.generate_system_prompt(
    role_description="You are a helpful travel booking assistant.",
    ui_description="Use InteractiveOptionPicker for choices, SeatSelectionPicker for seat selection...",
    include_schema=True,
    include_examples=True,
    allowed_components=["InteractiveOptionPicker", "SeatSelectionPicker", "BookingStatus"]
)

Bu şekilde oluşturulan sistem talimatı sayesinde LLM, şema düzenine dayalı olarak Android istemcisinin oluşturabileceği bileşen güncellemelerini tam olarak nasıl formüle edeceğini bilir.

Jetpack Compose ile A2UI'yi yerel olarak oluşturma

Bu bileşen ağaçlarını Android'de yerel olarak oluşturmak için yeni Jetpack Compose A2UI Renderer kitaplığını kullanın.

Öncelikle bağımlılıkları modülümüzün build.gradle.kts dosyasına ekleyin:

// android/feature/trip/booking_assistant/build.gradle.kts
dependencies {
    implementation("androidx.a2ui:a2ui-model:1.0.0-alpha01")
    implementation("androidx.a2ui.compose:compose-runtime:1.0.0-alpha01")
    implementation("androidx.a2ui.compose:compose-ui:1.0.0-alpha01")
    implementation("androidx.compose.material3:material3-a2ui:1.0.0-alpha01")
}

Katalogdaki her bileşen sınıfı (ör. BookingStatusComponent), JSON yükünden alınan özelliklerin Jetpack Compose composable işleviyle nasıl eşleneceğini tanımlar.

Özel bileşenleri bir kataloğa kaydetme:

// CustomBookingAssistantCatalog.kt

import androidx.a2ui.compose.ui.A2uiCatalog

fun bookingAssistantCatalog(): A2uiCatalog {
    return A2uiCatalog(
        catalogId = "https://example.com/catalogs/booking_assistant/v1/catalog.json",
        components = listOf(
            InteractiveOptionPickerComponent(),
            SeatSelectionPickerComponent(),
            BookingStatusComponent()
        )
    )
}

İpucu: Jetpacker, rezervasyon akışları için özel olarak tasarlanmış özel bileşenler (InteractiveOptionPicker, SeatSelectionPicker, BookingStatus) uygular. Temsilciniz standart öğeler (ör. metin, kartlar, düğmeler, satırlar, sütunlar, onay kutuları ve tarih-saat seçiciler) kullanıyorsa material3-a2ui, materialA2uiBasicCatalogV1(...) de sağlar. Böylece özel bileşenler yazmadan kullanıma hazır Material 3 uygulamaları elde edersiniz.

Not: Arka uç ve mobil uygulama istemcisinin uyumlu kalması için her ikisi de aynı katalog tanım kimliğini (https://example.com/catalogs/booking_assistant/v1/catalog.json) kullanır. Arka uç kataloğuna özellik ekler veya mevcut özellikleri değiştirirseniz ayrıştırma hatalarını önlemek için sürüm numarasını artırmanız ve eşleşen Kotlin bileşen sınıfını güncellemeniz gerekir.

BookingAssistantViewModel içinde, A2uiMessageProcessor kullanarak A2UI mesajlarını işleyin ve etkin yüzeylerimizi güncelleyin:

// BookingAssistantViewModel.kt
import androidx.lifecycle.ViewModel
import androidx.a2ui.model.processor.A2uiSurfaceModel
import androidx.a2ui.compose.ui.A2uiMessageProcessor
import kotlinx.coroutines.flow.StateFlow

class BookingAssistantViewModel : ViewModel() {
    private val messageProcessor = A2uiMessageProcessor(
        catalogs = listOf(bookingAssistantCatalog())
    )
    val activeSurfaces: StateFlow<List<A2uiSurfaceModel>> = messageProcessor.activeSurfaces
    
    init {
        viewModelScope.launch(Dispatchers.Default) { processor.collectMessages() }
    }

    // ...
}

Oluşturma ekranında bu yüzeyleri toplayın ve androidx.compose.material3:material3-a2ui'dan resmi A2uiSurface composable'ı kullanarak her birini oluşturun. A2uiSurface; reaktif bileşen durumu gözlemini, Material 3 yükleme göstergelerini, hata yedeklerini ve güncellemeler arasındaki animasyonlu geçişleri otomatik olarak yönetir:

// BookingAssistantScreen.kt
import androidx.compose.runtime.Composable
import androidx.compose.runtime.collectAsState
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.a2ui.A2uiSurface

@Composable
fun BookingAssistantScreen(
    viewModel: BookingAssistantViewModel,
    modifier: Modifier = Modifier
) {
    val activeSurfaces by viewModel.activeSurfaces.collectAsState()
    LazyColumn(
        modifier = modifier.fillMaxWidth(),
        verticalArrangement = Arrangement.spacedBy(16.dp)
    ) {
        items(activeSurfaces) { surfaceModel ->
            Card(modifier = Modifier.fillMaxWidth()) {
                A2uiSurface(
                    surfaceModel = surfaceModel,
                    modifier = Modifier.fillMaxWidth().wrapContentHeight()
                )
            }
        }
    }
}

Arka uçta çalışan temsilcimiz tarafından oluşturulan çeşitli kullanıcı arayüzü yüzeylerini göreceksiniz:

booking-assistant.png
Kullanıcıyla etkileşim kurmak için metin yerine kullanıcı arayüzünü kullanan, iyi tasarlanmış bir rezervasyon asistanı.

Tümünü bir araya getirin

Temsilci iş akışlarını bulutta barındırarak ve AG-UI ile A2UI protokollerini birlikte kullanarak doğrudan yapay zeka modelleri tarafından yönlendirilen dinamik, yerel Android arayüzleri oluşturabiliriz. AG-UI, mesajlar ve yaşam döngüsü olayları için gerçek zamanlı çift yönlü akış kanalını oluşturur. A2UI ise bulut temsilcisinin etkileşimli kullanıcı arayüzü bileşenlerini dinamik olarak tanımlamasını sağlayarak istemci uygulamasını adım adım arka uç düzenleme mantığından tamamen ayırır.

GitHub'da Jetpacker'ın kaynak kodunun tamamını inceleyin ve temsilci tabanlı iş akışlarını doğrudan uygulamanıza nasıl entegre edeceğiniz hakkında daha fazla bilgi edinmek için Google'ın yapay zekasıyla akıllı Android uygulamaları geliştirme videosunu izleyin.

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 akıllı özellikler. 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ı bir şekilde 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: Sistem entegrasyonu. AppFunctions'ı kullanarak Android Intelligence System ile entegrasyon
🤖 5. bölüm (bu yazı): Uygulama içi temsilci tabanlı iş akışları. A2UI ve ADK tarafından desteklenen uçtan uca rezervasyon asistanlarıyla uygulamayı 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