ブログ投稿シリーズ「インテリジェントな Android アプリを構築する」へようこそ。このシリーズでは、基本的な Android アプリを、パーソナライズされたインテリジェントなエージェント エクスペリエンスに変換する方法を紹介します。前回の投稿では、AppFunctions を使用してインテリジェンス システムに接続する方法を学びました。
この投稿では、クラウドで実行される自律型のAgentic Workflowsをアプリ内に構築する方法について説明します。
1 つのデバイス セッションではタスクが複雑すぎる場合があります。たとえば、休暇の旅行プランを完全に予約するには、フライト時間の調整、ホテルの部屋の選択、美術館のチケットの予約、レストランの予約の計画が必要です。このマルチステップ プロセスをモバイル デバイスで直接実行すると、アプリが終了して進行状況が失われる可能性があります。これらの手順と API 認証情報をすべてスマートフォンで管理することも、すぐに複雑になります。
このような長時間実行されるマルチステップ ワークフローには、カスタムのセルフホスト型バックエンドを使用できます。バックエンドはバックグラウンドで予約エージェントを実行し、Android アプリはセッションに接続して進行状況を可視化し、必要な場合にのみユーザー入力をリクエストします。
クラウドでホストされるエージェント バックエンドを使用すると、次のようなメリットがあります。
- バックグラウンドでの実行: 予約エージェントはクラウドで自律的に実行されるため、モバイルアプリがバックグラウンドに移行したり、インターネット接続が切断されたりしても、進行状況が失われることはありません。
- 複雑なマルチエージェント オーケストレーション: コーディネーター エージェントは、専門のサブエージェントに予約を委任し、それらの間の依存関係を処理できます。
- クライアントに依存しない UI レンダリング: バックエンドがインターフェース構造を動的に記述するため、新しいクライアント バージョンをリリースすることなく UI レイアウトを更新できます。
これらのメリットを念頭に置いて、Jetpacker に予約アシスタントを追加しました。このアシスタントは、フライト、ホテル、美術館、レストランの予約を調整します。Agent Development Kit(ADK)を活用したマルチエージェント システムを、Agent-User Interaction プロトコル(AG-UI)と Agent-to-User Interface プロトコル(A2UI)を使用してオーケストレートし、Jetpack Compose でインタラクティブなカードをネイティブに送信して表示する方法を見てみましょう。
ADK エージェントで複雑なワークフローを強化する
カスタム REST エンドポイントや複雑なウェブソケットを使用してオーケストレーション フローを手動で調整する代わりに、Agent Development Kit(ADK)を使用できます。ADK を使用すると、エージェントを定義し、データベースのクエリや予約の実行を行う Python 関数ツールをエージェントに搭載できます。
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 が実行ステップを管理します。会話のコンテキストを自動的に追跡し、ユーザーとモデル間でメッセージをルーティングします。また、モデルがリクエストしたときに登録済みのツールを実行します。これにより、フレームワークがバックグラウンドでオーケストレーションを処理する間、クリーンな手続き型ロジックの作成に集中できます。
このバックエンド エージェントを Jetpacker アプリに接続するには、サーバーが更新をリアルタイムでデバイスにストリーミングする方法が必要です。これは AG-UI プロトコルを使用して処理されます。また、エージェントは、インタラクティブなコンポーネント(オプション セレクタや座席グリッドなど)をスマートフォン上で動的に記述して更新するための構造化された方法も必要です。ここで A2UI プロトコルが役立ちます。
AG-UI によるエージェントとクライアント間の通信の標準化
クラウドでエージェントを実行し、Android で UI をレンダリングするには、標準の通信チャネルが必要です。この場合、AG-UI プロトコルを使用します。
AG-UI は、エージェントと UI クライアント間のメッセージ タイプを標準化する双方向トランスポート層プロトコルです。エージェントは、ライフサイクル イベント、テキスト メッセージ、ツール呼び出し、状態管理についてクライアントに通知できます。クライアントは、ユーザーのテキスト メッセージ、ツール呼び出しの結果、カスタム アクション イベントをエージェントに返信できます。
サーバーサイドでは、標準の Server-Sent Events(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 を作成できます。これにより、典型的な「chatbot」エクスペリエンスが実現します。
A2UI を使用してエージェントが UI を操作できるようにする
従来の chatbot は通常、書式なしテキストまたはカスタム 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 は、リアクティブ コンポーネントの状態の監視、マテリアル 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 サーフェスが表示されます。
まとめ
Agentic Workflows をクラウドでホストし、AG-UI プロトコルと A2UI プロトコルを組み合わせて使用することで、AI モデルによって直接駆動される動的なネイティブ Android インターフェースを構築できます。AG-UI は、メッセージとライフサイクル イベントのリアルタイム双方向ストリーミング チャネルを確立します。一方、A2UI は、クラウド エージェントがインタラクティブな UI コンポーネントを動的に記述できるようにし、クライアント アプリケーションをステップバイステップのバックエンド オーケストレーション ロジックから完全に分離します。
GitHub で Jetpacker のソースコード全体を確認し、動画「Google の AI を使用してインテリジェントな Android アプリを構築する」で、Agentic Workflows をアプリに直接統合する方法の詳細をご覧ください。
このブログ投稿シリーズの他のパートもご覧ください。
▪️ パート 1: アプリの紹介と概要。
📱 パート 2: オンデバイス インテリジェンス。ML Kit の GenAI API と Gemini Nano を詳しく学び、旅行プランの要約、領収書の解析、ローカル音声処理などのプライバシー重視の機能を構築します。
☁️ パート 3: ハイブリッドとクラウドの推論。Firebase AI Logic を使用して、Google マップやウェブ コンテキストなどの実際のデータで LLM の回答をグラウンディングする方法を学びます。
⚙️ パート 4: システム統合。AppFunctions を使用して Android インテリジェンス システムと統合する。
🤖 パート 5(この投稿): アプリ内 Agentic Workflows。A2UI と ADK を活用したエンドツーエンドの予約アシスタントでアプリを拡張します。
Android 開発についてさらに詳しく知りたい場合は、YouTube または LinkedIn で Android デベロッパーをフォローしてください。
このブログ投稿のすべてのコード スニペットは、次の著作権に関する通知に従います。
Copyright 2026 Google LLC. SPDX-License-Identifier: Apache-2.0
-
How-toブログ投稿シリーズ「インテリジェントな Android アプリを構築する」へようこそ。このシリーズでは、基本的な Android アプリを、パーソナライズされたインテリジェントなエージェント エクスペリエンスに変換する方法を紹介しています。
Thomas Ezan, Jolanda Verhoef, Caren Chang • 所要時間: 8 分 -
How-toJetpacker は、今年の Google I/O のために Google チームがゼロから構築した技術ショーケース アプリです(Antigravity を使用して構築)。Jetpacker は、ユーザーが次の大きな冒険を計画し、探索し、楽しむことを支援するアプリです。
Jolanda Verhoef • 所要時間: 4 分 -
How-toブログ投稿シリーズ「インテリジェントな Android アプリを構築する」へようこそ。このシリーズでは、基本的な Android アプリを、パーソナライズされたインテリジェントなエージェント エクスペリエンスに変換する方法を紹介しています。前回の投稿では、このシリーズ全体で使用するデモアプリ Jetpacker を紹介しました。
Caren Chang • 所要時間: 6 分
Android 開発に関する最新の分析情報を毎週メールでお届けします。