إنشاء تطبيقات Android ذكية: سير عمل مستند إلى الذكاء الاصطناعي الوكيل داخل التطبيق
مدّة القراءة: 9 دقائق
مرحبًا بكم من جديد في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية" التي نوضّح فيها كيفية تحويل تطبيق Android أساسي إلى تجربة مخصّصة وذكية واستباقية. في منشورنا السابق، تعرّفت على كيفية الربط بنظام الذكاء الاصطناعي باستخدام AppFunctions.
في هذه المقالة، ستتعرّف على كيفية إنشاء مهام سير عمل وكيلية مستقلة داخل التطبيق تعمل في السحابة الإلكترونية.
في بعض الأحيان، تكون المهمة معقّدة للغاية بحيث لا يمكن إنجازها في جلسة واحدة على الجهاز. على سبيل المثال، يتطلّب حجز برنامج رحلة كاملة تنسيق أوقات الرحلات الجوية واختيار غرف الفنادق وحجز تذاكر المتاحف والتخطيط لحجوزات المطاعم. إذا نفّذت هذه العملية المتعدّدة الخطوات مباشرةً على جهاز جوّال، قد يتم إغلاق التطبيق وفقدان مستوى تقدّمك. وتصبح إدارة كل هذه الخطوات وبيانات اعتماد واجهة برمجة التطبيقات على الهاتف معقّدة بسرعة أيضًا.
بالنسبة إلى مهام سير العمل الطويلة والمتعدّدة الخطوات، يمكنك استخدام خلفية مخصّصة مستضافة ذاتيًا. ينفّذ الخلفية وكلاء الحجز في الخلفية، بينما يتصل تطبيق Android بالجلسة، ويعرض مستوى التقدّم، ويطلب إدخال المستخدم عند الضرورة فقط.
يوفّر استخدام خلفية مستندة إلى وكيل مستضافة على السحابة الإلكترونية بعض المزايا:
- التنفيذ في الخلفية: تعمل وكلاء الحجز بشكل مستقل في السحابة الإلكترونية، لذا لا يتم فقدان مستوى التقدّم أبدًا إذا انتقل التطبيق على الأجهزة الجوّالة إلى الخلفية أو انقطع الاتصال بالإنترنت.
- تنسيق معقّد بين عدّة وكلاء: يمكن لوكيل منسِّق تفويض الحجوزات إلى وكلاء فرعيين متخصّصين والتعامل مع التبعيات بينهم.
- عرض واجهة المستخدم بشكل مستقل عن العميل: تصف الواجهة الخلفية بنية الواجهة بشكل ديناميكي، ما يتيح لك تعديل تصميم واجهة المستخدم بدون إصدار نسخة جديدة من العميل.
مع وضع هذه المزايا في الاعتبار، أضفنا مساعد حجز إلى Jetpacker الذي ينسق الرحلات الجوية والفنادق والمتاحف وحجوزات المطاعم. لنتعرّف على كيفية تنظيم نظام متعدد الوكلاء مستند إلى حزمة تطوير الوكلاء (ADK)، مع بروتوكول تفاعل الوكيل مع المستخدم (AG-UI) وبروتوكول واجهة الوكيل مع المستخدم (A2UI) لإرسال البطاقات التفاعلية وعرضها بشكل أصلي في Jetpack Compose.
تنفيذ سير العمل المعقّد باستخدام وكلاء ADK
بدلاً من تنسيق عملية التنسيق يدويًا باستخدام نقاط نهاية REST مخصّصة أو بروتوكولات WebSockets معقّدة، يمكنك استخدام حزمة تطوير الوكلاء (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 قناة اتصال عادية. لإجراء ذلك، عليك استخدام بروتوكول AG-UI.
AG-UI هو بروتوكول طبقة نقل ثنائي الاتجاه يوحّد أنواع الرسائل بين الوكلاء وعملاء واجهة المستخدم. يمكن للوكيل إبلاغ العميل بحدث يتم في مراحل النشاط والرسائل النصية وطلبات الأدوات وإدارة الحالة. في المقابل، يمكن للعميل إرسال رسائل نصية من المستخدم ونتائج طلبات الأدوات وأحداث الإجراءات المخصّصة إلى الوكيل.
وعلى جانب الخادم، ينتج عن ذلك تحديثات منسَّقة كأحداث عادية مرسَلة من الخادم (مثل event: TEXT_MESSAGE_CONTENT التي تحتوي على دلتا JSON). على أجهزة Android، تستمع حزمة تطوير البرامج (SDK) لـ Kotlin إلى هذا البث وتُعيّن تلقائيًا الحمولات إلى أحداث العميل التي تمنع أخطاء الكتابة:
// 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 الموحّدة. سيمنحك هذا تجربة "روبوت الدردشة" النموذجية:
السماح للوكيل بالتحدّث إلى واجهة المستخدم من خلال ميزة "من الوكيل إلى واجهة المستخدم" (A2UI)
عادةً ما تعرض برامج التتبُّع التقليدية نصًا عاديًا أو حمولات JSON مخصّصة. عند إنشاء واجهات معقّدة، على تطبيق العميل تحليل هذه البيانات وربطها بشاشات معيّنة مُعدّة مسبقًا. يؤدي ذلك إلى إنشاء تبعية: في كل مرة تضيف فيها ميزة جديدة أو تغيّر التنسيق أو تتيح تفاعلاً جديدًا للمستخدم، عليك تعديل كل من وكيل الخلفية والتطبيق للأجهزة الجوّالة. ويتطلّب ذلك نشر تحديث للتطبيق وانتظار المستخدمين لتثبيته.
لحلّ هذه المشكلة، استخدِم بروتوكول A2UI. تتيح واجهة A2UI للوكلاء وصف مكوّنات واجهة المستخدم لعرضها على العميل بشكل ديناميكي. يعلن تطبيق العميل عن قائمة بالمكوّنات التي يتيحها، ويرسل الخادم حمولة 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"
}
}
]
}
}يحدّد الخادم مكوّنات الكتالوج التي سيتم عرضها مع قيم السمات النشطة، ما يفصل تفاصيل التنفيذ المرئي للعميل عن حالة سير عمل الوكيل.
تصميم مخطط واجهة المستخدم الخلفية
لكي ينشئ الوكيل حمولات 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"]
)باستخدام تعليمات النظام التي تم إنشاؤها، يستند النموذج اللغوي الكبير إلى تنسيق المخطط ويعرف بدقة كيفية صياغة تحديثات المكوّنات التي يمكن لعميل Android عرضها.
عرض A2UI بشكل أصلي باستخدام Jetpack Compose
لعرض هذه المكوّنات بشكلٍ أصلي على 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 بدون كتابة أي مكوّنات مخصّصة.
ملاحظة: للحفاظ على توافق الواجهة الخلفية وعميل تطبيقات الجوّال، يعتمد كلاهما على رقم تعريف تعريف الكتالوج نفسه (https://example.com/catalogs/booking_assistant/v1/catalog.json). إذا أضفت سمات أو عدّلتها في كتالوج الواجهة الخلفية، يجب زيادة رقم الإصدار وتعديل فئة مكوّن Kotlin المطابقة لمنع حدوث أخطاء في التحليل اللغوي.
في BookingAssistantViewModel، تتم معالجة رسائل A2UI باستخدام A2uiMessageProcessor وتحديث مساحات العرض النشطة:
// 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، اجمَع هذه المساحات واعرض كلّ منها باستخدام الدالة المركّبة الرسمية A2uiSurface من androidx.compose.material3:material3-a2ui. يتعامل 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() ) } } } }
ستظهر لك الآن عدة مساحات عرض لواجهة المستخدم أنشأها الوكيل الذي يعمل في الخلفية:
جارٍ جمع كل المعلومات
من خلال استضافة سير عمل الوكلاء في السحابة الإلكترونية واستخدام بروتوكولَي AG-UI وA2UI معًا، يمكننا إنشاء واجهات Android ديناميكية ومدمجة تستند مباشرةً إلى نماذج الذكاء الاصطناعي. تنشئ AG-UI قناة بث ثنائية الاتجاه في الوقت الفعلي للرسائل والأحداث التي تتم في مراحل النشاط، بينما تتيح A2UI لوكيل السحابة الإلكترونية وصف مكوّنات واجهة المستخدم التفاعلية ديناميكيًا، ما يحافظ على فصل تطبيق العميل تمامًا عن منطق تنسيق الخلفية خطوة بخطوة.
يمكنك الاطّلاع على الرمز المصدر الكامل لتطبيق Jetpacker على GitHub، ومشاهدة فيديو إنشاء تطبيقات Android ذكية باستخدام تكنولوجيات الذكاء الاصطناعي من Google لمعرفة المزيد حول كيفية دمج مهام سير العمل المستندة إلى الذكاء الاصطناعي الوكيل مباشرةً في تطبيقك.
يمكنك الاطّلاع على الأجزاء الأخرى من سلسلة منشورات المدوّنة هذه:
▪️ الجزء 1: مقدمة عن التطبيق ونظرة عامة عالية المستوى
📱 الجزء 2: الذكاء الاصطناعي على الجهاز فقط تعرَّف على واجهات برمجة التطبيقات للذكاء الاصطناعي التوليدي في حزمة تعلّم الآلة وGemini Nano لإنشاء ميزات تركّز على الخصوصية، مثل تلخيص برامج الرحلات وتحليل الإيصالات ومعالجة الصوت على الجهاز.
☁️ الجزء 3: الاستدلال المختلط والسحابي. تعرَّف على كيفية استخدام Firebase AI Logic لربط إجابات النماذج اللغوية الكبيرة ببيانات من العالم الواقعي، مثل "خرائط Google" وسياق الويب.
⚙️ الجزء 4: دمج النظام. التكامل مع نظام Android الذكي باستخدام AppFunctions
🤖 الجزء الخامس (هذا المنشور): سير العمل المستند إلى الذكاء الاصطناعي الوكيل داخل التطبيق يمكنك توسيع نطاق التطبيق باستخدام مساعدي الحجز الشاملين المستندين إلى A2UI وADK.
هل يهمّك معرفة المزيد عن تطوير تطبيقات Android؟ يمكنك متابعة حساب مطوّري برامج Android على YouTube أو LinkedIn.
تتّبع جميع مقتطفات الرموز في منشور المدوّنة هذا إشعار حقوق الطبع والنشر التالي:
Copyright 2026 Google LLC. SPDX-License-Identifier: Apache-2.0
-
طرق التنفيذمرحبًا بكم من جديد في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية"، حيث نأخذ تطبيق Android أساسيًا ونحوّله إلى تجربة مخصّصة وذكية واستباقية.
Thomas Ezan, Jolanda Verhoef, Caren Chang • مدّة القراءة: 8 دقائق -
طرق التنفيذJetpacker هو تطبيق تقني لعرض الميزات أنشأه فريقنا من الصفر لمؤتمر Google I/O لهذا العام (باستخدام Antigravity). يساعد تطبيق Jetpacker المستخدمين في التخطيط لمغامرتهم الكبيرة التالية واستكشافها والاستمتاع بها.
Jolanda Verhoef • مدّة القراءة: 4 دقائق -
طرق التنفيذمرحبًا بكم من جديد في سلسلة منشورات المدوّنة "إنشاء تطبيقات Android ذكية"، حيث نأخذ تطبيق Android أساسيًا ونحوّله إلى تجربة مخصّصة وذكية واستباقية. في منشورنا السابق، قدّمنا Jetpacker، وهو التطبيق التجريبي الذي سنستخدمه في هذه السلسلة.
Caren Chang • مدّة القراءة: 6 دقائق
يمكنك الحصول على آخر الإحصاءات حول تطوير تطبيقات Android في بريدك الوارد أسبوعيًا.