QuickAgent - Panduan

Panduan Pengguna QuickAgent

QuickAgent adalah ruang kerja agen AI yang mengutamakan pemrosesan lokal. Aplikasi ini mengubah sebuah tujuan menjadi Run yang tahan lama, membatasi Run tersebut dengan Workspace Profile, meminta peninjauan sebelum tindakan sensitif, dan menyimpan hasil terverifikasi di Artifacts.

Memulai

Buka Pengaturan > AI, tambahkan penyedia, lalu jalankan uji koneksinya.
Buka Pengaturan > Workspace Profiles. Pilih penyedia, alat, koneksi, akar berkas, sumber Knowledge, dan cakupan Memory mana saja yang boleh dipakai.
Pilih Obrolan Baru, pilih profilnya, lalu konfirmasi tujuan penyedia yang ditampilkan di atas percakapan.
Jelaskan hasil yang Anda inginkan. Tambahkan hanya berkas, folder, media, Knowledge, atau Memory yang dibutuhkan untuk Run ini.
Tinjau rencana, persetujuan, konfirmasi Critical, dan Data Send Preview ketika semuanya muncul.
Pantau pekerjaan di Timeline. Buka keluaran yang sudah selesai dari Artifacts lalu periksa jejak auditnya di Riwayat.

Tips: Mulailah dengan Workspace Profile yang sempit. Perluas alat atau akarnya hanya ketika QuickAgent menampilkan alasan spesifik mengapa sesuatu tidak tersedia.

Sekilas Antarmuka

Bagian	Kegunaannya
Obrolan	Percakapan, tujuan penyedia, Context Tray, rencana, persetujuan, dan Timeline Run yang aktif.
Runs	Setiap tugas yang direncanakan, sedang berjalan, dijeda, dijadwalkan, gagal, atau selesai.
Approval Inbox	Peninjauan tindakan tertunda, Critical, dan Data Send yang membutuhkan keputusan Anda.
Artifacts	Berkas, laporan, log, media, tabel, dan manifes operasi terverifikasi yang dibuat oleh Run.
Otomatisasi	Jadwal, monitor, webhook, peristiwa aplikasi, dan pemicu Shortcut/App Intent.
Skills	Instruksi yang dapat dipakai ulang dengan input bertipe, alat yang diizinkan, koneksi yang dibutuhkan, tingkat risiko, dan keluaran.
Koneksi	Penyedia, profil peramban, akar berkas/VFS, SSH, MCP, HTTP/SaaS, jembatan rumah pintar, dan kanal notifikasi.
Knowledge	Folder terindeks, konten QuickNote, kliping web, PDF, dan sumber Office.
Riwayat	Keputusan keamanan, tindakan alat, tujuan, dan stempel waktu yang bersifat append-only.
Pengaturan	Tampilan, bahasa, AI, alat, keamanan, Workspace Profiles, pintasan, izin, Bantuan, dan Pro.

Penyedia dan Workspace Profiles

QuickAgent dapat menggunakan System AI bila sistem operasi menyediakan kemampuan yang kompatibel, penyedia lokal seperti Ollama, LM Studio, atau DeskLLM, endpoint LAN atau kustom yang kompatibel dengan OpenAI, serta penyedia cloud yang telah dikonfigurasi seperti Anthropic atau Gemini. Ketersediaan ditentukan oleh uji kemampuan langsung; nama penyedia saja tidak berarti penyedia tersebut siap.

Workspace Profile adalah amplop izin untuk sebuah Run. Profil ini merekam penyedia/model yang dipilih, alat yang diizinkan, koneksi, root berkas, sumber Knowledge, cakupan Memory, penggantian keamanan, dan anggaran. Perubahan konfigurasi berikutnya membuat rekaman tersebut usang dan perlu ditinjau ulang.

Aturan tujuan: QuickAgent tidak pernah beralih diam-diam dari penyedia di perangkat atau lokal ke cloud. Tujuan aktif tetap terlihat di Chat dan pada setiap tinjauan Data Send.

Run, Persetujuan, dan Pemulihan

Kontrol Run

