agentic

Cara Publikasikan Website dengan Cursor: Agen Cloud atau Host Anda Sendiri9 min read

Reading Time: 7 minutesPublikasikan situs web yang dibuat di Cursor: uji proyek, gunakan Cloud Agent Publish dengan Vercel jika memenuhi syarat, atau terapkan repositori Anda melalui host lain.

Cursor publishing a website cover

Cara Publikasikan Website dengan Cursor: Agen Cloud atau Host Anda Sendiri9 min read

Reading Time: 7 minutes

Untuk menerbitkan situs web dengan Cursor, jalankan proyek terlebih dahulu, lalu pilih jalur penerapan. Agen Cloud Cursor memiliki aliran Publikasi yang terdokumentasi untuk repositori yang terhubung ke Vercel. Jika Anda membuat editor desktop atau menggunakan host lain, terapkan repositori yang telah ditinjau dengan pipeline normal host tersebut. Pratinjau dan port penerusan Cursor memungkinkan Anda memeriksa aplikasi, namun alamat publik yang Anda berikan kepada pelanggan juga tidak.

Panduan ini ditujukan untuk pembuat yang menginginkan peluncuran yang berfungsi, bukan tangkapan layar laman landas yang dihasilkan. Ini mencakup pilihan repositori, perintah, pratinjau lokal dan cloud, pemeriksaan build, publikasi, dan jalur artefak bersama opsional untuk pemangku kepentingan. Jika beberapa orang perlu meninjau draf yang sama sebelum diluncurkan, pertimbangkan a ruang kerja AgentGrid.io bersama daripada bertukar tangkapan layar.

Cara membuat situs web di Cursor dan mempublikasikannya dengan AgentGrid.io

Siapkan AgentGrid.io sebelum menulis kode di Cursor sehingga aplikasi berada di ruang kerja yang tepat.

Langkah 1: Buat ruang kerja situs di AgentGrid.io

Masuk di app.agentgrid.io, pilih tim yang benar, dan pilih ruang kerja untuk situs web. Gunakan ruang kerja terpisah untuk audiens yang lebih sempit. Pilih artefak aplikasi untuk situs web, bukan ringkasan penurunan harga. Berbagi tautan artefak pribadi tidak mengubahnya menjadi situs publik.

Ruang kerja AgentGrid.io dengan Undang agen disorot
Di ruang kerja AgentGrid.io, Undang agen memulai koneksi yang didukung.

Langkah 2: Hubungkan Agen Cursor, bukan hanya editor

Buka proyek situs di Cursor dan gunakan mode Agen, yang dapat mengedit file dan menjalankan perintah terminal. Berikan instruksi ini: Connect this Cursor Agent to agentgrid.io. Run npx @animaapp/cli@latest login, show me the verification URL and code, and wait for my approval. Do not publish yet. Setujui namanya, ruang kerja, dan Baca dan Tulis di browser Anda. Biarkan Publikasi tidak aktif kecuali Anda ingin agen menyebarkan. Kemudian minta Cursor untuk dijalankan npx @animaapp/cli@latest workspaces dan verifikasi bahwa ia dapat melihat ruang kerja yang dimaksud. Jika akses terminal dinonaktifkan, gunakan impor folder manual.

Langkah 3: Bangun, uji, dan impor proyek satu kali

Perintah Cursor: Buat halaman arahan pemesanan yang responsif untuk bengkel sepeda. Gunakan repositori ini, tambahkan daftar layanan yang jelas dan pesan ajakan bertindak, jalankan pemeriksaan yang tersedia, dan beri tahu saya file mana yang merupakan titik masuk situs. Jangan mengubah kode yang tidak terkait. Tinjau perbedaannya dan buka pratinjau lokal. Jalankan agen yang terhubung npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, mengganti folder sebenarnya dan ID ruang kerja yang terdaftar. Buka URL artefak yang dikembalikan. Untuk situs statis, pastikan index.html dan aset yang direferensikannya ada. Kecualikan node_modules, keluaran build, dan kredensial. Jika koneksi tidak memungkinkan, pilih Baru → Unggah Folder atau Baru → Impor dari ZIP di AgentGrid.io. Impor adalah snapshot, bukan sinkronisasi otomatis dengan repositori. Verifikasi file, pratinjau, dan ruang kerjanya.

