1. खास जानकारी
ज़्यादातर एआई एजेंट, टेक्स्ट के ज़रिए जवाब देते हैं. इस कोडलैब में, A2UI का इस्तेमाल करके, अपने एजेंट को यूज़र इंटरफ़ेस के साथ जवाब देने की सुविधा दी जाएगी. एजेंट, स्टैंडर्ड कॉम्पोनेंट के कैटलॉग का इस्तेमाल करके, JSON में कार्ड, सूचियां, बटन, और फ़ॉर्म के बारे में बताता है. इसके बाद, क्लाइंट उन्हें अपने नेटिव विजेट के साथ रेंडर करता है. इसलिए, नए लेआउट के लिए नए फ़्रंटएंड कोड की ज़रूरत नहीं होती.
आपको Agent Development Kit (ADK) का इस्तेमाल करके एजेंट बनाना होगा.
आपको क्या बनाना है
क्लाउड इन्फ़्रास्ट्रक्चर के डैशबोर्ड का मॉकअप, तीन चरणों में दिखाया गया है:
- स्टैंडर्ड एजेंट, जो संसाधन का डेटा सादे टेक्स्ट के तौर पर दिखाता है
- एक A2UI एजेंट, जो स्ट्रक्चर्ड A2UI JSON के तौर पर वही डेटा दिखाता है
- रेंडर किया गया एजेंट, जो ADK के डेवलपर यूज़र इंटरफ़ेस (यूआई) में, A2UI JSON को इंटरैक्टिव यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट के तौर पर दिखाता है