Jeda meminta penghentian kooperatif pada titik pemeriksaan yang tahan lama.
Lanjutkan meneruskan Run yang sama beserta pekerjaan yang sudah selesai.
Hentikan membatalkan pekerjaan penyedia dan alat. Efek eksternal yang terhenti atau tidak pasti tidak dilaporkan sebagai berhasil.
Coba lagi hanya tersedia bila QuickAgent dapat menentukan batas percobaan ulang yang aman.

Tingkat keamanan

Tingkat	Arti
Aman	Membaca, memeriksa, atau mengubah dalam profil aktif.
Setujui	Tinjau penulisan normal atau tindakan eksternal.
Pastikan	Tinjau perubahan berdampak lebih besar atau lebih sulit dibatalkan.
Kritis	Konfirmasi kuat setiap kali; aturan tidak pernah menyetujuinya secara otomatis.

Persetujuan menampilkan target persis, tujuan, argumen yang diusulkan, risiko, dan status Undo. Jika Anda mengubah argumen, QuickAgent memvalidasi dan memeriksa risiko tindakan yang telah diubah itu kembali.

Hasil tidak pasti: setelah gangguan, periksa dulu sistem tujuan. Pilih “Sudah saya periksa — coba lagi” hanya bila mengulang tindakan tersebut memang tepat. “Lanjutkan” saja tidak pernah mengulang efek eksternal yang tidak pasti.

Run Multi-Agen

Tujuan yang kompleks dapat menggunakan perencana, pekerja spesialis bertipe, peninjau, dan peninjau keamanan. Timeline menampilkan setiap serah terima, tinjauan, percobaan ulang, fallback, dan batas respons akhir. Pekerja hanya menerima irisan empat arah dari alat Skill, alat Workspace Profile, alat peran, dan alat yang sedang aktif.

Anggaran global dan per peran membatasi pemanggilan, waktu, biaya, byte jaringan, dan token. Saat anggaran tercapai, QuickAgent berhenti sementara. Sistem ini menampilkan batas saat ini dan yang diusulkan, lalu meningkatkannya hanya setelah peninjauan eksplisit. Anggaran yang disetujui dan riwayat peran yang selesai tetap tersimpan setelah dimulai ulang.

Konteks, Knowledge, dan AI Memory

Baki Konteks

Tambahkan berkas, folder, gambar, bingkai video, audio, catatan suara, konten QuickNote, Knowledge, atau Workspace Memory. QuickAgent mengekstrak atau meringkas konten yang didukung dan menunjukkan apakah sebuah lampiran akan dikirim langsung ke penyedia.

Knowledge

Sumber Knowledge diindeks terpisah dari chat. Sebuah Run hanya dapat menelusuri sumber yang diizinkan oleh Workspace Profile-nya, dan kutipan tetap mempertahankan identitas sumbernya.

Memory

Memory bersifat disengaja, bukan riwayat chat otomatis. Cakupan User, Workspace, Project, dan Tool/Connection terpisah satu sama lain. Setiap permintaan pembuatan, penyuntingan, atau penghapusan memperoleh persetujuan baru, dan pratinjau persetujuan menampilkan cakupan serta nilai persis yang diusulkan.

Alat dan Koneksi

Katalog langsung mencakup operasi berkas/VFS; Office, PDF, dan data terstruktur; media dan OCR; peramban dan kendali komputer; perintah pengembangan; SSH; MCP; HTTP dan SaaS; jembatan smart home; notifikasi; jadwal; pemantau; serta kendali otomasi. Server MCP yang terhubung dapat menambahkan alat dinamis setelah validasi skema dan penilaian ulang risiko oleh QuickAgent.

Settings > Tools menunjukkan alasan sebuah alat siap atau dinonaktifkan. Alasan yang umum adalah koneksi yang belum ada, izin sistem operasi, platform yang tidak didukung, pembatasan Workspace Profile, endpoint yang belum diuji, atau kemampuan penyedia yang tidak tersedia.

Kendali komputer: perekaman layar dan kendali aksesibilitas/masukan adalah izin yang terpisah. Jaga agar pratinjau yang terlihat dan tombol Stop darurat tetap tersedia. Platform seluler tidak menyediakan kendali desktop tanpa batas yang sama.

Otomatisasi

Automation dapat dimulai dari pemicu waktu, berkas/folder, web, webhook, email, kalender, jaringan, host, perangkat, sensor, lokasi, peristiwa aplikasi, Shortcut/App Intent, perintah, atau manual bila platform mendukungnya. Sebuah pemicu membuat Run biasa; pemicu tidak melewati pemeriksaan Workspace Profile, persetujuan, Kritis, atau Data Send.

