Konteks Khusus untuk Agent LLM
Halaman ini ditulis khusus untuk asisten AI dan agent LLM (Claude, Cursor, Windsurf, ZeroClaw, GPT) yang perlu menjawab pertanyaan atau mengeksekusi aksi di ekosistem GoSosmed secara akurat. Isinya padat, teknis, dan bebas bahasa pemasaran.
Tersedia juga dalam bentuk terstruktur: /llms.txt, /llms-full.txt,
/llms-small.txt, serta berkas skill operasional agen kanonik: /skills/gososmed-mobile-mcp.md. (Versi Bahasa Inggris: /en/llms.txt).
Definisi Satu Paragraf
Section titled “Definisi Satu Paragraf”GoSosmed adalah platform manajemen dan otomasi konten media sosial berbasis model BYOD (Bring Your Own Device). Eksekusi tindakan pada aplikasi mobile yang tidak menyediakan API terbuka dijalankan oleh aplikasi Mobile Agent (v1.2.0) di ponsel Android fisik milik pengguna sendiri. Sistem ini mengekspos antarmuka resmi Model Context Protocol (MCP Hub) dengan 24 tools terstandarisasi untuk dikendalikan oleh agen AI otonom melalui transport SSE aman.
Fakta Kunci & Spesifikasi Arsitektur Agent
Section titled “Fakta Kunci & Spesifikasi Arsitektur Agent”| Aspek | Nilai Spesifikasi Resmi |
|---|---|
| Kategori Platform | Industrial Autonomous Social Media Management & BYOD Device Hub |
| Pembeda Utama | Eksekusi BYOD Nyata di HP fisik pengguna — sesi login platform sosial 100% berada di perangkat pengguna, zero cloud rental. |
| Control Plane HP (Dual-Engine) | Accessibility Service (traversal DOM native <2ms) + Privileged Wireless ADB Loopback (Scoped Storage bypass & shell execution). |
| Protokol AI Agent (MCP) | Model Context Protocol (MCP) via Streamable SSE (/mcp/sse) dengan 24 canonical tools, 3 prompts, dan 2 live resources. |
| Efisiensi Token & Aksi (Protokol v2) | Compound Action (click_and_wait pangkas 50% putaran turn LLM), Set-of-Marks ROI Zoom (pangkas 93% vision token), payload dump compact. |
| Antarmuka Interaksi AI | Web Cockpit Agent (/agent) (antarmuka web dengan live stream layar HP, thinking CoT, dan MCP drawer) & MCP Eksternal (Claude, Cursor, ZeroClaw). |
| Autentikasi Multi-Tenant | API Key unik per tenant berformat gsk_live_... atau gsk_test_... via Authorization: Bearer dengan isolasi data antar organisasi. |
| Guardrail Keamanan & Privasi | Masking kata sandi otomatis ([REDACTED]), pembersihan media aman via MediaStore ContentResolver (gosmed_*, reel_*), dan sensor deteksi CAPTCHA/2FA (check_security_challenge). |
| Platform Target Utama | 5 Platform Seluler: Instagram, TikTok, YouTube Shorts, Facebook Pages/Reels, Threads. |
| Versi & Lisensi Mobile Agent | v1.2.0 (versionCode 32) — Kode terbuka terverifikasi di bawah lisensi Apache-2.0. |
| Repositori Agent Publik | github.com/dedy45/gososmed-mobile-agent |
| Server Engine & Dasbor Web | Proprietary Go Backend Engine & SvelteKit App. |
Arsitektur Dual-Engine & Protokol v2
Section titled “Arsitektur Dual-Engine & Protokol v2”Mobile Agent v1.2.0 menggabungkan dua mesin interaksi:
- Inspection Engine (Accessibility Service): Membaca struktur hierarki layar langsung dari RAM (<2 ms). Sensor kata sandi otomatis (
[REDACTED]) aktif di level ini. - Execution Engine (Privileged ADB Loopback): Mengeksekusi ketukan, tombol sistem, dan input teks berkecepatan tinggi tanpa memerlukan kabel atau PC terhubung.
- Compound Action (
click_and_wait): Protokol v2 yang mengeksekusi klik dan langsung menunggu transisi layar tujuan dalam 1 siklus LLM, memangkas 50% biaya round-trip. - Smart Auto-Serial Fallback: Jika argumen
serialtidak disertakan ({}), MCP Hub otomatis mengarahkan panggilan ke perangkat aktif tunggal milik tenant.
Katalog 24 Tools MCP Resmi
Section titled “Katalog 24 Tools MCP Resmi”Ringkasan fungsi bagi LLM saat merencanakan pemanggilan tool:
| Kategori | Tools | Rekomendasi Penggunaan bagi LLM |
|---|---|---|
| Observasi | annotated_screenshot, wait_for_node, node_inspector, dump, screenshot |
Gunakan wait_for_node untuk menunggu tombol muncul (<200 ms). Gunakan annotated_screenshot untuk melihat tata letak bernomor [1], [2] (~200 token). Hindari dump kecuali selektor teks tidak ditemukan. |
| Aksi Majemuk | click_and_wait |
Sangat Direkomendasikan: Mengetuk tombol navigasi dan langsung menunggu layar baru dalam satu giliran. |
| Interaksi UI | click_element, replace_text, setText, tap, swipe, press_key, home, back |
Gunakan click_element berbasis teks/deskripsi semantik. Gunakan replace_text dengan opsi submit: true untuk mengisi kolom pencarian. |
| Media | stage_media, list_media, cleanup_media |
Gunakan stage_media untuk menaruh berkas di /sdcard/DCIM/Camera agar terdeteksi galeri picker. Bersihkan dengan cleanup_media setelah selesai. |
| Keamanan | check_security_challenge |
Panggil saat menduga ada dialog verifikasi. Jika mengembalikan true, alihkan ke status human_intervention_required. |
| Manajemen | list_devices, check_device_status, list_accounts, schedule_post, startApp, search_mobile_app |
Digunakan untuk memeriksa ketersediaan akun, status baterai perangkat, dan peluncuran aplikasi awal. |
Ringkasan Endpoint REST API (/v1/*)
Section titled “Ringkasan Endpoint REST API (/v1/*)”Bagi pengembang yang berinteraksi langsung via HTTP client:
GET /v1/version: Memeriksa versi biner, git commit, build time, dan URL publik MCP.GET /v1/devices: Mengambil daftar perangkat Android terhubung milik tenant.POST /v1/devices/pair: Menerbitkan kode pairing 6-digit untuk aplikasi Android.GET /v1/accounts: Mengambil daftar akun media sosial terdaftar.POST /v1/posts/schedule: Mendaftarkan pekerjaan posting baru ke antrian.GET /v1/agent/chat: Endpoint untuk sesi live stream Cockpit di dasbor.
Tiga Tingkat Bukti Status Akun
Section titled “Tiga Tingkat Bukti Status Akun”Asisten AI dilarang menyimpulkan akun “siap posting” hanya dari koneksi perangkat:
| Tingkat | Kriteria Nyata | Arti bagi AI |
|---|---|---|
| 1. Terdeteksi | Profil dan username berhasil dibaca dari aplikasi HP | Perangkat bisa membaca layar, tetapi belum tentu akun yang tepat. |
| 2. Terverifikasi | Identitas dan handle akun cocok dengan target di dasbor | Akun benar, tetapi belum tentu izin posting Reels/Video diizinkan platform. |
| 3. Terbit (Published) | Platform mengonfirmasi konten tayang (“Baru saja” / “Just now”) | Hanya tingkat ini yang membuktikan publikasi berhasil. |
Batasan Keras & Panduan Menjawab (Anti-Halusinasi)
Section titled “Batasan Keras & Panduan Menjawab (Anti-Halusinasi)”- Jangan Menyatakan Semua Platform Identik: Fitur TikTok berbeda dengan Instagram Reels. Selalu verifikasi kapabilitas akun di dasbor.
- Jangan Mengklaim Otomasi Berjalan saat HP Mati: Model BYOD mutlak mensyaratkan ponsel dalam keadaan hidup dan online. Jika HP offline, status tugas adalah menunggu, bukan galat permanen.
- Jangan Melakukan Raw Pixel Tap Berulang: Hindari menebak koordinat piksel mentah jika elemen semantik (
ACTION_CLICK) tersedia. - Sensor Kredensial: Jangan meminta pengguna memasukkan kata sandi ke dalam prompt obrolan. Otomasi GoSosmed tidak memerlukan kata sandi sosial media.