Artefak situs demo White Lotus di AgentGrid.io
Contoh artefak situs web di AgentGrid.io: demo White Lotus bersifat pribadi sementara versinya ditinjau.

Langkah 4: Perbarui artefak yang sama, lalu publikasikan dengan sengaja

Tempelkan URL artefak ke Agen Cursor dan minta perbaikan yang tepat, seperti memperbaiki menu seluler pada artefak tersebut. Konfirmasikan perubahan dalam Riwayat. Ketika situs disetujui, gunakan Publikasikan di AgentGrid.io atau mintalah agen yang terhubung dengan kemampuan Publikasikan untuk menyebarkannya. Buka URL publik yang dihasilkan dan uji tautan navigasi dan pemesanan. Penerbitan terpisah dari pembagian artefak pribadi. Perubahan kode selanjutnya tidak secara otomatis menggantikan penerapan publik: publikasikan pembaruan saat Anda menginginkannya diterapkan.

Menu Bagikan AgentGrid.io yang diperbarui menampilkan opsi Publikasikan
Menu Bagikan yang diperbarui mencakup Publikasikan, yang mengubah artefak yang disetujui menjadi situs web aktif.

Apa yang Cursor dapat publikasikan secara langsung

Cursor Dokumentasi Pengaturan Lingkungan Cloud menjelaskan urutan tertentu: simpan pekerjaan ke repositori, sambungkan akun Vercel, pilih Publikasikan di Jendela Agen, dan terima URL penerapan. Cursor menghubungkan repo ke proyek Vercel dan menyebarkan cabang defaultnya. Komitmen cabang default kemudian diterapkan secara otomatis. Tim Cursor yang dikerahkan ke tim Vercel memerlukan rencana di atas Hobby. Persyaratan ini bukanlah tombol publikasi universal untuk setiap proyek editor lokal.

Langkah 1: Mulai di repositori yang tepat

Untuk situs yang sudah ada, buka repositori di Cursor dan minta Agen untuk mengikuti kerangka kerja, komponen, pengujian, dan konvensi desain yang ada. Mintalah ia mengidentifikasi apa yang sudah diterapkan dan cabang mana yang diproduksi sebelum mengubah kode. Untuk proyek Agen Cloud baru, Cursor mendokumentasikan rute awal dari awal dan langkah pembuatan repositori Asal; periksa ketersediaan di akun Anda sebelum mengandalkannya. Lingkungan draf tanpa repo tersimpan belum siap untuk jalur Vercel Publish yang didokumentasikan.

Contoh perintah: “Dalam repositori ini, buat situs Beranda, Lokakarya, dan Kunjungan yang responsif untuk toko pabrik Cedar House. Gunakan logo dan jadwal lokakarya yang disediakan, bukan ketersediaan yang dibuat-buat. Pertahankan kerangka kerja dan konvensi gaya yang ada. Tambahkan judul dan deskripsi halaman, tautan pendaftaran yang berfungsi dari project-notes.md, dan menu seluler yang ramah keyboard. Tampilkan rencana, terapkan, daftarkan file dan pengujian yang diubah, dan hentikan sebelum penerapan.”

Jika proyek memiliki rute API, autentikasi, atau halaman yang dirender oleh server, identifikasilah sekarang. Host yang hanya bersifat statis mungkin tidak mendukung runtime. Tanyakan variabel lingkungan mana yang diharapkan oleh aplikasi dan apakah ada yang akan diekspos ke browser. Jangan pernah menempelkan rahasia produksi ke dalam perintah agen atau memasukkannya ke kontrol sumber.

Langkah 2: Pratinjau aplikasi yang sedang berjalan

