방법

지능형 Android 앱 빌드: 인앱 에이전트 워크플로

읽는 데 9분 소요
욜란다 페르후프님의 프로필 보기
Jolanda Verhoef 개발자 관계 엔지니어

'지능형 Android 앱 빌드' 블로그 게시물 시리즈에 다시 오신 것을 환영합니다. 이 시리즈에서는 기본 Android 앱을 맞춤설정된 지능형 에이전트 환경으로 변환하는 방법을 알아봅니다. 이전 게시물에서는 AppFunctions를 사용하여 인텔리전스 시스템에 연결하는 방법을 알아봤습니다.

이 게시물에서는 클라우드에서 실행되는 자율적인 인앱 에이전트 워크플로를 빌드하는 방법을 알아봅니다.

단일 기기 세션에서 처리하기에는 작업이 너무 복잡한 경우가 있습니다. 예를 들어 휴가 일정을 모두 예약하려면 항공편 시간을 조율하고, 호텔 객실을 선택하고, 박물관 티켓을 예약하고, 레스토랑을 예약해야 합니다. 휴대기기에서 이 다단계 프로세스를 직접 실행하면 앱이 종료되고 진행 상황이 손실될 수 있습니다. 휴대전화에서 이러한 모든 단계와 API 사용자 인증 정보를 관리하는 것도 금방 복잡해집니다.

이러한 장기 실행 다단계 워크플로의 경우 커스텀 자체 호스팅 백엔드를 사용할 수 있습니다. 백엔드는 백그라운드에서 예약 에이전트를 실행하고, Android 앱은 세션에 연결하여 진행 상황을 시각화하고 필요한 경우에만 사용자 입력을 요청합니다.

클라우드 호스팅 에이전트형 백엔드를 사용하면 다음과 같은 몇 가지 이점이 있습니다.

  • 백그라운드 실행: 예약 에이전트는 클라우드에서 자율적으로 실행되므로 모바일 앱이 백그라운드로 전환되거나 인터넷 연결이 끊겨도 진행 상황이 손실되지 않습니다.
  • 복잡한 멀티 에이전트 조정: 조정자 에이전트는 전문 하위 에이전트에 예약을 위임하고 이들 간의 종속 항목을 처리할 수 있습니다.
  • 클라이언트 제약 없는 UI 렌더링: 백엔드가 인터페이스 구조를 동적으로 설명하므로 새 클라이언트 버전을 출시하지 않고도 UI 레이아웃을 업데이트할 수 있습니다.
booking-assistant.png
예약 어시스턴트는 모든 예약 진행 상황을 이벤트 유형별로 정리하여 표시합니다.

이러한 이점을 염두에 두고 Jetpacker에 항공편, 호텔, 박물관, 레스토랑 예약을 조정하는 예약 어시스턴트를 추가했습니다. 에이전트 개발 키트(ADK)를 기반으로 하는 멀티 에이전트 시스템을 에이전트-사용자 상호작용 프로토콜(AG-UI) 및 에이전트-사용자 인터페이스 프로토콜(A2UI)과 함께 조정하여 Jetpack Compose에서 기본적으로 대화형 카드를 전송하고 표시하는 방법을 살펴보겠습니다.

ADK 에이전트로 복잡한 워크플로 지원

커스텀 REST 엔드포인트나 복잡한 웹 소켓을 사용하여 조정 흐름을 수동으로 조정하는 대신 에이전트 개발 키트(ADK)를 사용할 수 있습니다. ADK를 사용하면 에이전트를 정의하고 Python 함수 도구를 탑재하여 데이터베이스를 쿼리하고 예약을 실행할 수 있습니다.

diagram.png
Android 앱은 현재 이동 운항 일정 데이터를 서버로 전송합니다. 코디네이터 에이전트는 트리거할 하위 에이전트를 선택합니다. 각 하위 에이전트는 결과를 Android 앱으로 다시 스트리밍하는 공유 세션 큐에 결과를 제공합니다.

간단한 에이전트를 정의하고 ADK를 사용하여 실행하는 방법은 다음과 같습니다.

# 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)

이 설정을 사용하여 에이전트를 실행하면 ADK가 실행 단계를 관리합니다. 대화 컨텍스트를 자동으로 추적하고, 사용자와 모델 간에 메시지를 라우팅하며, 모델이 요청할 때 등록된 도구를 실행합니다. 이를 통해 프레임워크가 백그라운드에서 조정을 처리하는 동안 깔끔한 절차적 로직을 작성하는 데 집중할 수 있습니다.

web_debug.png