आपको क्या सीखने को मिलेगा
- A2UI कैसे काम करता है: 18 प्रिमिटिव, यूज़र इंटरफ़ेस (यूआई) बनाने वाले मैसेज, और फ़्लैट कॉम्पोनेंट मॉडल
- एडीके एजेंट को A2UI JSON जनरेट करने के लिए प्रॉम्प्ट करने के लिए, A2UI SDK टूल का इस्तेमाल कैसे करें
adk webमें A2UI कॉम्पोनेंट रेंडर करने का तरीका
आपको किन चीज़ों की ज़रूरत होगी
- बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट
- कोई वेब ब्राउज़र, जैसे कि Chrome
- Python 3.12+ और uv, अगर आपको Cloud Shell के बजाय अपनी मशीन पर कोड चलाना है
यह कोडलैब, उन डेवलपर के लिए है जिन्हें Python और Google Cloud के बारे में कुछ जानकारी है.
इस कोडलैब को पूरा करने में करीब 20 मिनट लगते हैं.
इस कोडलैब में बनाए गए संसाधनों की लागत 5 डॉलर से कम होनी चाहिए.
2. अपना एनवायरमेंट सेट अप करने का तरीका
Google Cloud प्रोजेक्ट बनाना
- Google Cloud Console में, प्रोजेक्ट चुनने वाले पेज पर जाकर, Google Cloud प्रोजेक्ट चुनें या बनाएं.
- पक्का करें कि आपके क्लाउड प्रोजेक्ट के लिए बिलिंग की सुविधा चालू हो. किसी प्रोजेक्ट के लिए बिलिंग चालू है या नहीं, यह देखने का तरीका जानें.
Cloud Shell Editor शुरू करना
Google Cloud Console से Cloud Shell सेशन लॉन्च करने के लिए, Google Cloud Console में Cloud Shell चालू करें पर क्लिक करें.
इससे Google Cloud Console के सबसे नीचे वाले पैनल में एक सेशन शुरू होता है.
एडिटर लॉन्च करने के लिए, Cloud Shell विंडो के टूलबार पर मौजूद एडिटर खोलें पर क्लिक करें.
एपीआई चालू करें
Cloud Shell Editor के टूलबार में, टर्मिनल और नया टर्मिनल पर क्लिक करें. इसके बाद, ज़रूरी एपीआई चालू करने के लिए यह निर्देश चलाएं:
gcloud services enable aiplatform.googleapis.com
डिपेंडेंसी इंस्टॉल करना
इस कोडलैब के लिए फ़ोल्डर बनाने के लिए, टर्मिनल में ये कमांड चलाएं. इसमें a2ui_agent फ़ोल्डर में एजेंट कोड होगा. साथ ही, Agent Development Kit (ADK) और A2UI SDK इंस्टॉल होगा:
mkdir -p ~/adk-a2ui/a2ui_agent cd ~/adk-a2ui uv init --bare uv add google-adk a2ui-agent-sdk
uv, इस कोडलैब के लिए एक अलग Python एनवायरमेंट बनाता है. इसलिए, आपको कुछ भी चालू करने की ज़रूरत नहीं है. Python कमांड के पहले uv run प्रीफ़िक्स जोड़ें.
3. एजेंट बनाना
सबसे पहले, एक स्टैंडर्ड ADK एजेंट बनाएं, जो सादा टेक्स्ट दिखाता हो. फ़िलहाल, ज़्यादातर एजेंट ऐप्लिकेशन ऐसे ही दिखते हैं.
प्रोजेक्ट सेटिंग कॉन्फ़िगर करना
टर्मिनल में, अपने क्लाउड प्रोजेक्ट और जगह के हिसाब से a2ui_agent/.env बनाने के लिए यह निर्देश चलाएं. इससे ADK, आपके Google Cloud प्रोजेक्ट के ज़रिए Gemini को कॉल कर पाएगा. ADK इस फ़ाइल को अपने-आप लोड कर लेता है. इसलिए, सेटिंग नए टर्मिनल में भी काम करती हैं.
cat > ~/adk-a2ui/a2ui_agent/.env <<EOF GOOGLE_CLOUD_PROJECT=$(gcloud config get project) GOOGLE_CLOUD_LOCATION=global GOOGLE_GENAI_USE_ENTERPRISE=True EOF
टूल और मॉक डेटा तय करना
नीचे दिए गए कॉन्टेंट का इस्तेमाल करके a2ui_agent/resources.py बनाएं. यह टूल, क्लाउड संसाधनों की सूची और उनकी स्थिति दिखाता है.
RESOURCES = [
{
"name": "auth-service",
"type": "Cloud Run",
"region": "us-west1",
"status": "healthy",
"cpu": "2 vCPU",
"memory": "1 GiB",
"instances": 3,
"url": "https://auth-service-abc123.run.app",
"last_deployed": "2026-04-18T14:22:00Z",
},
{
"name": "events-db",
"type": "Cloud SQL",
"region": "us-east1",
"status": "warning",
"tier": "db-custom-8-32768",
"storage": "500 GB SSD",
"connections": 195,
"version": "PostgreSQL 16",
"issue": "Storage usage at 92%",
},
{
"name": "analytics-pipeline",
"type": "Cloud Run",
"region": "us-west1",
"status": "error",
"cpu": "2 vCPU",
"memory": "4 GiB",
"instances": 0,
"url": "https://analytics-pipeline-ghi789.run.app",
"last_deployed": "2026-04-10T16:45:00Z",
"issue": "CrashLoopBackOff: OOM killed",
},
]
def get_resources() -> list[dict]:
"""Get all cloud resources in the current project.
Returns a list of cloud infrastructure resources including their
name, type, region, status, and type-specific details.
Status is one of: healthy, warning, error. Resources with
warning or error status include an 'issue' field describing
the problem.
"""
return RESOURCES
एजेंट को तय करना
इन कॉन्टेंट का इस्तेमाल करके a2ui_agent/agent.py बनाएं:
from google.adk.agents import Agent
from google.adk.models import Gemini
from google.genai import types
from .resources import get_resources
root_agent = Agent(
model=Gemini(
model="gemini-3.8-flash",
retry_options=types.HttpRetryOptions(attempts=5),
),
name="cloud_dashboard",
description="A cloud infrastructure assistant that reports on project resources.",
instruction=(
"You are a cloud infrastructure assistant. When users ask about their "
"cloud resources, use the get_resources tool to fetch the current state. "
"Summarize the results clearly in plain text."
),
tools=[get_resources],
)
4. एजेंट को टेस्ट करना
ADK में डेवलपर यूज़र इंटरफ़ेस (यूआई) शामिल होता है. इसका इस्तेमाल करके, ब्राउज़र में अपने एजेंट के साथ इंटरैक्ट किया जा सकता है और उसे प्रॉम्प्ट भेजे जा सकते हैं. ऐसा टेस्टिंग के लिए किया जाता है.
ADK डेवलपमेंट यूज़र इंटरफ़ेस (यूआई) शुरू करें
ADK dev UI शुरू करने के लिए, Cloud Shell Editor टर्मिनल में यह निर्देश चलाएं:
uv run adk web --port 8080 --allow_origins "*" --reload_agents
आपको कुछ ऐसा मैसेज दिखेगा:
+-----------------------------------------------------------------------------+ | ADK Web Server started | | | | For local testing, access at http://127.0.0.1:8080. | +-----------------------------------------------------------------------------+
ADK का डेवलपर यूज़र इंटरफ़ेस (यूआई) खोलें
अपने ब्राउज़र में ADK dev UI खोलने के लिए, लोकल टेस्टिंग यूआरएल पर Ctrl या Cmd क्लिक करें. इसके अलावा, वेब प्रीव्यू बटन पर क्लिक करके, पोर्ट 8080 पर प्रीव्यू करें को चुनें.
ADK dev UI देखने के बाद, ड्रॉप-डाउन मेन्यू से a2ui_agent को चुनें.
प्रॉम्प्ट के सैंपल भेजना
एजेंट को सैंपल प्रॉम्प्ट भेजें:
What's running in my project?
अब कोई दूसरा सैंपल प्रॉम्प्ट आज़माएं. आपको ज़्यादा टेक्स्ट आउटपुट मिलेगा:
Does anything need my attention?
आपकी बातचीत कुछ ऐसी दिखनी चाहिए:

जवाब सटीक है, लेकिन इसमें बहुत ज़्यादा टेक्स्ट है.
5. A2UI JSON जनरेट करना
इसके बाद, एजेंट को सादे टेक्स्ट से A2UI पर स्विच करें.
A2UI Python SDK में एक प्रॉम्प्ट जनरेटर शामिल होता है. यह आपके लिए सिस्टम प्रॉम्प्ट लिखता है. इससे एलएलएम को A2UI कॉम्पोनेंट कैटलॉग, प्रॉपर्टी के सही नाम और टाइप, और JSON स्ट्रक्चर के बारे में पूरी जानकारी मिलती है.
एजेंट को अपडेट करना
a2ui_agent/agent.py के कॉन्टेंट को इससे बदलें:
from google.adk.agents import Agent
from google.adk.agents.callback_context import CallbackContext
from google.adk.models import Gemini
from google.adk.models.llm_response import LlmResponse
from google.genai import types
from a2ui.inference_formats.direct_json import DirectJsonFormat
from a2ui.basic_catalog.provider import BasicCatalog
from .resources import get_resources
a2ui_format = DirectJsonFormat(
version="0.8",
catalogs=[BasicCatalog.get_config("0.8")],
)
instruction = a2ui_format.prompt_generator.generate(
role_description=(
"You are a cloud infrastructure assistant. When users ask about "
"their cloud resources, use the get_resources tool to fetch the "
"current state."
),
workflow_description=(
"Analyze the user's request and return structured UI when appropriate."
),
ui_description=(
"Use cards for resource summaries, rows and columns for comparisons, "
"icons for status indicators, and buttons for drill-down actions. "
"Do NOT use markdown formatting in text values. Use the usageHint "
"property for heading levels instead. "
"Respond ONLY with the A2UI JSON array. Do NOT include any text "
"outside the JSON. Put all explanations into Text components."
),
include_schema=True,
include_examples=True,
)
def show_raw_json(
callback_context: CallbackContext,
llm_response: LlmResponse,
) -> LlmResponse | None:
"""Show the A2UI JSON as text so you can read it, instead of rendering it."""
if not llm_response.content or not llm_response.content.parts:
return None
for part in llm_response.content.parts:
if part.text:
part.text = (
part.text
.replace("<a2ui-json>", "```json\n")
.replace("</a2ui-json>", "\n```")
)
return llm_response
root_agent = Agent(
model=Gemini(
model="gemini-3.8-flash",
retry_options=types.HttpRetryOptions(attempts=5),
),
name="cloud_dashboard",
description="A cloud infrastructure assistant that renders rich A2UI interfaces.",
instruction=instruction,
tools=[get_resources],
after_model_callback=show_raw_json,
)
show_raw_json, A2UI JSON को टेक्स्ट के तौर पर दिखाता है, ताकि आप उसे पढ़ सकें. यूआई रेंडर देखने के लिए, इसे बाद में हटा दिया जाएगा.
prompt_generator.generate() तरीके में, आपकी भूमिका की जानकारी को A2UI के पूरे JSON स्कीमा और कुछ इनपुट-आउटपुट उदाहरणों के साथ दिया गया प्रॉम्प्ट के साथ जोड़ा जाता है. इससे एलएलएम को यह पता चलता है कि उसे अपने आउटपुट को किस तरह से फ़ॉर्मैट करना है. आपको कॉम्पोनेंट कैटलॉग को मैन्युअल तरीके से लिखने की ज़रूरत नहीं है.
इस कोडलैब में, A2UI के वर्शन 0.8 (version="0.8") का इस्तेमाल किया गया है. यह ऐसा वर्शन है जिसे adk web A2UI रेंडरर सपोर्ट करता है.
6. JSON फ़ॉर्मैट में मिले आउटपुट की जांच करना
अगर आपने ADK के डेवलपर यूज़र इंटरफ़ेस (यूआई) को पहले से चालू रखा है, तो यह आपके एजेंट में किए गए बदलावों को अपने-आप फिर से लोड कर देगा.
a2ui_agent को चुनें. इसके बाद, ADK dev UI के सबसे ऊपर दाईं ओर मौजूद, +नया सेशन पर क्लिक करके नया सेशन शुरू करें. इसके बाद, पहले वाला प्रॉम्प्ट फिर से भेजें:
What's running in my project?
इस बार, एजेंट सादे टेक्स्ट के बजाय A2UI JSON के साथ जवाब देता है. आपको चैट आउटपुट में, JSON कोड ब्लॉक में beginRendering और surfaceUpdate (और कभी-कभी dataModelUpdate) जैसे स्ट्रक्चर्ड मैसेज दिखेंगे.

