[Go to site: main page, start]

Skip to main content

Command Palette

Search for a command to run...

Agen Cloud

Agen Cloud

Agen cloud menggunakan dasar-dasar agent yang sama, tetapi beroperasi di VM terisolasi di cloud dengan lingkungan pengembangan lengkap, alih-alih di mesin lokal Anda. Lingkungan pengembangannya mirip dengan konfigurasi di laptop Anda: repo yang dikloning, dependensi yang terinstal, secret, perintah startup, dan akses jaringan.

Lingkungan pengembangan yang efektif memberi agent konteks penuh tentang codebase dan organisasi Anda, sehingga mereka dapat menguji dan memverifikasi pekerjaan mereka.

Mengapa menggunakan agen cloud?

Anda dapat menjalankan sebanyak mungkin agent secara paralel, dan agent tersebut tidak mengharuskan komputer lokal Anda terhubung ke internet.

Karena memiliki akses ke mesin virtual mereka sendiri, agen cloud dapat membangun, menguji, dan berinteraksi dengan perangkat lunak yang telah diubah. Mereka juga dapat menggunakan komputer untuk mengontrol desktop dan browser. agen cloud mendukung server MCP, yang memberi mereka akses ke alat eksternal dan sumber data seperti database, API, dan layanan pihak ketiga.

agen cloud juga dapat berjalan di lingkungan multi-repo. Gunakan agen cloud saat sebuah tugas mencakup repo frontend, backend, infrastruktur, atau pustaka bersama yang terpisah. agent tersebut dapat memeriksa seluruh workspace, membuat perubahan yang terkoordinasi, dan membuka pull request di repo yang diubahnya.

Cara mengakses

Anda dapat memulai agen cloud dari mana pun Anda bekerja:

  1. Cursor untuk iOS: Mulai dan kelola agent dari aplikasi iOS Cursor
  2. Cursor Web: Mulai dan kelola agent dari cursor.com/agents di perangkat apa pun
  3. Cursor Desktop: Pilih Cloud di menu tarik-turun di bawah input agent
  4. Slack: Gunakan perintah @cursor untuk memulai agent
  5. GitHub atau Bitbucket: Tambahkan komentar @cursor pada PR atau issue GitHub, atau pada PR Bitbucket, untuk memulai agent
  6. Linear: Gunakan perintah @cursor untuk memulai agent
  7. API: Gunakan API untuk memulai agent

Gunakan Cursor di Slack

Pelajari lebih lanjut tentang cara menyiapkan dan menggunakan integrasi Slack, termasuk memicu agent dan menerima notifikasi.

Cara kerja

Koneksi penyedia repositori

Agen cloud meng-clone repo Anda dari GitHub, GitLab, Azure DevOps Services, atau Bitbucket Cloud, bekerja di branch terpisah, lalu melakukan push perubahan ke repo Anda untuk serah terima.

Anda memerlukan izin baca-tulis ke repo Anda serta repo atau submodul dependen apa pun.

Lingkungan

Agent hanya akan semumpuni lingkungan tempatnya berjalan. Agent yang bisa menulis kode tetapi tidak bisa menjalankan pengujian, melakukan kueri ke layanan, atau mengakses API tidak dapat menyelesaikan pekerjaannya sampai tuntas.

Tidak menyiapkan lingkungan pengembangan untuk agent cloud Anda ibarat tidak memberi komputer kepada developer Anda. Inilah sebabnya konfigurasi lingkungan adalah langkah terpenting untuk meningkatkan efektivitas agent cloud. Dengan begitu, agent cloud dapat bekerja seperti developer: menulis kode, menguji dan memverifikasi pekerjaan, lalu merilis perangkat lunak.

Anda dapat mengatur lingkungan dengan konfigurasi yang dipandu agent, snapshot tersimpan, atau Dockerfile di .cursor/environment.json. Lihat konfigurasi agent cloud untuk memulai. Build menyiapkan setiap lingkungan di latar belakang sehingga agent memulai dengan repositori dan dependensi yang sudah siap.

Dashboard agen cloud menampilkan lingkungan dan Build yang digunakan agent, beserta detail lingkungan dan riwayat versi. Di halaman agent, arahkan kursor ke nama repositori di bagian atas halaman untuk memeriksa lingkungan yang digunakan untuk run tersebut. Lihat konfigurasi agent cloud untuk detail konfigurasi.

Kontrol runtime dan lingkungan

Cursor mengelola penyediaan VM, isolasi, snapshot, startup, artefak, dan kapasitas untuk setiap Cloud Agent. Anda dapat menambahkan secret, membatasi domain outbound, terhubung ke jaringan private dengan Tailscale atau klien serupa, dan menggunakan konektivitas private untuk path source control yang didukung.

Lihat Keamanan dan jaringan Cloud Agent untuk rangkaian lengkap kontrol lingkungan dan jaringan. Jika Anda sedang mempertimbangkan apakah akan menggunakan self-hosted, lihat mengapa sebagian besar tim memulai dengan Cursor Cloud.

Model

Agen cloud menggunakan pilihan model terkurasi. Anda dapat memilih ukuran jendela konteks untuk model yang didukung.

Dukungan MCP

