Bekerja dalam Plan Studio

Panduan ini menunjukkan cara anda bekerja dengan rancangan dalam Plan Studio. Untuk mengetahui apa itu orkestrasi dan dokumen rancangan, lihat Orkestrasi dan Gunakan modus pelan.

Buka rancangan

Sesuatu rancangan kepunyaan perbualan yang menghasilkannya, jadi di situlah anda biasanya mencapainya: baris rancangan dalam perbualan mempunyai tindakan Buka dan Plan Studio terbuka sebagai tab editor di sebelah perbualan.

Tiada entri “Rancangan” dalam bar sisi

Itu memang disengajakan, bukan kecuaian. Hab di /workspaces/<workspace-id>/plans hanyalah pautan mendalam yang boleh dilalui, jadi tandakannya jika anda mahukan senarai tetap.

Hab menyenaraikan tiga seksyen:

• Rancangan aktif — orkestrasi, yang dicadangkan didahulukan, dengan status, bilangan langkah dan nombor semakannya.
• Dokumen rancangan — rancangan yang diserahkan oleh satu ejen dengan submit_plan dalam modus pelan, selagi ia dicadangkan atau diluluskan.
• Buku panduan — templat rancangan tersimpan yang berparameter.

Klik kad untuk membukanya dalam Plan Studio. Laluannya ialah /workspaces/<workspace-id>/plans/<kind>/<plan-id>, dengan kind ialah orchestration atau document, jadi anda juga boleh memaut terus satu rancangan.

Jika anda membuka orkestrasi, anda mendapat kanvas boleh sunting, garis masa versi dan bar kelulusan. Jika anda membuka dokumen rancangan, graf yang sama dipaparkan sebagai baca sahaja — dokumen rancangan dikarang oleh ejen; anda menyemak, menganggar dan meluluskan atau menolaknya, dan dokumen yang diluluskan memaparkan keadaan larian setiap nod secara langsung daripada orkestrasi yang dihasilkan oleh kompilasinya.

Sunting DAG

Suntingan boleh dilakukan pada orkestrasi selagi ia proposed. Semua suntingan kanvas dipacu papan kekunci:

1. Klik kanvas, kemudian gerakkan pilihan dengan kekunci anak panah.
2. Tekan n untuk menambah langkah. Ia muncul terpilih sebagai “Langkah baharu”; namakannya semula dalam pemeriksa di sebelah kanan.
3. Tekan e pada langkah yang mesti berjalan dahulu, kemudian klik langkah bersandar (atau pilihnya dan tekan Enter) untuk menyambung kebergantungan. Tekan Esc untuk membatalkan sambungan yang belum selesai.
4. Tekan x untuk memotong kebergantungan terbaharu langkah yang dipilih, atau togol kebergantungan tepat dalam editor kebergantungan pemeriksa.
5. Tekan Delete untuk membuang langkah yang dipilih; rujukan kepadanya dibuang daripada kebergantungan langkah yang tinggal.

Dalam pemeriksa, anda juga boleh menyunting perihalan, peranan dan skema output langkah. Suntingan disimpan secara automatik sebagai semakan baharu selepas jeda singkat; ralat pengesahan (dipaparkan dalam bar kelulusan) menyekat penyimpanan sehingga anda membaikinya.

Hanya langkah kerja boleh disunting. Nod struktur — kajian, perbincangan dan sintesis — adalah baca sahaja, begitu juga mana-mana langkah yang kerjanya sudah berjalan (ia ditandakan “sudah dilaksanakan”, kerana menyuntingnya akan mencabangkan rancangan).

Penyimpanan bersifat serentak optimistik pada semakan yang anda mulakan. Jika orkestrator merancang semula di bawah anda, simpanan anda ditolak dengan “rancangan telah berubah” dan bukan digabungkan atau ditimpa secara senyap; baca semula semakan semasa dan ulangi suntingan anda. Perancangan semula yang dimulakan ejen sendiri dihadkan kadar kepada satu setiap dua minit, jadi ini jarang berlaku.

Nota

Kanvas tidak mempunyai fungsi seret untuk mengubah kedudukan: susun aturnya dikira daripada struktur kebergantungan, jadi “menggerakkan” langkah bermakna menyambung semula kebergantungannya.

Baca anggaran kos, masa dan risiko

Tekan Anggar dalam bar kelulusan.

• Setiap langkah pada kanvas mendapat lencana dengan julat kos dan saiz sampel di sebaliknya, atau “Belum ada sejarah” apabila peranan langkah itu tidak pernah berjalan. Pilih langkah untuk perincian penuh dalam pemeriksa: julat kos dengan saiz sampel, julat tempoh dan jejari letupan (fail dan simbol) yang diperoleh daripada asal usul langkah itu — atau “tidak diketahui” apabila langkah itu tiada asal usul.
• Bar kelulusan menunjukkan jumlah rancangan: julat kos keseluruhan, julat tempoh untuk laluan kritikal (cabang selari bertindih, jadi ini bukan jumlah) dan siling bajet apabila rancangan menetapkannya.
• Jika hanya sebahagian langkah mempunyai sejarah, jumlahnya ditandakan sebahagian dan hanya merangkumi langkah yang boleh dianggarkan. Jika hujung tinggi anggaran melebihi siling bajet, jumlahnya bertukar merah dengan amaran melebihi bajet.

