Kirim agen pertama Anda

Apa yang akan Anda bangun

Pada akhir tutorial ini, Anda akan memiliki:

• Agen yang Anda buat dan konfigurasi sendiri
• Space tempat Anda dan agen tersebut berbicara
• Satu run yang selesai, dengan pekerjaan yang di-commit di worktree terisolasi dan satu baris di log run agen tersebut

Prasyarat: Ruang kerja pertama Anda sudah selesai, sehingga ruang kerja ini memiliki repo yang terdaftar dan setidaknya satu penyedia model yang terhubung.

Langkah 1: Buat agen

1. Buka Pengaturan → Ruang kerja → Agen
2. Klik Agen baru. Agen bernama “Agen tanpa nama” langsung dibuat dan dipilih di roster — tidak ada dialog pembuatan dan tidak ada yang perlu dikonfirmasi. Anda mengonfigurasinya di tempat.
3. Pada tab Pengaturan, isi:
   • Nama: sesuatu yang singkat dan mudah diingat, seperti alice. Inilah yang Anda ketik setelah @.
   • Judul: apa yang dikerjakannya, mis. “Pengembang backend”
   • Adapter: Control Center (built-in). Pilih yang ini secara sengaja — hanya harness bawaan yang dapat diarahkan saat run berjalan dan dijeda pada batas giliran, dan ia tidak memerlukan CLI yang terpasang di host server.
   • Model: pilih dari daftar yang disediakan penyedia yang terhubung
   • Skill: lampirkan yang sesuai, mis. testing atau architecture
4. Tekan Simpan perubahan

Agen tanpa adapter berjalan pada loop bawaan

Saat kolom Adapter tidak disetel, pengiriman akan kembali ke Control Center (built-in) — loop agen di dalam server, sehingga tidak ada yang perlu dipasang di host. Ia tetap memerlukan model: tanpa model yang disetel, ia meminta defaultnya kepada Anthropic, yang berhasil jika Anda telah menghubungkan akun Anthropic dan jika tidak akan gagal dengan No credential for provider "anthropic". Setel keduanya secara eksplisit, atau Anda akan berjalan pada model yang tidak Anda pilih.

Titik pemeriksaan. Baris roster menampilkan nama agen Anda dan cincin status yang berongga.

Langkah 2: Mulai space

1. Di bilah sisi, temukan bagian Ruang dan klik tombol +
2. Beri nama space itu
3. Di bawah Tambah agen, pilih agen yang baru Anda buat
4. Jika ruang kerja memiliki repo, pilih repo mana yang seharusnya dikerjakan space ini
5. Klik Buat

Space akan terbuka. Di latar belakang, Control Center menyediakan worktree copy-on-write dari repo yang dipilih untuk percakapan ini, pada cabangnya sendiri. Checkout sumber Anda tidak pernah diubah.

Langkah 3: Kirim tugas

Ketik satu tugas kecil yang konkret pada repo yang Anda daftarkan. Sesuatu dengan hasil yang dapat diperiksa paling cocok — tambahkan pengujian, perbaiki lint, ganti nama sebuah simbol.

Tekan Enter. Anda tidak perlu melakukan @-mention siapa pun: dengan satu agen di space itu, pesan biasa sudah membangunkannya. Di space dengan beberapa agen, @name memilih salah satunya.

Control Center menyusun prompt dari instruksi, persona, dan skill agen serta konteks space tersebut, lalu mengirimkan run-nya.

Titik pemeriksaan. Tombol kirim composer berubah menjadi tombol berhenti — ada agen yang bekerja di percakapan ini — dan teks mulai berdatangan.

Langkah 4: Saksikan agen bekerja

Percakapan menampilkan run itu saat berlangsung:

• Penalaran, ditampilkan sebaris saat agen berpikir
• Panggilan alat: pembacaan dan penulisan file, pencarian, perintah shell, masing-masing dengan hasilnya
• Teks: ringkasan, penjelasan, dan pertanyaan untuk Anda

Jika agen menanyakan sesuatu, jawab di percakapan dan ia akan melanjutkan.

Untuk metrik milik run itu sendiri serta kontrol jeda, lanjutkan, dan hentikannya, temukan agen yang sedang berjalan di bagian Agen pada panel Umum space tersebut lalu pilih Buka aktivitas.

Di panel aktivitas, lencana status menampilkan Berjalan, lalu Berhasil saat run berakhir. Run yang mandek atau berulang-ulang menampilkan Diblokir; run yang mengalami galat menampilkan Gagal. Di registri agen, cincin status pada roster berongga sebelum run pertama dan padat begitu agen kembali menganggur.

Yang membatasi run: worktree copy-on-write miliknya sendiri, kredensial yang dijembatani untuknya saat peluncuran dan dicabut saat pembongkaran, lingkungan yang disanitasi, permukaan alat yang diizinkan modenya, serta pagar pengaman tindakan. Efek seperti push cabang atau membuka pull request digerbangi secara terpisah — lihat Pagar pengaman.

Langkah 5: Periksa hasilnya

1. Buka Pengaturan → Ruang kerja → Agen dan pilih agen Anda
2. Buka tab Log

Titik pemeriksaan. Satu baris run, yang menampilkan status, durasi, waktu mulai dan selesai, serta adapter yang dipakainya.

Perubahan agen di-commit pada cabang percakapan itu, di dalam worktree-nya. Commit-commit tersebut dikarang sebagai agen, dengan Anda dicantumkan dalam trailer Co-Authored-By:.

Mendapatkan pull request

Tidak ada yang membuka pull request dengan sendirinya. Jika Anda menginginkannya, mintalah di percakapan yang sama:

Push cabang ini dan buka pull request ke cabang default.

Push (gitPush) dan pembuatan PR (prCreate) keduanya secara bawaan meminta persetujuan Anda, jadi perkirakan adanya konfirmasi sebelum masing-masing. Jika tidak ada pemberi persetujuan yang terhubung saat prompt itu muncul, tindakan tersebut ditolak, bukan diizinkan — pagar pengaman gagal tertutup.

PR dibuka dengan identitas GitHub yang tokennya dipakai run tersebut — identitas Anda, jika Anda menyimpan token pribadi — bukan dengan nama agen. Kepengarangan agen terlihat pada commit-commit itu.

Anda juga dapat membukanya sendiri: panel Kontrol sumber di space tersebut memiliki tombol Buat pull request yang membawa cabang percakapan itu ke layar penyusunan, dan Pull requests → PR baru membuka layar yang sama dalam keadaan kosong. Di situlah tutorial berikutnya melanjutkan.

Rekap

Anda membuat agen, mengonfigurasi adapter dan modelnya, memberinya space dan tugas, lalu menyaksikan run sungguhan selesai di worktree yang terisolasi tanpa menyentuh checkout Anda.

Berikutnya: Tinjau pull request pertama Anda untuk mempelajari alur kerja tinjauan.

Untuk selengkapnya tentang agen: Model agen. Untuk detail pengiriman: Siklus hidup pengiriman agen.