Bekerja di Plan Studio

Panduan ini menunjukkan cara bekerja dengan rencana di Plan Studio. Untuk apa itu orkestrasi dan dokumen rencana, lihat Orkestrasi dan Gunakan mode rencana.

Buka rencana

Rencana dimiliki oleh percakapan yang menghasilkannya, jadi dari sanalah Anda biasanya mengaksesnya: baris rencana di percakapan memiliki aksi Buka dan Plan Studio terbuka sebagai tab editor di samping percakapan.

Hub mencantumkan tiga bagian:

Rencana aktif — orkestrasi, yang diusulkan lebih dulu, beserta status, jumlah langkah dan nomor revisinya.
Dokumen rencana — rencana yang diajukan satu agen dengan submit_plan di mode rencana, selama masih diusulkan atau disetujui.
Playbook — templat rencana berparameter yang tersimpan.

Klik sebuah kartu untuk membukanya di Plan Studio. Rutanya adalah /workspaces/<workspace-id>/plans/<kind>/<plan-id>, dengan kind berupa orchestration atau document, jadi Anda juga dapat menautkan satu rencana secara mendalam.

Jika Anda membuka sebuah orkestrasi, Anda mendapatkan kanvas yang dapat diedit, linimasa versi dan bilah persetujuan. Jika Anda membuka dokumen rencana, graf yang sama ditampilkan sebagai hanya baca — dokumen rencana ditulis oleh agen; Anda meninjau, mengestimasi, dan menyetujui atau menolaknya, dan dokumen yang disetujui menampilkan status eksekusi per node secara langsung dari orkestrasi yang dihasilkan darinya.

Edit DAG

Edit dapat dilakukan pada sebuah orkestrasi selama statusnya proposed. Semua pengeditan di kanvas dilakukan lewat keyboard:

Klik kanvas, lalu pindahkan pilihan dengan tombol panah.
Tekan n untuk menambahkan langkah. Langkah itu muncul terpilih sebagai “Langkah baru”; ganti namanya di inspector di sebelah kanan.
Tekan e pada langkah yang harus berjalan lebih dulu, lalu klik langkah yang bergantung (atau pilih langkah itu dan tekan Enter) untuk menyambungkan dependensi. Tekan Esc untuk membatalkan koneksi yang tertunda.
Tekan x untuk memotong dependensi terbaru dari langkah terpilih, atau alihkan dependensi persis di editor dependensi pada inspector.
Tekan Delete untuk menghapus langkah terpilih; referensi ke langkah itu dihapus dari dependensi langkah-langkah yang tersisa.

Di inspector Anda juga dapat mengedit deskripsi, peran, dan skema output langkah. Edit tersimpan otomatis sebagai revisi baru setelah jeda singkat; kesalahan validasi (yang ditampilkan di bilah persetujuan) menghalangi penyimpanan sampai Anda memperbaikinya.

Hanya langkah kerja yang dapat diedit. Node struktural — riset, diskusi dan sintesis — bersifat hanya baca, begitu pula langkah yang pekerjaannya sudah dijalankan (ditandai “sudah dijalankan”, karena mengeditnya akan mencabangkan rencana).

Penyimpanan bersifat konkuren optimistis terhadap revisi tempat Anda mulai. Jika orkestrator menyusun ulang rencana di bawah Anda, penyimpanan Anda ditolak dengan “The plan moved on” alih-alih digabungkan atau ditimpa secara diam-diam; baca ulang revisi saat ini dan ulangi pengeditan Anda. Penyusunan ulang yang diprakarsai agen sendiri dibatasi lajunya menjadi satu setiap dua menit, sehingga hal ini tetap jarang terjadi.

Baca estimasi biaya, waktu, dan risiko

Tekan Estimasi di bilah persetujuan.

Setiap langkah di kanvas mendapat lencana berisi rentang biaya dan ukuran sampel di baliknya, atau “Belum ada riwayat” jika peran langkah tersebut belum pernah berjalan. Pilih sebuah langkah untuk detail lengkapnya di inspector: rentang biaya beserta ukuran sampel, rentang durasi dan radius dampak (file dan simbol) yang diturunkan dari asal-usul langkah — atau “tidak diketahui” jika langkah tersebut tidak membawa asal-usul.
Bilah persetujuan menampilkan total rencana: rentang biaya keseluruhan, rentang durasi untuk jalur kritis (cabang paralel tumpang tindih, jadi ini bukan penjumlahannya) dan batas anggaran jika rencana menetapkannya.
Jika hanya sebagian langkah yang memiliki riwayat, totalnya ditandai sebagian dan hanya mencakup langkah yang dapat diestimasi. Jika ujung atas estimasi melebihi batas anggaran, totalnya berubah merah dengan peringatan melebihi anggaran.