이 백엔드 에이전트를 Jetpacker 앱에 연결하려면 서버가 실시간으로 업데이트를 기기에 스트리밍할 수 있어야 합니다. 이 작업은 AG-UI 프로토콜을 사용하여 처리됩니다. 또한 에이전트는 전화에서 대화형 구성요소(예: 옵션 선택기, 좌석 그리드)를 동적으로 설명하고 업데이트하는 구조화된 방법이 필요합니다. 이때 A2UI 프로토콜이 사용됩니다.

AG-UI를 사용한 에이전트-클라이언트 통신 표준화

클라우드에서 에이전트를 실행하고 Android에서 UI를 렌더링하려면 표준 통신 채널이 필요합니다. 이를 위해 AG-UI 프로토콜을 사용합니다.

AG-UI는 에이전트와 UI 클라이언트 간의 메시지 유형을 표준화하는 양방향 전송 계층 프로토콜입니다. 에이전트는 클라이언트에게 수명 주기 이벤트, 문자 메시지, 도구 호출, 상태 관리를 알릴 수 있습니다. 클라이언트는 사용자 문자 메시지, 도구 호출 결과, 커스텀 작업 이벤트를 에이전트에 다시 전송할 수 있습니다.

서버 측에서는 표준 서버 전송 이벤트(예: JSON 델타가 포함된 event: TEXT_MESSAGE_CONTENT) 형식의 업데이트를 생성합니다. Android에서 Kotlin SDK는 이 스트림을 수신 대기하고 페이로드를 유형 안전 클라이언트 이벤트에 자동으로 매핑합니다.

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

그런 다음 이러한 다양한 유형의 표준화된 AG-UI 이벤트를 렌더링하는 UI를 작성할 수 있습니다. 이렇게 하면 전형적인 '챗봇' 환경이 제공됩니다.

manage_bookings.png
사용자가 어시스턴트와 채팅할 수 있는 기본 인터페이스입니다.

A2UI를 사용하여 에이전트가 UI를 말하도록 하기

기존 챗봇은 일반적으로 일반 텍스트 또는 커스텀 JSON 페이로드를 반환합니다. 복잡한 인터페이스를 빌드할 때 클라이언트 애플리케이션은 이러한 페이로드를 파싱하고 미리 빌드된 특정 화면에 매핑해야 합니다. 이로 인해 종속 항목이 생성됩니다. 새 기능을 추가하거나 레이아웃을 변경하거나 새 사용자 상호작용을 지원할 때마다 백엔드 에이전트와 모바일 애플리케이션을 모두 업데이트해야 합니다. 이렇게 하려면 앱 업데이트를 게시하고 사용자가 설치할 때까지 기다려야 합니다.

이 문제를 해결하려면 A2UI 프로토콜을 사용합니다. A2UI를 사용하면 상담사가 클라이언트에서 렌더링할 UI 구성요소를 동적으로 설명할 수 있습니다. 클라이언트 앱은 지원하는 구성요소 카탈로그를 선언하고 서버는 구성요소 레이아웃과 속성을 지정하는 JSON 페이로드를 전송합니다.

{
  "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"
        }
      }
    ]
  }
}

서버는 활성 속성 값과 함께 렌더링할 카탈로그 구성요소를 지정하여 클라이언트의 시각적 구현 세부정보를 에이전트의 워크플로 상태에서 깔끔하게 분리합니다.

백엔드 UI 스키마 설계

에이전트가 이러한 JSON 페이로드를 올바르게 생성하려면 어떤 구성요소를 사용할 수 있고 어떤 속성을 허용하는지 알아야 합니다.

이렇게 하려면 ADK A2UI 통합을 사용합니다. 카탈로그의 모든 구성요소에 대한 프롬프트 안내를 수동으로 작성하는 대신 A2uiSchemaManager가 JSON 스키마와 레이아웃 안내를 시스템 프롬프트에 직접 컴파일합니다. 이렇게 하면 모델이 유효한 A2UI 페이로드를 생성하기 위해 따라야 하는 정확한 구조와 형식 규칙을 학습할 수 있습니다.

# 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"]
)

이 생성된 시스템 안내를 통해 LLM은 스키마 레이아웃에 기반을 두고 Android 클라이언트가 렌더링할 수 있는 구성요소 업데이트를 정확하게 구성하는 방법을 알 수 있습니다.

Jetpack Compose를 사용하여 A2UI를 기본적으로 렌더링

Android에서 이러한 구성요소 트리를 네이티브로 렌더링하려면 새로운 Jetpack Compose A2UI Renderer 라이브러리를 사용하세요.