Agen cloud dapat menggunakan server MCP (Model Context Protocol) yang dikonfigurasi untuk tim Anda. Tambahkan dan kelola server MCP melalui dropdown MCP di cursor.com/agents.

Baik transport HTTP maupun stdio didukung. OAuth didukung untuk server MCP yang memerlukannya. Lihat kemampuan Cloud Agent untuk detail penyiapan.

Agen cloud juga mencakup Cursor Cloud MCP bawaan untuk diagnostik saat dijalankan, termasuk transkrip, peristiwa pelaksanaan, detail lingkungan, dan log penyiapan.

Dukungan hooks

Agen cloud menjalankan hooks berbasis perintah dari .cursor/hooks.json di repositori Anda. Pada paket Enterprise, agen cloud juga menjalankan team hooks dan hooks yang dikelola perusahaan.

Ini memastikan formatter, skrip audit, dan pemeriksaan kebijakan tetap aktif saat proses berjalan di cloud. Hooks yang didukung mencakup tool dan file hooks (preToolUse, beforeShellExecution, afterFileEdit), serta hooks siklus hidup aplikasi (beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought, dan stop).

Hooks tidak berjalan selama giliran eksplorasi awal di lingkungan baca saja; hooks mulai berjalan setelah agent memiliki lingkungan yang dapat ditulisi. Beberapa hooks bersifat khusus untuk IDE (Tab hooks, workspaceOpen). Hooks tingkat pengguna dari ~/.cursor/hooks.json juga tidak tersedia karena VM cloud tidak memiliki akses ke direktori home lokal Anda.

Lihat Hooks: Dukungan agen cloud untuk matriks dukungan lengkap dan detailnya.

Artefak dan kontrol desktop jarak jauh

agent cloud menghasilkan PR yang siap digabungkan beserta artefak untuk mendemonstrasikan perubahan yang dibuatnya. Anda juga dapat mengontrol desktop jarak jauh agent untuk menggunakan perangkat lunak yang telah dimodifikasi.

  • Artefak: agent menghasilkan tangkapan layar, video, dan log agar Anda dapat melihat dengan tepat apa yang berubah dan bagaimana agent memverifikasi pekerjaannya.
  • Kontrol desktop jarak jauh: Ambil alih desktop agent untuk menguji perangkat lunak sendiri di lingkungan development lengkap tanpa perlu checkout branch secara lokal. Serahkan kembali kontrol ke agent agar agent dapat terus bekerja.

Lihat kemampuan Cloud agent untuk detail tentang artefak, penggunaan komputer, dan kontrol desktop jarak jauh.

Bagikan agent dengan tim Anda

Kirim URL agent kepada anggota tim, dan mereka dapat membuka menjalankan untuk melihat percakapan, perubahan kode, serta artefak yang dihasilkan agent.

Agent dapat dilihat oleh anggota tim Cursor tempat agent tersebut dijalankan. Cursor juga memverifikasi akses repositori setiap penampil: untuk membuka agent milik anggota tim lain, hubungkan akun source control Anda sendiri di Integrations dan pastikan Anda memiliki akses ke repositori tempat agent itu bekerja. Keanggotaan tim saja tidak memberi akses.

Akses ini bersifat baca saja. Agar anggota tim dapat mengirim pesan tindak lanjut dan melanjutkan pekerjaan, admin tim dapat mengaktifkan team follow-ups.

Halaman terkait

Penagihan

Agen cloud dikenakan biaya sesuai penetapan harga API untuk model yang dipilih. Anda dapat memilih ukuran jendela konteks, dan jendela konteks yang lebih besar dapat meningkatkan penggunaan token dan biaya. Anda akan diminta untuk mengatur batas pengeluaran saat pertama kali mulai menggunakannya.

Pemecahan masalah

  • Pastikan Anda sudah login dan telah menghubungkan akun GitHub, GitLab, Azure DevOps, atau Bitbucket Anda.
  • Periksa bahwa Anda memiliki izin repositori yang diperlukan.
  • Anda harus menggunakan paket Cursor berbayar.

  • Pastikan Anda telah menambahkan secret di cursor.com/dashboard/cloud-agents
  • Secret berlaku per workspace/tim; pastikan Anda menggunakan akun yang benar
  • Coba mulai ulang agen cloud setelah menambahkan secret baru

  • Jika Anda tidak melihatnya, pastikan Anda memiliki izin yang diperlukan

Snapshot menyimpan konfigurasi lingkungan dasar Anda (paket yang diinstal, dependensi sistem, dll.). Jika Anda mencakup file .env.local saat snapshot dibuat, file tersebut akan disimpan. Namun, menggunakan tab secret di Cursor Settings adalah cara yang disarankan untuk mengelola variabel lingkungan.

  • Rekan satu tim tersebut harus tergabung dalam tim Cursor yang sama dengan Anda.
  • Mereka perlu menghubungkan akun source control mereka sendiri di Integrations dan memiliki akses ke repositori tempat agent tersebut bekerja.
  • Lihat Berbagi agent dengan tim Anda untuk detail selengkapnya.

Verifikasi bahwa admin workspace Anda telah menginstal aplikasi Cursor Slack dan bahwa Anda memiliki izin yang sesuai.

Riwayat Penamaan

Agen cloud sebelumnya disebut Background Agents.