Jalankan agen secara paralel

Panduan ini menunjukkan cara menjalankan beberapa agen pada saat yang sama tanpa mereka saling menimpa.

Unit isolasinya adalah space, bukan agen

Saat pekerjaan dimulai di sebuah space, Control Center menyediakan satu checkout copy-on-write per repo terdaftar di bawah root milik space itu, pada branch yang diturunkan dari templat branch ruang kerja. Setiap agen di space tersebut kemudian mendapat direktori kerja overlay-nya sendiri — tetapi overlay itu berbagi direktori repos/ milik space tersebut.

Jadi:

Dua agen di space yang berbeda bekerja di checkout yang berbeda, pada branch yang berbeda. Itulah isolasi yang sesungguhnya.
Dua agen di space yang sama bekerja di checkout yang sama, pada branch yang sama. Path overlay mereka berbeda, sehingga kunci path pengiriman (yang menyerialkan run hanya ketika keduanya meminta direktori kerja yang identik) juga tidak menyerialkan keduanya. Mereka dapat menulis file yang sama pada saat yang bersamaan.

Aturan yang menyusul: satu space per tugas paralel.

Jalankan tugas secara paralel — space terpisah

Buka space dengan agen A dan kirimkan sebuah tugas kepadanya.
Buka space kedua dengan agen B dan kirimkan tugas yang berbeda kepadanya.
Keduanya langsung dikirim, masing-masing di checkout space-nya sendiri pada branch-nya sendiri.

Inilah resep yang dipakai setiap kali para agen akan mengedit file.

Bekerja bersama di satu space — beberapa sebutan

Di satu space, sebut lebih dari satu agen dengan @:

@alice refactor the auth module. @bob review what alice lands.

Kedua agen dikirim secara paralel dan mengalir ke space yang sama, dengan penanda pengirimnya. Karena keduanya berbagi checkout space tersebut, gunakan cara ini untuk kolaborasi — satu menulis, satu membaca, atau dua agen bernalar tentang pohon yang sama — bukan untuk dua penyuntingan yang independen.

Lakukan fan-out dari pipeline

Templat pr_review bawaan adalah contoh fan-out yang sudah disertakan: beberapa node peninjau berjalan serentak dari satu pemicu dan node Consolidate (join) melipat temuan mereka menjadi satu laporan. Jalankan dari layar pipeline dan setiap peninjau akan dikirim secara paralel.

Editor pipeline menyembunyikan sentinel terminal dan menyambungkannya ulang untuk menunggu setiap sink yang aktif saat Anda menambah atau menghubungkan sebuah langkah, sehingga branch yang Anda gambar sendiri benar-benar berjalan.

Pantau mereka berjalan

Observabilitas → Langsung (footer bilah sisi → Observabilitas, lalu tab Langsung) menampilkan daftar agen ruang kerja ini, yang diperbarui setiap detik: status (Berjalan / Menganggur / Diparkir / Dibatalkan), apa yang sedang dilakukan setiap agen, token dan biaya untuk run terbarunya, serta kontrol penghentian untuk proses yang sedang berjalan. Memilih sebuah baris membuka laci transkrip langsung.

Pengaturan → Ruang kerja → Agen menampilkan daftar yang sama dengan kosakata status yang berbeda dan mengutamakan perhatian, yang diturunkan dari riwayat run setiap agen — Berjalan, Diblokir, Gagal, Menganggur, Belum ada run — diurutkan sehingga apa pun yang butuh perhatian mengapung ke atas. Tab Log setiap agen memuat riwayat run-nya sendiri.

Kedua permukaan ini dibatasi pada ruang kerja yang aktif.

Menangani konflik

Antar space, setiap space berada pada branch-nya sendiri, sehingga tabrakan muncul sebagai konflik merge Git biasa saat Anda menggabungkan pull request kedua. Selesaikan dengan cara yang sama seperti Anda menyelesaikan konflik merge lainnya.

Di dalam satu space tidak ada batas branch dan tidak ada kunci: para agen menulis file yang sama secara langsung dan yang kalah sekadar ditimpa. Jika Anda merasa perlu dua agen mengedit di satu space, pisahkan pekerjaannya menjadi dua space saja.

Untuk mengurangi tabrakan pada kedua cara itu:

Beri setiap agen cakupan yang berbeda — file yang berbeda, modul yang berbeda.
Gunakan graf kode untuk memeriksa apa yang tersentuh oleh suatu perubahan sebelum mengirim. Lihat Cari kode dengan graf kode.
Tinjau dan gabungkan pull request setiap agen dengan segera.

Pertimbangan sumber daya

Setiap agen yang berjalan menimbulkan biaya berupa:

Checkout space — dapat diabaikan di disk selama copy-on-write tersedia; di Windows berupa git worktree. Sistem berkas yang tidak dapat melakukan reflink akan menggagalkan penyediaan alih-alih menyalin.
Sebuah proses di host server
Token model, yang menumpuk per agen

Biaya tercatat di Observabilitas → Wawasan. Perhatikan bahwa giliran interaktif yang biasa tidak punya batas pengeluaran; lihat Kelola biaya untuk dua perintah yang memilikinya.