JSON में कार्ड, आइकॉन, और बटन के साथ रिच यूज़र इंटरफ़ेस (यूआई) के बारे में बताया गया है. हालांकि, show_raw_json इसे टेक्स्ट के तौर पर सेव करता है, ताकि आप इसे पढ़ सकें. इसके बाद, आपको यह देखना होगा कि यह JSON कैसे स्ट्रक्चर किया गया है. इसके बाद, इसे असली यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट के तौर पर रेंडर करने के लिए, show_raw_json को हटाना होगा.
7. A2UI के बारे में जानकारी
आपके एजेंट ने अभी-अभी जो JSON जनरेट किया है उसे देखें. यूज़र इंटरफ़ेस (यूआई) बनाने के लिए, A2UI में तीन तरह के मैसेज होते हैं. ऐसा हो सकता है कि आपके एजेंट के जवाब में, हर बार इन तीनों का इस्तेमाल न किया जाए:
1. beginRendering
यह रेंडरिंग सर्फ़ेस बनाता है और रूट कॉम्पोनेंट का नाम देता है:
{"beginRendering": {"surfaceId": "default", "root": "main-column"}}
2. surfaceUpdate
यह आईडी रेफ़रंस के साथ कॉम्पोनेंट ट्री को फ़्लैट लिस्ट के तौर पर भेजता है (नेस्ट नहीं किया गया):
{"surfaceUpdate": {"surfaceId": "default", "components": [
{"id": "main-column", "component": {"Column": {"children": {"explicitList": ["title", "card1"]}}}},
{"id": "title", "component": {"Text": {"text": {"literalString": "My Resources"}, "usageHint": "h1"}}},
{"id": "card1", "component": {"Card": {"child": "card1-content"}}},
{"id": "card1-content", "component": {"Text": {"text": {"path": "service_name"}}}}
]}}
3. dataModelUpdate
यह स्ट्रक्चर से अलग डेटा भेजता है:
{"dataModelUpdate": {"surfaceId": "default", "contents": [
{"key": "service_name", "valueString": "auth-service"},
{"key": "status", "valueString": "healthy"}
]}}
कॉम्पोनेंट, {"path": "key"} का इस्तेमाल करके डेटा से बाइंड होते हैं. कॉम्पोनेंट ट्री को फिर से भेजे बिना, डेटा अपडेट किया जा सकता है.
18 प्रिमिटिव
कैटगरी | घटक |
लेआउट | कार्ड, कॉलम, लाइन, सूची, टैब, डिवाइडर, मोडल |
डिसप्ले | टेक्स्ट, इमेज, आइकॉन, वीडियो, ऑडियो प्लेयर |
इनपुट | TextField, DateTimeInput, MultipleChoice, CheckBox, Slider |
कार्रवाई | बटन |
एजेंट, इन्हीं कॉम्पोनेंट से अलग-अलग लेआउट बनाता है. जैसे, ब्राउज़ व्यू, प्राथमिकता वाला डैशबोर्ड या कॉन्फ़िगरेशन फ़ॉर्म. इनमें से हर एक के बारे में ज़्यादा जानकारी के लिए, कॉम्पोनेंट रेफ़रंस देखें.
8. A2UI कॉम्पोनेंट रेंडर करना
एसडीके, A2UI को स्टैंडर्ड टैग में रैप करता है. adk web उन्हें पहचानता है और अपने बिल्ट-इन A2UI रेंडरर की मदद से कॉम्पोनेंट रेंडर करता है. इसे देखने के लिए, show_raw_json को हटाएं.
एजेंट को अपडेट करना
a2ui_agent/agent.py के कॉन्टेंट को इससे बदलें. पिछले चरण से इस चरण में सिर्फ़ ये बदलाव हुए हैं: show_raw_json फ़ंक्शन, इसका after_model_callback पैरामीटर, और इसके लिए इस्तेमाल किए गए दो इंपोर्ट हटा दिए गए हैं:
from google.adk.agents import Agent
from google.adk.models import Gemini
from google.genai import types
from a2ui.inference_formats.direct_json import DirectJsonFormat
from a2ui.basic_catalog.provider import BasicCatalog
from .resources import get_resources
a2ui_format = DirectJsonFormat(
version="0.8",
catalogs=[BasicCatalog.get_config("0.8")],
)
instruction = a2ui_format.prompt_generator.generate(
role_description=(
"You are a cloud infrastructure assistant. When users ask about "
"their cloud resources, use the get_resources tool to fetch the "
"current state."
),
workflow_description=(
"Analyze the user's request and return structured UI when appropriate."
),
ui_description=(
"Use cards for resource summaries, rows and columns for comparisons, "
"icons for status indicators, and buttons for drill-down actions. "
"Do NOT use markdown formatting in text values. Use the usageHint "
"property for heading levels instead. "
"Respond ONLY with the A2UI JSON array. Do NOT include any text "
"outside the JSON. Put all explanations into Text components."
),
include_schema=True,
include_examples=True,
)
root_agent = Agent(
model=Gemini(
model="gemini-3.8-flash",
retry_options=types.HttpRetryOptions(attempts=5),
),
name="cloud_dashboard",
description="A cloud infrastructure assistant that renders rich A2UI interfaces.",
instruction=instruction,
tools=[get_resources],
)
9. रेंडर किए गए यूज़र इंटरफ़ेस (यूआई) की जांच करना
अगर आपने ADK के डेवलपर यूज़र इंटरफ़ेस (यूआई) को पहले से चालू रखा है, तो यह आपके एजेंट में किए गए बदलावों को अपने-आप फिर से लोड कर देगा.
ब्राउज़र टैब को रीफ़्रेश करें. इसके बाद, a2ui_agent को चुनें. अब ADK के डेवलपर यूज़र इंटरफ़ेस (यूआई) में सबसे ऊपर दाईं ओर मौजूद, +नया सेशन पर क्लिक करके नया सेशन शुरू करें. इसके बाद, वही प्रॉम्प्ट भेजें जो आपने पहले भेजा था:
What's running in my project?
इस बार, adk web, A2UI कॉम्पोनेंट को असली यूज़र इंटरफ़ेस (यूआई) के तौर पर रेंडर करता है. जैसे: स्टेटस इंडिकेटर वाले कार्ड, संसाधन की जानकारी, और ऐक्शन बटन.

