Hantar ejen pertama anda

Apa yang akan anda bina

Menjelang akhir tutorial ini, anda akan mempunyai:

• Ejen yang anda cipta dan konfigurasikan sendiri
• Ruang tempat anda dan ejen itu berbual
• Satu larian yang selesai, dengan kerja yang di-commit dalam worktree terasing dan satu baris dalam log larian ejen

Prasyarat: Ruang kerja pertama anda telah selesai, jadi ruang kerja ini mempunyai repo yang didaftarkan dan sekurang-kurangnya satu penyedia model yang disambungkan.

Langkah 1: Cipta ejen

1. Pergi ke Tetapan → Ruang kerja → Ejen
2. Klik Ejen baharu. Ejen bernama “Ejen tanpa nama” dicipta serta-merta dan dipilih dalam senarai ejen — tiada dialog penciptaan dan tiada apa-apa untuk disahkan. Anda mengkonfigurasinya di situ.
3. Pada tab Tetapan, isikan:
   • Nama: sesuatu yang pendek dan mudah diingat, seperti alice. Inilah yang anda taip selepas @.
   • Tajuk: apa yang dilakukannya, cth. “Backend engineer”
   • Penyesuai: Control Center (built-in). Pilih yang ini dengan sengaja — hanya harness terbina boleh dipandu semasa larian dan dijeda pada sempadan giliran dan ia tidak memerlukan CLI dipasang pada hos pelayan.
   • Model: pilih daripada senarai yang disediakan oleh penyedia yang disambungkan
   • Kemahiran: lampirkan mana-mana yang sesuai, cth. testing atau architecture
4. Tekan Simpan perubahan

Ejen tanpa penyesuai berjalan pada gelung terbina

Apabila medan Penyesuai tidak ditetapkan, penghantaran jatuh kembali kepada Control Center (built-in) — gelung ejen di dalam pelayan, jadi tiada apa-apa untuk dipasang pada hos. Ia masih memerlukan model: dengan tiada model ditetapkan ia meminta model lalai daripada Anthropic, yang berfungsi jika anda telah menyambungkan akaun Anthropic dan jika tidak gagal dengan No credential for provider "anthropic". Tetapkan kedua-duanya secara eksplisit juga, jika tidak anda akan berjalan pada model yang tidak anda pilih.

Titik semak. Baris senarai ejen menunjukkan nama ejen anda dan gelang status berongga.

Langkah 2: Mulakan ruang

1. Dalam bar sisi, cari bahagian Ruang dan klik butang +
2. Berikan nama kepada ruang itu
3. Di bawah Tambah ejen, pilih ejen yang baru anda cipta
4. Jika ruang kerja mempunyai repo, pilih yang mana ruang ini patut usahakan
5. Klik Cipta

Ruang itu terbuka. Di latar belakang Control Center menyediakan worktree copy-on-write bagi repo yang dipilih untuk perbualan ini, pada cawangannya sendiri. Checkout sumber anda tidak pernah diubah.

Langkah 3: Hantar tugasan

Taip satu tugasan yang konkrit dan kecil terhadap repo yang anda daftarkan. Sesuatu yang hasilnya boleh diperiksa paling berkesan — tambah ujian, betulkan lint, namakan semula simbol.

Tekan Enter. Anda tidak perlu @-sebut sesiapa: dengan hanya satu ejen dalam ruang itu, mesej biasa membangkitkannya. Dalam ruang dengan beberapa ejen, @name memilih satu.

Control Center memasang prompt daripada arahan ejen, persona, kemahiran dan konteks ruang itu, kemudian menghantar larian itu.

Titik semak. Butang hantar penggubah mesej bertukar menjadi butang henti — ada ejen sedang bekerja dalam perbualan ini — dan teks mula tiba.

Langkah 4: Perhatikan ia bekerja

Perbualan memaparkan larian itu semasa ia berlaku:

• Penaakulan, dipaparkan sebaris semasa ejen berfikir
• Panggilan alat: bacaan dan penulisan fail, carian, perintah shell, masing-masing dengan hasilnya
• Teks: ringkasan, penjelasan dan soalan untuk anda

Jika ejen bertanya sesuatu, jawab dalam perbualan itu dan ia menyambung semula.

Untuk metrik larian itu sendiri serta kawalan jeda, sambung semula dan hentinya, cari ejen yang sedang berjalan dalam bahagian Ejen pada panel Umum ruang itu dan pilih Buka aktiviti.

Dalam panel aktiviti, lencana status berbunyi Berjalan, kemudian Berjaya apabila larian tamat. Larian yang tergendala atau berulang-ulang berbunyi Disekat; yang mengalami ralat berbunyi Gagal. Dalam daftar ejen, gelang senarai ejen berongga sebelum larian pertama dan pejal sebaik sahaja ejen kembali melahu.

Apa yang membataskan larian itu: worktree copy-on-write-nya sendiri, kelayakan yang diuruskan melalui broker untuknya semasa pelancaran dan dicabut semasa teardown, sanitasi persekitaran, permukaan alat yang dibenarkan oleh modusnya dan guardrail tindakan. Kesan seperti push cawangan atau membuka pull request dipagari secara berasingan — lihat Guardrail.

Langkah 5: Semak hasilnya

1. Buka Tetapan → Ruang kerja → Ejen dan pilih ejen anda
2. Buka tab Log

Titik semak. Satu baris larian, menunjukkan statusnya, tempoh, masa mula dan tamat serta penyesuai yang menjalankannya.

Perubahan ejen di-commit pada cawangan perbualan itu, dalam worktree-nya. Commit dikarang sebagai ejen, dengan anda dikreditkan dalam trailer Co-Authored-By:.

Mendapatkan pull request

Tiada apa-apa yang membuka pull request dengan sendirinya. Jika anda mahukannya, minta dalam perbualan yang sama:

Push cawangan ini dan buka pull request terhadap cawangan lalai.

Push (gitPush) dan penciptaan PR (prCreate) kedua-duanya secara lalai meminta kelulusan anda, jadi jangkakan pengesahan sebelum setiap satu. Jika tiada pelulus disambungkan apabila gesaan itu tercetus, tindakan itu ditolak dan bukan dibenarkan — guardrail gagal tertutup.

PR itu dibuka di bawah identiti GitHub yang tokennya digunakan oleh larian itu — milik anda, jika anda menyimpan token peribadi — bukan di bawah nama ejen. Kepengarangan ejen kelihatan pada commit.

Anda juga boleh membukanya sendiri: panel Kawalan sumber ruang itu mempunyai butang Cipta pull request yang membawa cawangan perbualan itu ke skrin penggubahan dan Pull request → PR baharu membuka skrin yang sama dalam keadaan kosong. Di situlah tutorial seterusnya bermula.

Rumusan

Anda mencipta ejen, mengkonfigurasi penyesuai dan modelnya, memberikannya ruang dan tugasan dan memerhati larian sebenar tamat dalam worktree terasing tanpa menyentuh checkout anda.

Seterusnya: Semak pull request pertama anda untuk mempelajari aliran kerja semakan.

Untuk lebih lanjut tentang ejen: Model ejen. Untuk butiran penghantaran: Kitaran hayat penghantaran ejen.