Pemantauan di desktop hanya berlanjut selama proses aplikasi berjalan.
Platform seluler menyusul pekerjaan yang tertunda ketika aplikasi kembali ke latar depan.
Gunakan Shortcut/App Intent atau relai peristiwa tepercaya bila pengiriman dari sistem operasi memang diperlukan.
Peristiwa dalam antrean, jeda, pembatalan, dan penghapusan tetap eksplisit sehingga peristiwa tidak dibuang diam-diam.

Skill dan Skill Pack

Sebuah Skill menyimpan prompt yang berorientasi hasil, variabel bertipe, rekomendasi penyedia, alat yang diizinkan, koneksi dan kemampuan yang dibutuhkan, risiko maksimum, serta Artifact yang diharapkan. Sebelum digunakan, QuickAgent menampilkan masukan dan izin efektifnya; pratinjau itu sendiri tidak memberikan izin.

Tujuh Pack bawaan menyediakan Skill nyata untuk Office, Coding, Smart Home, Research, Browser Automation, Personal Admin, dan Incident Response. Anda dapat memasang, memperbarui, mencopot, menyesuaikan, menggandakan, mengimpor, dan mengekspor Skill. JSON yang diimpor mendapat pratinjau kepercayaan, penerbit, tanda tangan, izin, risiko, platform, dan konflik. “Simpan keduanya” membuat turunan lokal tanpa tanda tangan, bukan mewarisi kepercayaan penerbit lain.

Artifact, Riwayat, dan Undo

Artifact menyimpan byte keluaran, metadata, versi, asal-usul, Run sumber, dan manifes operasi. Bergantung pada kemampuan platform, Anda dapat membuka, membagikan, mengekspor, atau menampilkannya di sistem berkas. Operasi yang memenuhi syarat menyediakan Undo yang ditinjau; pekerjaan destruktif atau tidak pasti tidak pernah diulang secara otomatis.

Riwayat bersifat append-only. Saring berdasarkan Aman, Setujui, Konfirmasi, atau Kritis, dan ekspor audit ketika Anda memerlukan catatan eksternal.

Pengaturan

Umum: tampilan, bahasa, Workspace Profile, pintasan, Bantuan, dan izin.
AI: penyedia, endpoint, model, kredensial, dan uji langsung.
Alat: kesiapan katalog, dukungan platform, dan alasan penyiapan.
Keamanan: aturan persetujuan, perilaku Data Send, autentikasi perangkat, dan kebijakan Memory bercakupan.
Lanjutan: pemulihan dan diagnostik untuk penelusuran masalah.

Pintasan Papan Ketik

Di macOS, aplikasi memetakan pintasan Ctrl yang ditampilkan ke tombol Command platform bila sesuai. Halaman Shortcuts di dalam aplikasi adalah acuan resmi dan mendukung penyesuaian.

Pintasan	Aksi
`Ctrl` + `N`	Obrolan Baru
`Ctrl` + `L`	Fokuskan kolom penulisan
`Ctrl` + `Shift` + `Space`	Jeda atau lanjutkan Run yang aktif
`Ctrl` + `.`	Hentikan Run yang aktif
`Ctrl` + `1` … `9`	Buka Chat melalui Riwayat
`Ctrl` + `,`	Buka Pengaturan
`F1`	Buka Help & Privacy
`Esc`	Tutup dialog atau batalkan interaksi non-destruktif yang sedang berjalan

Catatan Platform