Instal dependensi dan jalankan perintah pengembangan yang ditentukan oleh proyek. Untuk sesi editor Cursor lokal, buka URL pengembangan lokal di browser. Untuk Agen Cloud, dokumen Cursor mendeteksi dan mengonfigurasi port yang diteruskan secara manual di Jendela Agen. Buka aplikasi yang diteruskan di browser internal dan periksa halaman sebenarnya. Log build yang bertuliskan “selesai” tidak dapat memvalidasi navigasi responsif atau ajakan bertindak yang berfungsi.

Periksa situs dengan lebar sempit dan lebar. Ikuti tautan ke tujuan yang dituju dan formulir tes. Coba navigasi keyboard dan fokus terlihat. Periksa alternatif gambar, metadata, urutan judul, aset yang hilang, dan status pemuatan. Validasi jam buka toko, detail kontak, salinan resmi, dan hak gambar terhadap sumber yang disetujui. Jika situs bergantung pada API, periksa permintaan yang gagal dan konfirmasikan tidak ada kredensial yang muncul di paket browser.

Tes cepat: “Jalankan skrip lint, pengujian, dan pembuatan produksi repositori ini. Buka tiga halaman di browser dengan lebar seluler dan desktop. Laporkan aset yang rusak, tautan mati, dan kontrol yang tidak dapat diakses, lalu perbaiki kerusakan kode. Jangan mengubah konfigurasi penerapan atau mempublikasikannya. Ringkaslah kegagalan yang memerlukan keputusan manusia.” Buka sendiri browsernya setelah agen melaporkan keberhasilan.

Langkah 3: Pilih jalur peluncuran

Jalan Waktu terbaik Apa yang menjadi publik
Agen Cloud Publikasikan ke Vercel Repositori dan koneksi Vercel sudah siap URL penerapan Vercel dan domain yang dikonfigurasi
Alur kerja penerapan host Anda Anda sudah menggunakan pipeline CI/CD atau platform lain URL penerapan host
Artefak AgentGrid.io Sebuah tim memerlukan versi kerja yang dapat ditinjau terlebih dahulu Tidak ada apa-apa sampai artefak tersebut diterbitkan secara terpisah

Dua jalur pertama adalah rute penerapan. Yang ketiga adalah alur kerja kolaborasi dan penerbitan dengan salinan aplikasinya sendiri. Pilih satu sumber kebenaran dan catat versi mana yang dilihat oleh pengulas.

Langkah 4: Publikasikan dengan Agen Cloud Cursor dan Vercel

Setelah karya berada di repositori, sambungkan akun Vercel di Cursor. Di Jendela Agen, pilih Publikasikan di atas input agen. Jika Cursor menawarkan Tambahkan Vercel, selesaikan koneksi tersebut terlebih dahulu. Tinjau repositori, tim Vercel tujuan, cabang default, variabel lingkungan, dan pengaturan build sebelum menyetujui. Alur Cursor yang terdokumentasi kemudian menautkan repo, menyebarkan cabang default, dan mengembalikan URL.

Jangan gunakan cabang pratinjau sebagai bukti apa yang akan masuk ke cabang default. Periksa perbedaan dan tinjauan kode manusia yang diperlukan sebelum menggabungkan. Komit selanjutnya ke cabang tersebut dapat memindahkan situs aktif secara otomatis, jadi tentukan prosedur persetujuan dan rollback sekarang. Jika situs yang dihasilkan bersifat statis, konfirmasikan direktori keluaran; jika rute server terlibat, konfirmasikan bahwa host mendukung runtime aplikasi. Perlakukan domain DNS dan penagihan sebagai keputusan kepemilikan terpisah.

Langkah 5: Terapkan melalui host lain, atau bagikan untuk ditinjau

Dengan host lain, komit kode yang telah ditinjau dan ikuti alur kerja repositori atau unggahan khusus kerangka kerja penyedia tersebut. Konfigurasikan perintah build, lokasi keluaran, variabel lingkungan, pengalihan, dan domain khusus pada host tersebut. Gunakan penerapan pratinjaunya untuk mendapatkan persetujuan pemangku kepentingan jika tersedia. Cursor membantu dengan kode dan perintah; tuan rumah memiliki URL publik dan pengaturan produksi.