Estimasi bersifat jujur atau tidak ada sama sekali: langkah yang perannya tidak memiliki riwayat eksekusi yang selesai melaporkan ukuran sampel nol tanpa rentang apa pun dan ditampilkan sebagai tidak diketahui, bukan ditaksir. Perlakukan “Belum ada riwayat” sebagai “tidak ada yang tahu”, bukan “murah”.

Batas anggaran hanyalah perbandingan tampilan terhadap estimasi ini. Tidak ada yang menegakkannya setelah rencana berjalan — lihat Kelola biaya untuk kontrol yang benar-benar menghentikan pengeluaran.

Bandingkan revisi dengan proposal sebelumnya

Setiap pengeditan dan setiap penyusunan ulang oleh orkestrator ditambahkan ke linimasa revisi yang hanya dapat ditambahi, yang ditampilkan di panel Versi di sebelah kiri rencana orkestrasi.

Klik sebuah revisi untuk membandingkannya dengan proposal saat ini. Tanpa pilihan, panel membandingkan revisi sebelumnya dengan revisi saat ini.
Baca hasil diff di paruh bawah panel: langkah yang ditambahkan, dihapus, atau diubah antara kedua revisi.
Jika rencana masih proposed, klik ikon putar ulang pada sebuah revisi untuk kembali ke revisi itu. Memutar ulang menyimpan proposal tersebut sebagai revisi baru — tidak ada yang hilang.

propose_orchestration dan editor sama-sama menolak perubahan setelah rencana tidak lagi proposed, sehingga eksekusi yang sedang berjalan tidak mengambil penyusunan ulang di tengah eksekusi.

Setujui, tolak, atau perluas rencana

Dari aplikasi, rencana yang diusulkan adalah satu keputusan yang diambil secara utuh: Setujui rencana atau Tolak di bilah persetujuan. Setujui rencana selalu menyetujui setiap langkah — tidak ada cara untuk memilih sebagian lebih dulu. Persetujuan dihalangi selama proposal memiliki kesalahan validasi, yang ditampilkan di samping tombol.

Menyetujui hanya dapat dilakukan operator. Tidak ada alat MCP untuk itu, jadi agen dapat mengusulkan dan merevisi rencana tetapi tidak pernah bisa menyetujuinya.

Setelah orkestrasi dieksekusi, bilah tersebut berubah:

Jika sebuah langkah berhenti untuk bertanya di tengah eksekusi, pilih langkah itu dan tekan Lanjutkan node untuk melanjutkannya.
Tekan Setujui yang dipilih untuk memperluas persetujuan sebagian ke langkah terpilih beserta semua yang menjadi dependensi transitifnya (sebuah langkah tidak pernah bisa disetujui tanpa dependensinya). Kontrol ini ada di bilah eksekusi untuk setiap orkestrasi; kontrol ini tidak melakukan apa pun jika rencana disetujui secara utuh.
Tekan Batalkan eksekusi untuk menghentikan seluruh orkestrasi.

Langkah di luar kumpulan yang disetujui sebagian ditampilkan sebagai ditunda dan tidak berjalan sampai Anda memperluas kumpulan tersebut.

Jalankan playbook dengan parameter

Playbook adalah templat rencana tersimpan dengan placeholder {{param}} bertipe di tujuan, judul langkah, deskripsi dan promptnya. Substitusinya literal — tidak ada bahasa ekspresi; jika Anda memerlukan logika, gunakan pipeline sebagai gantinya.

Di bagian Playbook pada hub, tekan Jalankan pada playbook tersebut (atau buka palet ⌘K dan pilih playbook di sana).
Isi parameternya. Parameter enumerasi ditampilkan sebagai dropdown; parameter repo dan agen menerima referensi repo atau agen; parameter opsional kembali ke nilai default-nya.
Pilih tiket jangkar yang menjadi dasar pengusulan rencana, lalu konfirmasi.

Menjalankan playbook hanya mengusulkan rencana — orkestrasi yang diinstansiasi terbuka di Plan Studio sebagai proposed dan tidak ada yang dieksekusi sampai Anda menyetujuinya di sana. Untuk menghapus playbook, tekan ikon sampah pada kartunya.

Agen membuat dan menjalankan playbook dengan alat MCP create_playbook dan run_playbook; lihat referensi alat MCP.

Panduan terkait

Gunakan mode rencana: bagaimana agen menghasilkan dokumen rencana dengan submit_plan
Jalankan orkestrasi: siklus hidup sekali-setujui dari sisi percakapan
Buat templat pipeline: saat Anda memerlukan logika yang tidak dapat diungkapkan playbook
Pantau eksekusi pipeline: tampilan mesin dari rencana yang disetujui

Konsep terkait

Orkestrasi