Platform	Batasan penting
macOS	Berjalan dalam sandbox pada Debug dan Release. Akses berkas menggunakan root terpilih/security-scoped bookmark. Screen Recording dan Accessibility adalah izin sistem yang terpisah. Integrasi proses lokal dan Shortcut tetap diuji kemampuannya.
Windows	Fitur berkas, Office/PDF/data, peramban, pengembangan, remote, dan kendali desktop bergantung pada runtime dan izin yang terpasang. Integrasi khusus Apple tidak tersedia dengan alasan yang ditampilkan.
iPhone / iPad	Berkas menggunakan pemilih sistem. Kamera, mikrofon, pengenalan ucapan, foto, jaringan lokal, dan notifikasi diminta sesuai konteks. Pemantauan di latar belakang tidak dijamin; gunakan Shortcuts/App Intents atau penyusulan di latar depan.
Android	Berkas dan folder menggunakan Storage Access Framework. Pekerjaan latar belakang mengikuti pembatasan Android. Kendali masukan berbasis aksesibilitas tidak pernah dianggap sudah diberikan hanya karena layanannya dideklarasikan.
Web	Menggunakan penyimpanan khusus sesi untuk fitur yang membutuhkan persistensi native dan dengan jelas menonaktifkan kemampuan perangkat, root berkas, proses lokal, serta latar belakang yang tidak didukung.

Tips & Trik

Mulailah dengan Workspace Profile yang sempit dan tambahkan alat, koneksi, atau root berkas hanya ketika Run menunjukkan kebutuhan yang spesifik.

Berikan setiap permintaan hasil yang jelas, Artifact yang diharapkan, dan batas tinjauan agar kemajuannya mudah diaudit.

Gunakan Knowledge untuk sumber terindeks yang dipakai berulang, dan Konteks untuk materi yang hanya dibutuhkan Run saat ini.

Ketika efek eksternal tidak pasti, periksa tujuannya sebelum mencoba lagi; Lanjutkan tidak pernah mengulanginya secara otomatis.

Pemecahan Masalah

Masalah	Yang perlu diperiksa
Penyedia tidak dapat berjalan	Buka Settings > AI. Periksa konfigurasi, autentikasi, kemampuan model, keterjangkauan endpoint, batas waktu, dan detail batas laju, lalu jalankan uji koneksi.
Sebuah alat dinonaktifkan	Buka Settings > Tools dan baca alasan langsungnya. Tinjau platform saat ini, izin, uji koneksi, Workspace Profile, dan root yang dipilih.
Sebuah Run tampak macet	Buka Runs dan Timeline. Run mungkin dijeda, menunggu masukan, persetujuan, konfirmasi Kritis, tinjauan Data Send, atau tinjauan anggaran. Tombol Stop tetap tersedia.
Ada izin yang berubah	Buka Help > Overview atau Settings, lalu buka pengaturan sistem. Uji ulang koneksi atau alat yang terpengaruh setelah kembali.
Sebuah tindakan eksternal tidak pasti	Periksa sistem tujuan. Biarkan Run tetap dijeda atau hentikan, kecuali Anda telah memastikan bahwa mencoba lagi memang tepat.
Sebuah Automation tidak berjalan di latar belakang	Sistem operasi seluler tidak menjamin polling sembarang. Kembalilah ke latar depan untuk penyusulan, atau konfigurasikan Shortcut/App Intent maupun sumber peristiwa tepercaya.
Sebuah Artifact tidak dapat dibuka atau diekspor	Periksa apakah byte-nya masih tersedia, apakah platform mendukung tindakan tersebut, dan apakah izin tujuan yang dipilih masih berlaku.

Privasi, Izin, dan Lisensi

QuickAgent menyimpan percakapan, Run, persetujuan, metadata Knowledge, Skill, dan pengaturan secara lokal. Kredensial menggunakan penyimpanan yang dilindungi platform. Konten meninggalkan perangkat hanya melalui penyedia atau layanan terhubung yang Anda konfigurasikan, dan pengiriman keluar memperoleh pratinjau yang menyebutkan tujuannya.

Izin diminta sesuai konteks: berkas/folder, foto, kamera, mikrofon, pengenalan ucapan, jaringan lokal, notifikasi, perekaman layar, dan kendali aksesibilitas/masukan bersifat independen. Mencabut sebuah izin membuat kemampuan terkait menjadi tidak tersedia, bukan menghasilkan laporan berhasil yang palsu.

Buka Settings > Help & Privacy untuk tabel kemampuan platform saat ini dan Lisensi sumber terbuka untuk pemberitahuan paket dan komponen native yang disertakan.

Free dan Pro: semua fitur agen tetap tersedia di Free. Uji coba tujuh hari bebas iklan; setelahnya, versi seluler dapat menampilkan iklan dan versi desktop dapat menampilkan pengingat harian. Pro menghilangkan pesan tersebut melalui langganan tahunan atau pembelian seumur hidup.