Untuk tinjauan tim, AgentGrid.io mendokumentasikan a Koneksi Cursor. Konfirmasikan bahwa lingkungan agen dapat menjalankan alur koneksi, hanya memberikan akses ke ruang kerja yang dimaksud, dan memintanya untuk mengembalikan tautan artefak. Jika koneksi tidak sesuai, impor sendiri folder proyek atau ZIP yang ditinjau. Periksa pratinjau artefak dan sumber setelah transfer; tautan pribadi bukan situs web produksi, dan pengeditan di repo asli tidak secara otomatis disinkronkan ke salinan yang diimpor.

Perintah serah terima tercakup: “Setelah saya mengotorisasi koneksi, letakkan proyek Cedar House yang telah ditinjau di ruang kerja bernama sebagai artefak aplikasi yang tidak dipublikasikan. Kembalikan URL pribadinya dan cantumkan semua dependensi atau fitur backend yang gagal ditransfer. Jangan publikasikan, bagikan secara eksternal, atau pilih ruang kerja lain.” Saat tim keluar, gunakan artefak itu aliran Publikasi terpisah jika AgentGrid.io adalah host yang dipilih.

Langkah 6: Verifikasi penerapan sebenarnya

Buka URL publik saat keluar dan dari ponsel. Bandingkan halamannya dengan pratinjau yang disetujui. Uji navigasi, formulir, tujuan pendaftaran, HTTPS, metadata, pemuatan gambar, dan domain khusus apa pun. Catat penerapan penerapan atau revisi artefak. Jika halaman publik lebih lama, periksa pilihan cabang, keluaran build, variabel lingkungan, log penerapan, dan cache sebelum mengumumkannya. Jalankan kembali pengujian setelah setiap pembaruan produksi.

Lakukan pembaruan berikutnya dengan sengaja

Catat versi yang disetujui dan URL publik. Hasil edit baru berupa draf sampai ditinjau dan diterbitkan kembali.

Pertanyaan yang sering diajukan

Bisakah Cursor menerbitkan situs web tanpa Vercel?

Ya, dengan membuat kode untuk alur kerja penyedia hosting lain. Kontrol Cloud Agent Publish yang terdokumentasi dan dibahas di sini menggunakan Vercel. Pratinjau editor desktop dan port yang diteruskan bukanlah layanan hosting independen.

Mengapa Publikasi tidak tersedia di sesi Agen Cloud saya?

Periksa apakah proyek disimpan ke repositori dan Vercel terhubung. Kelayakan, rencana, pengaturan organisasi, dan izin repositori juga penting. Ikuti panduan pengaturan Cursor saat ini daripada berasumsi bahwa kontrol yang sama muncul di setiap akun.

Akankah pratinjau Cursor memperbarui situs web langsung saya?

Tidak. Pratinjau lokal atau yang diteruskan memperlihatkan proses pengembangan untuk diperiksa. Penerapan adalah peristiwa terpisah. Di jalur Vercel Cursor, komitmen masa depan ke cabang default dapat memperbarui produksi setelah integrasi disiapkan.

Bisakah saya menggunakan AgentGrid.io hanya untuk persetujuan?

Ya. Simpan artefak yang belum dipublikasikan untuk tinjauan bersama, lalu publikasikan artefak yang disetujui tersebut atau sebarkan repositori terkait yang telah ditinjau melalui host Anda yang sudah ada. Jaga agar kedua salinan tetap sejajar jika Anda menggunakan keduanya.

Untuk perbandingan handoff, lihat panduan kami membagikan keluaran agen sebagai tautan. Itu menerbitkan situs web Desain Claude mencakup titik awal lain, sedangkan Panduan penerbitan situs web Muse menunjukkan artefak yang ditinjau dipindahkan ke publikasi. Ini adalah alur kerja yang berbeda, bukan fitur produk yang dapat dipertukarkan.

|

Co-founder & CEO