Anggaran bersifat jujur atau tiada: langkah yang peranannya tiada sejarah larian yang selesai melaporkan saiz sampel sifar tanpa sebarang julat dan dipaparkan sebagai tidak diketahui dan bukan diagak. Anggap “Belum ada sejarah” sebagai “tiada siapa tahu”, bukan “murah”.

Siling bajet hanyalah perbandingan paparan terhadap anggaran ini. Tiada apa-apa yang menguatkuasakannya sebaik rancangan berjalan — lihat Urus kos untuk kawalan yang benar-benar menghentikan perbelanjaan.

Bezakan semakan dengan cadangan terdahulu

Setiap suntingan dan setiap perancangan semula oleh orkestrator ditambah pada garis masa semakan yang hanya menambah, dipaparkan dalam panel Versi di sebelah kiri rancangan orkestrasi.

1. Klik satu semakan untuk membezakannya dengan cadangan semasa. Tanpa pilihan, panel membezakan semakan sebelumnya dengan semakan semasa.
2. Baca perbezaan pada separuh bawah panel: langkah yang ditambah, dibuang atau diubah antara dua semakan itu.
3. Jika rancangan masih proposed, klik ikon undur pada sesuatu semakan untuk kembali kepadanya. Mengundur menyimpan cadangan itu sebagai semakan baharu — tiada apa-apa yang hilang.

propose_orchestration dan editor kedua-duanya menolak perubahan sebaik rancangan tidak lagi proposed, jadi larian yang sedang berjalan tidak mengambil perancangan semula di tengah pelaksanaan.

Luluskan, tolak atau luaskan rancangan

Dalam apl, rancangan yang dicadangkan ialah satu keputusan yang diambil secara menyeluruh: Luluskan rancangan atau Tolak dalam bar kelulusan. Luluskan rancangan sentiasa meluluskan setiap langkah — tiada cara untuk memilih sebahagian kecil dahulu. Kelulusan disekat selagi cadangan mempunyai ralat pengesahan, yang dipaparkan di sebelah butang.

Meluluskan hanya untuk pengendali. Tiada alat MCP untuknya, jadi ejen boleh mencadangkan dan menyemak semula rancangan tetapi tidak pernah boleh meluluskannya.

Sebaik orkestrasi mula melaksana, bar berubah:

• Jika sesuatu langkah berhenti untuk bertanya di tengah larian, pilihnya dan tekan Teruskan nod untuk menyambungnya semula.
• Tekan Luluskan yang dipilih untuk meluaskan kelulusan sebahagian kepada langkah yang dipilih serta semua yang bergantung secara transitif kepadanya (sesuatu langkah tidak pernah boleh diluluskan tanpa kebergantungannya). Kawalan ini ada pada bar pelaksanaan bagi setiap orkestrasi; ia tidak melakukan apa-apa apabila rancangan diluluskan secara menyeluruh.
• Tekan Batal larian untuk menghentikan keseluruhan orkestrasi.

Langkah di luar set kelulusan sebahagian dipaparkan sebagai ditangguhkan dan tidak berjalan sehingga anda meluaskan set itu.

Kelulusan sebahagian tidak boleh bermula dalam apl

Kelulusan sebahagian hanya wujud apabila sesuatu memanggil orchestration.approve melalui RPC dengan senarai approved_node_keys yang eksplisit. Luluskan rancangan dalam apl sentiasa meluluskan setiap langkah. Dokumen rancangan diluluskan secara menyeluruh dalam semua kes, jadi dokumen yang sedang dilaksanakan hanya menawarkan Batal larian.

Jalankan buku panduan dengan parameter

Buku panduan ialah templat rancangan tersimpan dengan pemegang tempat {{param}} bertipe dalam matlamat, tajuk langkah, perihalan dan gesaannya. Penggantian bersifat literal — tiada bahasa ungkapan; jika anda perlukan logik, gunakan pipeline sebaliknya.

1. Dalam seksyen Buku panduan hab, tekan Jalankan pada buku panduan itu (atau buka palet ⌘K dan pilih buku panduan di situ).
2. Isi parameter. Parameter penghitungan dipaparkan sebagai menu lungsur; parameter repo dan ejen mengambil rujukan repo atau ejen; parameter pilihan kembali kepada nilai lalainya.
3. Pilih tiket sauh yang menjadi sandaran cadangan rancangan itu, kemudian sahkan.

Menjalankan buku panduan hanya mencadangkan rancangan — orkestrasi yang terhasil terbuka dalam Plan Studio sebagai proposed dan tiada apa-apa yang dilaksanakan sehingga anda meluluskannya di situ. Untuk membuang buku panduan, tekan ikon tong sampah pada kadnya.

Ejen mencipta dan menjalankan buku panduan dengan alat MCP create_playbook dan run_playbook; lihat Rujukan alat MCP.

Panduan berkaitan

• Gunakan modus pelan: cara ejen menghasilkan dokumen rancangan dengan submit_plan
• Jalankan orkestrasi: kitaran hayat lulus-sekali dari sisi perbualan
• Cipta templat pipeline: apabila anda perlukan logik yang tidak dapat diungkapkan oleh buku panduan
• Pantau larian pipeline: paparan enjin bagi rancangan yang diluluskan

Konsep berkaitan

• Orkestrasi