먼저 모듈의 build.gradle.kts 파일에 종속 항목을 추가합니다.

// 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")
}

카탈로그의 각 구성요소 클래스(예: BookingStatusComponent)는 JSON 페이로드에서 수신된 속성을 Jetpack Compose 컴포저블 함수에 매핑하는 방법을 정의합니다.

카탈로그에 커스텀 구성요소를 등록합니다.

// 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()
        )
    )
}

도움말: Jetpacker는 예약 흐름에 맞게 맞춤설정된 맞춤 구성요소(InteractiveOptionPicker, SeatSelectionPicker, BookingStatus)를 구현합니다. 에이전트가 표준 요소(예: 텍스트, 카드, 버튼, 행, 열, 체크박스, 날짜-시간 선택 도구)를 사용하는 경우 material3-a2ui는 materialA2uiBasicCatalogV1(...)도 제공하므로 커스텀 구성요소를 작성하지 않고도 바로 사용할 수 있는 Material 3 구현을 제공합니다.

참고: 백엔드와 모바일 클라이언트를 일치시키기 위해 둘 다 동일한 카탈로그 정의 ID(https://example.com/catalogs/booking_assistant/v1/catalog.json)를 사용합니다. 백엔드 카탈로그에서 속성을 추가하거나 수정하는 경우 버전 번호를 늘리고 일치하는 Kotlin 구성요소 클래스를 업데이트하여 파싱 오류를 방지해야 합니다.

BookingAssistantViewModel에서 A2uiMessageProcessor를 사용하여 A2UI 메시지를 처리하고 활성 표시 경로를 업데이트합니다.

// 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() }
    }

    // ...
}

Compose 화면에서 이러한 표시 경로를 수집하고 androidx.compose.material3:material3-a2ui의 공식 A2uiSurface 컴포저블을 사용하여 각 표시 경로를 렌더링합니다. A2uiSurface는 반응형 구성요소 상태 관찰, Material 3 로딩 표시기, 오류 대체, 업데이트 간 애니메이션 전환을 자동으로 처리합니다.

// 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()
                )
            }
        }
    }
}

이제 백엔드에서 실행되는 에이전트가 생성한 여러 UI 표시 경로가 표시됩니다.

booking-assistant.png
텍스트 대신 UI를 사용하여 사용자와 상호작용하는 잘 설계된 예약 어시스턴트입니다.

총정리

클라우드에서 에이전트 워크플로를 호스팅하고 AG-UI 및 A2UI 프로토콜을 함께 사용하면 AI 모델로 직접 구동되는 동적인 네이티브 Android 인터페이스를 빌드할 수 있습니다. AG-UI는 메시지와 수명 주기 이벤트를 위한 실시간 양방향 스트리밍 채널을 설정하고, A2UI는 클라우드 에이전트가 대화형 UI 구성요소를 동적으로 설명할 수 있도록 하여 클라이언트 애플리케이션을 단계별 백엔드 조정 로직과 완벽하게 분리합니다.

GitHub에서 Jetpacker의 전체 소스 코드를 확인하고 Google AI로 지능형 Android 앱 빌드하기 동영상을 시청하여 에이전트 워크플로를 앱에 직접 통합하는 방법을 자세히 알아보세요.

이 블로그 게시물 시리즈의 다른 부분도 확인해 보세요.
▪️ 1부: 앱 소개 및 대략적인 개요
📱 2부: 온디바이스 인텔리전스 ML Kit의 GenAI API와 Gemini Nano를 자세히 살펴보고 여행 일정 요약, 영수증 파싱, 로컬 오디오 처리와 같은 개인 정보 보호 우선 기능을 빌드하세요.
☁️ 3부: 하이브리드 및 클라우드 추론. Firebase AI Logic을 사용하여 Google 지도 및 웹 컨텍스트와 같은 실제 데이터에 LLM 답변을 그라운딩하는 방법을 알아봅니다.
⚙️ 4부: 시스템 통합. AppFunctions를 사용하여 Android 인텔리전스 시스템과 통합
🤖 5부(이 게시물): 인앱 에이전트형 워크플로 A2UI 및 ADK를 기반으로 하는 엔드 투 엔드 예약 어시스턴트로 앱을 확장합니다.

Android 개발에 관해 더 자세히 알아보고 싶으신가요? YouTube 또는 LinkedIn에서 Android 개발자를 팔로우하세요.

이 블로그 게시물의 모든 코드 스니펫은 다음 저작권 고지를 따릅니다.

Copyright 2026 Google LLC.
SPDX-License-Identifier: Apache-2.0
작성자:
계속 읽기