किसी दूसरे प्रॉम्प्ट को आज़माकर देखें कि एजेंट, प्रिमिटिव के एक ही सेट से अलग-अलग यूज़र इंटरफ़ेस (यूआई) कैसे बनाता है:
Does anything need my attention?
आखिर में, नई सेवा को डिप्लॉय करने के लिए, कोई दूसरा यूज़र इंटरफ़ेस (यूआई) जनरेट करने के लिए, कोई दूसरा प्रॉम्प्ट आज़माएं:
I need to deploy a new service
तीनों प्रॉम्प्ट में एक ही एजेंट, टूल, और कॉम्पोनेंट का इस्तेमाल किया गया है. हालांकि, हर प्रॉम्प्ट से अलग-अलग यूज़र इंटरफ़ेस (यूआई) जनरेट हुए हैं, जो आपकी क्वेरी के हिसाब से हैं.
10. स्टोरेज में जगह बनाएं
लोकल सर्वर को चालू रखने से बचने के लिए, संसाधनों को बंद करें:
adk webचलाने वाले टर्मिनल में, एजेंट सर्वर को रोकने के लिए Ctrl+C दबाएं.
अगर आपने यह प्रोजेक्ट सिर्फ़ इस कोडलैब के लिए बनाया है, तो पूरा प्रोजेक्ट मिटाया जा सकता है:
gcloud projects delete <YOUR_PROJECT_ID>
11. बधाई हो
आपने A2UI का इस्तेमाल करके, एक ऐसा ADK एजेंट बनाया है जो रिच और इंटरैक्टिव यूज़र इंटरफ़ेस (यूआई) जनरेट करता है.
आपने क्या सीखा
- A2UI एक प्रोटोकॉल है. इसमें 18 डिक्लेरेटिव प्रिमिटिव और कुछ आसान मैसेज होते हैं, जो यूज़र इंटरफ़ेस (यूआई) बनाते हैं
- A2UI SDK, सिस्टम प्रॉम्प्ट जनरेट करता है. इससे एलएलएम को कॉम्पोनेंट कैटलॉग के बारे में जानकारी मिलती है
- एक ही एजेंट, टूल, और प्रिमिटिव का इस्तेमाल करके, अलग-अलग इंटेंट के लिए अलग-अलग यूज़र इंटरफ़ेस (यूआई) बनाए जाते हैं
- A2UI कॉम्पोनेंट को डेवलपमेंट के दौरान सीधे
adk webमें रेंडर किया जा सकता है
प्रोडक्शन फ़्रंटएंड बनाना
इस कोडलैब में, आपने डेवलपमेंट और टेस्टिंग के लिए adk web में A2UI को रेंडर किया.
प्रोडक्शन के लिए, आधिकारिक A2UI रेंडरर में से किसी एक का इस्तेमाल करके फ़्रंटएंड बनाया जाता है:
प्लैटफ़ॉर्म | प्रतिपादक | इंस्टॉल करें |
वेब (React) |
|
|
वेब (लिट) |
|
|
वेब (Angular) |
|
|
मोबाइल/डेस्कटॉप | Flutter GenUI SDK |
रेफ़रंस के लिए दस्तावेज़
- A2UI की खास जानकारी और दस्तावेज़
- A2UI GitHub repo
- A2UI रेंडरर
- ADK के बारे में दस्तावेज़
- ADK A2UI इंटिग्रेशन
आगे क्या करना है
Gemini Enterprise Agent Ready (GEAR) की मदद से, एंटरप्राइज़-ग्रेड के एजेंट बनाने और उन्हें डिप्लॉय करने के लिए, लर्निंग के संसाधनों के बारे में जानें.