Cipta dan konfigurasikan ejen

Panduan ini menunjukkan cara menambah ejen ke ruang kerja dan mengkonfigurasikannya sehingga ia benar-benar boleh berjalan.

Setiap ruang kerja disemai dengan lima ejen — seorang CEO serta qa, architect, engineer dan librarian — jadi anda biasanya sudah mempunyai ejen sebelum mengkonfigurasikan mana-mana satu. Langkah di bawah terpakai sama rata kepada ejen yang disemai dan ejen baharu.

Sebelum anda mula

Anda berada di dalam sesuatu ruang kerja. Keseluruhan permukaannya terletak di Tetapan → Ruang kerja → Ejen (/settings/workspace/agents).
Ejen itu memerlukan bahagian belakang. Sama ada sambungkan penyedia untuk harness terbina di bawah Tetapan → Pelayan → Penyedia model, atau pasang CLI Claude Code pada mesin yang menghoskan cc_server.
Jika anda mahu ejen itu membawa kemahiran, pasangnya dahulu di bawah Tetapan → Ruang kerja → Kemahiran. Borang ejen hanya membenarkan anda menogol kemahiran yang sudah wujud dalam ruang kerja.

Tambah ejen

Buka Tetapan → Ruang kerja → Ejen.
Klik Ejen baharu.

Tiada dialog dan tiada pemilih peranan. Ejen bernama “Ejen tanpa nama” dicipta serta-merta dan dipilih dalam panel butiran di sebelah kanan.

Anda sekarang sepatutnya melihat “Ejen tanpa nama” dalam senarai ejen di sebelah kiri, dengan tab Tetapan panel butirannya terbuka dan medan Nama yang mengandungi “Ejen tanpa nama”.

Namakannya

Nama — pengecam pendek yang digunakan dalam @-sebutan, contohnya alice. Penghuraian sebutan memadankan @ diikuti aksara perkataan, jadi nama yang mengandungi sengkang, titik atau ruang tidak boleh disebut.
Tajuk — label yang boleh dibaca manusia, contohnya “Pengekod kanan”.
Prompt sistem — arahan tambahan pilihan, disuntik sebagai bahagian Agent instructions; ia tidak menggantikan baki prompt yang dihimpunkan.

Klik Simpan perubahan di bahagian bawah borang. Setiap medan pada halaman ini disimpan oleh satu butang itu.

Berikan penyesuai dan model

Menu lungsur Penyesuai menyenaraikan pelari yang benar-benar ada pada hos pelayan. Penyesuai terbina sentiasa ditemui (ia ialah pelayan itu). Claude Code muncul hanya apabila CLI-nya dikesan pada hos itu:

Penyesuai	Bahagian belakang
Control Center (built-in)	Gelung ejen dalam proses — tiada CLI luaran
Claude Code	`claude -p --output-format stream-json`

Hanya penyesuai terbina yang menguatkuasakan modus, pengemudian, jeda/sambung semula, kontrak penyiapan dan subejen. Claude Code tidak memberikan mana-mana daripadanya. Cursor, Codex dan penyedia model lain menyertai penyesuai terbina, bukan sebagai pelari yang berasingan.

Menu lungsur Model dipacu oleh penyesuai yang anda pilih. Bagi penyesuai terbina, senarai itu datang secara langsung daripada penyedia yang anda sambungkan di bawah Tetapan → Pelayan → Penyedia model, jadi penyedia yang tiada kelayakan tersimpan menyumbang sifar model.

Tambah kemahiran

Kemahiran ialah pemilih cip bagi himpunan kemahiran yang dipasang dalam ruang kerja ini. Ketik satu cip untuk menogolnya; glif tanda semak menandakan cip yang dipilih. Jika ruang kerja tiada kemahiran, medan itu berbunyi “No skills available. Create skills in Settings → Skills first.”

Anda tidak memilih kemahiran milik repositori di sini. Repositori yang menyertakannya (dalam .agents/skills/, .claude/skills/ atau .opencode/skills/) menyumbangnya secara automatik kepada mana-mana ejen yang bekerja dalam repositori itu, dan ia bertukar ganti apabila ejen berpindah ke repositori lain — lihat Kemahiran berskop repositori.

Tetapkan garis pelaporan dan persona

Melapor kepada — pilih ejen lain mengikut nama. Ini membina pokok pelaporan yang dipaparkan oleh butang Carta organisasi dalam pengepala halaman. Ia bukan senarai ejen yang digunakan oleh ketua pasukan semasa mewakilkan kerja — senarai itu datang daripada ahli pasukan dan kemahiran mereka.
Persona — teks bebas yang membentuk nada dan tingkah laku, contohnya: “Mengutamakan penyelesaian yang ringkas dan mudah dibaca. Menulis ujian untuk semua kod baharu.”

Laraskan larian

Usaha penaakulan — pilihannya datang daripada tahap yang diterbitkan oleh model yang dipilih sendiri: Low / Medium / High, serta Extra High pada model gaya OpenAI dan Extra High + Max pada model gaya Claude. Medan ini disembunyikan sepenuhnya apabila model yang dipilih tidak mengisytiharkan tahap pemikiran, dan ia menggunakan lalai model itu sendiri.
Saiz tetingkap konteks — diisi awal daripada tetingkap konteks model setiap kali anda menukar model, dengan cip satu ketikan untuk lalai model, 200k, 500k dan 1M. Nilai yang anda taip selepas memilih model mengalah sehingga perubahan model seterusnya.
Tamat masa senyap (minit) — tamatkan larian selepas tempoh ini tanpa output. Biarkan kosong untuk menggunakan lalai setiap modus.

Berikan kebenaran

Ejen tidak mempunyai togol kebenaran sendiri. Apa yang boleh di-push, dibuka, dicantum atau dicapainya ditetapkan oleh peraturan tindakan di Tetapan → Ruang kerja → Kebenaran ejen, tempat sesuatu peraturan boleh dihadkan kepada ejen ini. Secara lalai, push, pull request, semakan atau cantuman dan penulisan ke penjejak masing-masing bertanya kepada anda terlebih dahulu, dan akses rangkaian dibenarkan.

Token GitHub ejen sentiasa baca sahaja. Push melalui Control Center, yang bertanya kepada peraturan Push ke remote sebelum memajukannya. Lihat Konfigurasikan polisi kotak pasir untuk cara setiap peraturan sampai kepada sesuatu larian.

Sahkan ia berjalan

Buka Tetapan → Pelayan → Penyedia model dan sahkan penyesuai yang anda pilih melaporkan versi yang dipasang dan bukan “Tidak dijumpai”. Klik Muat semula untuk memeriksa semula — pemeriksaan itu berjalan pada mesin yang menghoskan cc_server, bukan pada mesin yang anda sedang lihat.
Buka ruang bersama ejen itu dan hantar mesej kepadanya, atau @-sebut ia dalam ruang yang sedia ada.
Kembali ke Tetapan → Ruang kerja → Ejen, pilih ejen itu dan buka tab Log padanya. Satu larian sepatutnya muncul dengan lencana status, tempoh, masa mula dan penyesuai yang digunakannya. Lihat membuka strim peristiwa larian itu.

Jika tiada larian langsung muncul, telusuri Diagnosis ejen.

Padam ejen

Pilihnya dalam senarai ejen. Pada tab Tetapan, tatal ke Zon bahaya di bahagian bawah borang dan klik Padam.