Panduan untuk mendesain Aplikasi Terhubung di berbagai produk Google seperti aplikasi Gemini dan Penelusuran.
Ringkasan
Aplikasi yang terhubung ke MCP memungkinkan pengguna menghubungkan model bahasa besar (LLM) di produk Google yang berlaku untuk membaca dan menulis data aplikasi Anda. Karena aplikasi Anda membagikan konteks percakapan, pengguna dapat menyelesaikan tugas dengan mudah tanpa beralih tab atau aplikasi. Tinjau panduan ini untuk memastikan aplikasi terhubung Anda disetujui untuk ditayangkan di seluruh produk Google yang berlaku.
Membuat Aplikasi Terhubung
Kapan harus menggunakan Aplikasi Terhubung
Buat Aplikasi Terhubung untuk skenario berikut:
- Tugas dengan awal dan akhir yang jelas, seperti melakukan pemesanan, membuat reservasi, atau mengunci jadwal.
- Informasi yang dapat ditindaklanjuti dan dapat langsung diterapkan pengguna.
- Alur kerja percakapan yang alami, seperti menganalisis data, meninjau dokumen, atau mengoordinasikan project.
- Fungsi inti yang memperluas kemampuan AI secara signifikan.
Alat Anda idealnya membantu pengguna menyelesaikan tindakan dengan bantuan AI, seperti membuat pemesanan atau menulis dokumen. Fokus pada tindakan kompleks yang dapat disederhanakan prosesnya oleh model dasar.
Yang perlu dihindari
Saat mendesain Aplikasi Terhubung, hindari pola berikut:
- Dropdown, menu konteks, dan panel popover: Elemen ini terpotong oleh batas penampung atau bertabrakan dengan UI platform host.
- Scroll bertingkat: Hindari men-scroll dalam penampung scroll.
- Tampilan berlapis-lapis: Jangan gunakan breadcrumb, atau antarmuka drill-in.
- Proses yang panjang: Hindari alur yang melebihi cakupan mode tampilan.
- Aplikasi web mandiri: Jangan mereplikasi aplikasi web lengkap.
- Tidak memenuhi ekspektasi: Saat pengguna melihat Aplikasi Terhubung dimuat, mereka mengharapkan tingkat utilitas dasar. Jangan membuat aplikasi hanya untuk merender fungsi sederhana, seperti satu tombol.
- Pengalihan otomatis: Jangan meluncurkan situs eksternal atau aplikasi native secara otomatis tanpa klik eksplisit pengguna pada link eksternal yang ditandai dengan jelas.
Penampung & tata letak
Penampung host membingkai aplikasi terhubung Anda bersama respons model. Penampung ini memberikan atribusi partner, batas yang konsisten, dan ukuran yang responsif di seluruh produk Google yang berlaku.
Anatomi container
- Header: Menampilkan ikon dan nama resmi partner.
- Konten: Muncul sebagai kartu inline atau carousel horizontal.
- Penyandingan teks respons: Mode tampilan selalu menyertai teks respons model. Desain di sekitar tata letak gabungan ini.
- Gaya UI: Mengikuti gaya penampung host di seluruh produk Google yang berlaku.
Perilaku responsif
Aplikasi Terhubung dirender di berbagai lebar penampung dan area pandang perangkat. Hindari dimensi tetap:
- Reflow secara horizontal: Gunakan tata letak fleksibel yang beradaptasi dengan rapi antara sidebar yang ringkas, layar seluler, dan feed desktop yang lebar tanpa pemangkasan horizontal.
- Sesuaikan konten secara vertikal: Biarkan penampung inline bertambah besar agar sesuai dengan kontennya hingga tinggi pembacaan yang nyaman. Jangan pernah mengisi kartu dengan ruang kosong tetap atau menjebak konten dalam scrollbar vertikal.
- Perhatikan input perangkat: Dukung gestur sentuh native dan area aman di perangkat seluler, serta status pengarahan kursor di desktop.
Yang perlu dihindari
- Hindari padding ganda: Aplikasi Terhubung menyertakan padding internal default untuk memenuhi standar sistem. Hapus padding tambahan dari konten internal untuk menghindari spasi yang tidak diinginkan.
- Hindari radius sudut yang tidak seimbang: Jaga agar bentuk internal tetap proporsional dengan radius sudut penampung host untuk menghindari sudut yang terlalu tajam atau membulat.
- Hindari menambahkan goresan Anda sendiri: Penampung menyertakan gaya batas yang ditentukan sistem secara default. Jangan menerapkan batas atau goresan tambahan di sekitar komponen internal.
Mode tampilan
Mode tampilan menentukan cara ekstensi Anda menampilkan UI visual langsung bersama respons produk Google yang berlaku. Gunakan salah satu dari dua mode tampilan utama: Kartu Inline atau Layar Penuh.
Kartu inline
Kartu inline adalah komponen ringan dengan satu tujuan yang disematkan langsung dalam alur respons. Gunakan kartu inline untuk konfirmasi cepat, pemeriksaan data terstruktur, atau tindakan satu langkah.
Kapan harus menggunakan kartu inline
- Pembaruan dan konfirmasi status.
- Tampilan atau pilihan data sederhana.
- Ringkasan singkat dengan perluasan opsional.
- Tindakan cepat yang melanjutkan percakapan.
Pedoman kepadatan dan pemotongan konten
- Pemotongan judul: Batasi judul kartu menjadi 1–2 baris dengan pemotongan elipsis agar header tidak pernah mendorong tindakan keluar dari tampilan.
- Batas isi & metadata: Batasi teks pendukung hingga 2–3 baris dan batasi metadata per item hingga 2–3 atribut yang dapat dipindai.
- Teks CTA yang ringkas: Gunakan label tindakan yang diawali dengan kata kerja (misalnya, "Pesan meja" atau "Konfirmasi pesanan") dan batasi footer kartu hingga maksimal 1 CTA utama dan 1 tindakan sekunder opsional.
Definisi carousel: Carousel harus berisi antara 3 dan 8 kartu untuk memungkinkan scroll tanpa menyebabkan kelelahan, dengan semua kartu mempertahankan dimensi tinggi dan lebar yang sama. Batasi judul kartu menjadi 1–2 baris dan batasi metadata menjadi 2–3 kolom per kartu.
Interaksi untuk kartu inline
Kartu inline harus berfokus pada tindakan cepat dan langsung yang membuat pengguna tetap berada dalam percakapan.
- Tindakan inline: Memungkinkan pengguna melakukan tindakan langsung di dalam kartu, seperti mengedit teks, menambahkan item, atau mencentang tugas.
- Pembaruan status: Mencerminkan tindakan pengguna yang kompleks langsung di rangkaian pesan, bukan di dalam entitas. Misalnya, saat pengguna memesan penginapan, buat kartu yang diperbarui yang menampilkan label "Dipesan" dalam percakapan.
Navigasi desktop carousel
- Mekanisme pengarahan kursor: Tombol ikon navigasi tetap tersembunyi secara default dan muncul saat kursor diarahkan ke penampung.
- Scrim tambahan: Status awal menampilkan scrim tepi kanan, Tengah menampilkan kedua tepi, dan Akhir menampilkan tepi kiri.
Pengalaman seluler carousel
- Gestur sentuh: Menggunakan geser horizontal native dengan celah di antara kartu carousel.
- Pengintipan kartu: Status awal menggunakan padding kiri, Tengah tidak menggunakan padding, dan Akhir menggunakan padding kanan.
Yang harus dihindari untuk kartu inline
- Hindari scroll bertingkat: Jangan pernah menyertakan scrollbar vertikal internal.
- Hindari penelusuran multi-tampilan: Jangan gunakan breadcrumb, tampilan multi-tab, dan penelusuran multi-langkah dilarang di dalam kartu inline. Pindahkan alur yang kompleks ke layar penuh.
- Hindari kontrol yang terlihat di atas menu: Jangan gunakan dropdown, popover, dan menu kontekstual, karena dapat menyebabkan pemangkasan penampung dan tabrakan indeks z.
- Hindari input duplikat: Jangan tempatkan input lain di dalam kartu, karena produk Google yang berlaku sudah memiliki input tersebut.
- Hindari scroll vertikal internal: Jangan tempatkan penampung yang dapat di-scroll di dalam kartu; hal ini menyebabkan scroll-trapping dan menurunkan kualitas navigasi seluler.
- Hindari popover: Karena menutupi konten dan mengacaukan UI, jangan gunakan tooltip atau overlay popover untuk menampilkan detail penting.
- Hindari menu dropdown: Jangan menyembunyikan tindakan di dalam pemilih dropdown. Tampilkan tindakan utama sebagai tombol eksplisit.
- Hindari menyembunyikan overflow scroll di carousel: Pastikan kartu yang berdekatan terlihat sehingga pengguna tahu bahwa ada lebih banyak konten yang tersedia untuk di-scroll.
- Hindari komponen error kustom: Jangan gunakan status error kustom; UI host akan memberikan komponen error standar secara konsisten di seluruh pengalaman.
- Hindari penggunaan modal: Aplikasi MCP tidak mendukung modal; jika Anda memerlukan lebih banyak ruang, berikan opsi untuk beralih ke mode layar penuh.
Layar penuh
Gunakan mode layar penuh sebagai kanvas imersif untuk tugas multi-langkah yang kaya atau alur kerja yang padat data yang tidak dapat dimuat dalam kartu inline.
Kapan harus menggunakan layar penuh
- Menjelajahi konten yang padat seperti listingan properti, menu, atau peta interaktif.
- Alur kerja yang kompleks, seperti mengedit kanvas atau diagram yang memerlukan ruang khusus di luar kartu inline.
- Data dan analisis, seperti melihat dasbor yang lengkap, visualisasi data, dan alat analisis mendetail yang memerlukan perhatian terfokus.
Tata letak dan interaksi untuk layar penuh
- Header: Menampilkan panel header yang disediakan sistem dengan atribusi dan tindakan aplikasi.
- Inset area aman: Pertahankan jarak yang jelas di bawah panel header untuk mencegah tumpang-tindih konten.
- Tutup dan buka: Menampilkan tombol untuk membuka dalam layar penuh, dan tombol tutup di header tampilan layar penuh.
Yang perlu dihindari untuk layar penuh
- Hindari mereplikasi aplikasi native Anda: Gunakan layar penuh untuk memperdalam interaksi pada tugas multilangkah yang terfokus.
- Hindari input duplikat: Karena produk Google yang berlaku sudah memiliki input, partner tidak boleh menempatkan input lain di dalam tampilan.
- Hindari panel mengambang: Jangan gunakan modal mengambang atau toolbar pemeriksa mengambang yang dapat ditarik, karena akan mengacaukan antarmuka dan bertabrakan dengan overlay permukaan host.
- Hindari tumpang-tindih area aman: Jauhkan elemen interaktif dari toolbar platform host dan indikator sistem, seperti status bar dan panel utama.
Panduan interaksi
Cara pengguna memanipulasi konten di dalam aplikasi yang terhubung, cara tindakan disinkronkan dengan percakapan host, dan kapan harus menyerahkan alur kerja yang kompleks ke aplikasi atau situs eksternal.
Pembagian tugas antara UI aplikasi dan percakapan
Desain aplikasi terhubung dan perintah percakapan Anda sebagai lapisan pelengkap:
- Gunakan UI aplikasi yang terhubung untuk manipulasi langsung: Gunakan UI untuk penjelajahan spasial seperti menggeser peta, membandingkan opsi terstruktur, kontrol formulir multi-kolom, dan pilihan visual yang akan membosankan atau ambigu jika menggunakan perintah teks.
- Gunakan percakapan host untuk intent terbuka: Gunakan percakapan untuk tindak lanjut bahasa alami, sintesis multi-langkah, dan kueri eksplorasi yang luas.
Pengungkapan progresif
- Pengungkapan progresif: Mulai dengan mode tampilan paling ringkas yang menjawab kebutuhan pengguna (Kartu Inline atau Carousel), mengungkapkan detail sekunder sesuai permintaan (Tampilkan lebih banyak), dan beralih ke layar penuh hanya jika diperlukan eksplorasi mendalam.
- Kontrol yang terlihat di atas menu tersembunyi: Tampilkan tindakan utama sebagai tombol atau tombol akses eksplisit, bukan menyembunyikannya di dalam toolbar khusus kursor, menu konteks klik kanan, atau gestur tekan lama yang gagal di area pandang seluler.
Pengalihan eksternal dan penautan keluar
Beberapa kemampuan melampaui cakupan iframe tersemat atau memerlukan fitur OS dan hardware native. Kapan harus menautkan ke aplikasi atau situs Anda:
- Fitur yang bergantung pada hardware atau OS native (misalnya, navigasi live, pengambilan gambar kamera atau sensor, atau audio latar belakang dan pelacakan lokasi yang berkelanjutan).
- Alur yang diatur atau sensitif terhadap keamanan (misalnya, checkout pembayaran akhir atau verifikasi identitas).
- Ruang kerja yang mendalam di luar layar penuh (misalnya, suite penulisan berfitur lengkap atau dasbor perusahaan yang kompleks).
Mendesain penyerahan
- Tampilkan affordance link eksternal yang jelas: Selalu pasangkan tombol handoff eksternal
dengan indikator peluncuran eksplisit (seperti ikon
open_in_new) dan label khusus tujuan (misalnya, "Buka di Google Maps"). - Deep link dengan konteks yang dipertahankan: Teruskan semua parameter yang ditetapkan dalam
percakapan ke URL deep link melalui API link eksternal host
(
openLink) sehingga pengguna tidak perlu memasukkan kembali pilihan mereka setelah beralih aplikasi.
Yang perlu dihindari
- Hindari pengalihan otomatis: Jangan pernah mengarahkan pengguna keluar dari platform host secara otomatis. Keluar dari platform host harus selalu memerlukan klik pengguna secara eksplisit.
- Hindari kartu "teaser" atau khusus link: Jangan membuat aplikasi terhubung yang tujuan utamanya adalah merender banner atau tombol statis yang mengarahkan pengguna ke situs Anda.
- Hindari pengalihan konteks yang tidak diumumkan: Jangan pernah menata gaya link eksternal secara identik dengan tindakan dalam kartu tanpa menunjukkan bahwa link tersebut membuka aplikasi eksternal atau tab browser.
Panduan visual
Produk Google yang berlaku memprioritaskan elemen UI yang ringan dan netral serta kontras yang lebih lembut untuk mengurangi beban kognitif.
Prinsip visual
Menerapkan prinsip desain inti untuk mengatur kepadatan dan estetika visual di seluruh Aplikasi Terhubung:
- UI yang lebih ringan dan minimal: Kurangi goresan dan elemen penampung untuk mempertahankan kepadatan visual yang bersih.
- Keseimbangan warna netral: Prioritaskan nuansa abu-abu netral, dan gunakan warna aksen untuk CTA utama.
- Elevasi: Terapkan isian permukaan yang lembut, batasi drop shadow secara eksklusif pada mode layar penuh dan kontrol navigasi carousel.
- Pewarisan gaya: Terapkan warna, tipografi, dan radius sudut agar aplikasi terasa native di setiap produk Google yang berlaku.
Warna
Produk Google yang berlaku mengatur warna menjadi dua grup fungsional: Warna sistem untuk tata letak struktural dan Warna aksen untuk momen merek utama. Mengandalkan peran semantik ini memastikan hierarki visual yang jelas dan adaptasi tema otomatis di seluruh produk.
Peran warna sistem
Memetakan warna struktural ke peran UI yang konsisten di seluruh Aplikasi Terhubung:
- Permukaan latar belakang: Gunakan warna permukaan netral yang disediakan host untuk penampung kartu dan pengelompokan bertingkat. Hindari mengganti latar belakang penampung dengan isian solid, gradien, atau pola kustom.
- Hierarki teks & konten: Gunakan warna konten utama untuk judul dan nilai kunci, warna sekunder yang redup untuk teks isi dan label pendukung, serta warna status semantik (positif, peringatan, kritis) untuk metadata operasional.
- Batas & pemisah: Gunakan warna garis batas sistem yang halus untuk batas dan pemisah struktural guna memisahkan konten tanpa menambahkan bobot visual yang berat.
- Aksen utama: Gunakan aksen sistem atau warna merek partner Anda untuk tombol pesan ajakan (CTA) utama.
Area penerapan brand partner
Panduan penempatan warna merek partner di seluruh Aplikasi Terhubung:
- Direkomendasikan: Terapkan warna merek secara selektif ke tombol CTA utama, logo, dan momen sorotan utama.
- Tidak direkomendasikan: Hindari menerapkan warna merek ke latar belakang kartu, teks isi, judul, batas struktural, atau kontrol interaktif sekunder.
Tema & mode terang/gelap
Aplikasi Terhubung harus terasa kohesif di seluruh tema Terang dan Gelap serta palet permukaan dinamis:
- Gunakan token semantik daripada nilai hex statis: Ikat permukaan, teks, dan batas ke token warna semantik permukaan host agar antarmuka Anda beradaptasi secara otomatis antara mode Terang dan Gelap.
- Sesuaikan aksen merek untuk kedua tema: Pastikan warna aksen merek Anda mempertahankan kontras yang mudah diakses di kedua tema—berikan varian yang sedikit lebih terang atau tidak tersaturasi dalam mode Gelap jika warna merek default Anda tampak terlalu gelap atau terlalu cerah di permukaan gelap.
- Gunakan media dan logo yang siap tema: Ekspor ikon, logo, dan ilustrasi dengan latar belakang transparan agar tidak menampilkan kotak pembatas putih yang mencolok dalam Mode gelap.
Ikon
Aplikasi Terhubung menggunakan ikonografi yang jelas dan bergaris batas untuk menjaga harmoni visual dan kemudahan pemindaian di seluruh produk Google yang berlaku.
Gaya & ukuran ikon
Panduan geometri, warna, dan batas ukuran ikon di seluruh Aplikasi Terhubung:
- Geometri bulat dengan garis luar: Gunakan ikon monokrom dengan garis luar yang memiliki ketebalan goresan seragam dan ujung bulat (seperti Google Material Symbols Outlined), atau set ikon partner yang harmonis dan sesuai dengan bobot visual antarmuka host.
- Pewarnaan netral: Warnai ikon UI fungsional menggunakan warna konten primer atau sekunder, bukan warna merek, sehingga ikon mendukung hierarki pembacaan tanpa bersaing dengan CTA utama.
- Batas ukuran: Pertahankan ukuran ikon antara 16 px (untuk metadata inline yang ringkas) dan 32 px (untuk header kartu atau fitur yang terlihat jelas) guna menjaga keterbacaan dan proporsi di seluruh area pandang.
Aksesibilitas
Produk Google yang berlaku menerapkan kepatuhan aksesibilitas yang selaras dengan standar WCAG 2.1 AA dan Material Design 3.
Pilar aksesibilitas inti
- Kontras warna: Terapkan rasio kontras WCAG AA minimum 4,5:1 untuk teks terhadap latar belakang permukaan di seluruh Tema Terang dan Gelap.
- Ukuran teks minimum: Menerapkan ukuran teks 13 pt.
- Target sentuh: Terapkan area target interaktif minimum 48x48 piksel untuk perangkat seluler dan 24x24 piksel untuk desktop untuk kontrol.
- Fokus keyboard: Pertahankan cincin indikator fokus yang terlihat dan urutan traversal tab yang logis di seluruh komponen kartu interaktif.
- Teks alternatif media dinamis: Berikan teks alternatif deskriptif untuk semua gambar, thumbnail, pin peta, dan visualisasi data yang disediakan partner.
- Pengumuman status live (
aria-live): Gunakan regionaria-live="polite"untuk mengumumkan perubahan status dalam kartu yang dinamis seperti memperluas baris "Tampilkan lebih banyak", memfilter item, atau menyelesaikan tindakan inline. - Gerakan yang dikurangi (
prefers-reduced-motion): Hormati kueri mediaprefers-reduced-motionpengguna dengan mengganti efek shimmer skeleton dan transisi slide carousel dengan perubahan status statis atau instan. - Konten yang meluap dan terpotong: Batasi blok teks panjang menjadi 3–5 baris dengan tindakan "Baca selengkapnya" yang mudah diakses untuk mencegah tata letak rusak dan mempertahankan keterbacaan.