Kontrak aksi dan kemampuan
Bedakan penemuan aksi, laporan kemampuan terpasang, pemeriksaan awal, eksekusi, dan kewenangan server.
Ringkasan
CLI menyediakan manifes aksi, pemeriksaan awal offline, penemuan kemampuan terpasang, dan perintah native eksplisit. Bootstrap 0.1.9 membuat tata letak instalasi bertanda tangan yang diperlukan untuk kemampuan. Output ini menjawab pertanyaan berbeda; tidak satu pun boleh dianggap bukti untuk yang lain.
Manifes Aksi Pelanggan
Manifes berversi berisi 25 aksi:
22 aksi ditandai
executes=true;altifigence.analyze.run,altifigence.evolve.launch, danaltifigence.verify.runmerupakan tiga aksi yang hanya menghasilkan rencana.
executes=true berarti aksi ditetapkan dapat dieksekusi. Perintah sebenarnya masih dapat memerlukan engine lokal, izin akun, atau layanan jarak jauh. Aksi perencanaan saja memvalidasi dan mengembalikan rencana tanpa menjalankan tugas.
Gunakan alti commands untuk memeriksa manifes yang dikirim bersama biner saat ini. Jangan menyalin daftar perintah dari rilis lain.
Bukti Hasil Pemeriksaan Awal Offline
Alur kerja offline job validate memverifikasi satu pembungkus RTL CPU yang dibatasi dan sumber aman relatif terhadap workspace. Bukti hasil berhasil secara eksplisit menyatakan submitted: false dan server_authority_verified: false. Alur ini tidak menjalankan engine lokal atau menghubungi layanan yang dihosting. Lihat Keberhasilan Pertama CLI.
Kontrak Kemampuan Engine Terpasang
Skema kemampuan menetapkan status berikut untuk rilis yang diinstal dengan benar dan didukung bukti hasil:
Status | Makna |
|---|---|
| Rilis terpasang menyediakan cakupan lokal yang terdokumentasi |
| Hanya subset yang dilaporkan yang tersedia |
| Rilis terpasang tidak dapat menyediakan cakupan tersebut |
| Aksi memerlukan persetujuan eksplisit yang terdokumentasi |
| Aksi mengembalikan rencana, bukan bukti eksekusi |
Ikuti Verifikasi Unduhan dan Instalasi di Linux sebelum memakai alti capabilities. Bootstrap tertanam membuat tata letak katalog/bukti hasil yang diautentikasi; jangan menyalin biner ke lokasi lain atau merekayasa status tersebut. Kesiapan terpasang melaporkan kemampuan yang tersedia. Bukti bahwa desain atau tugas GPU telah berjalan berasal dari hasil eksekusinya.
Pertanyaan | Dijawab oleh |
|---|---|
Apakah perintah ini berjalan di sini, dan apa hasilnya? | Status keluar perintah sendiri dan baris bukti hasil yang menyebut biner, cara penemuan, dan statusnya |
Apakah rilis terpasang ini melaporkan kemampuan sebagai tersedia? | Laporan |
Perintah lokal berhasil melaporkan apa yang berjalan pada mesin tersebut. Otomatisasi yang bergantung pada kemampuan produk terpasang juga harus mewajibkan laporan kemampuan.
Unggah Sumber Memerlukan Persetujuan
Dalam mode pelanggan default, server MCP stdio dalam paket menyembunyikan tiga aksi rencana yang dapat menyertakan file sumber. Ketiganya memerlukan kredensial lingkungan terpisah dan memakai klien Cloud. Rilis publik saat ini tidak menyediakan alur eksekusi jarak jauh lengkap untuk ketiganya.
Mode terpisah ALTI_MCP_MODE=local-xls menyediakan alat XLS lokal tetap tanpa penerusan Cloud. Operasi native ide cloud memakai proses masuk dan aturan unggah eksplisit sendiri; status aksi pelanggan yang hanya merencanakan tidak menjelaskan seluruh operasi workspace Cloud.
Persetujuan mengizinkan pengiriman; tidak mengubah aksi perencanaan saja menjadi eksekusi nyata atau membuat layanan jarak jauh tersedia.
Menangani Setiap Hasil Secara Terpisah
Saat mengotomatiskan CLI, tangani hasil ini sebagai status yang berbeda:
kemampuan lokal tersedia;
permintaan divalidasi;
rencana dikembalikan tanpa eksekusi;
pekerjaan diterima oleh otoritas yang diaktifkan secara eksplisit;
pekerjaan selesai dan menghasilkan bukti;
kemampuan atau otoritas tidak tersedia.
Menyatukan status ini ke dalam satu nilai sukses dapat membuat rencana atau pratinjau tampak seperti pekerjaan rekayasa yang selesai.
Memilih kontrak hasil yang tepat
Untuk eksekusi lokal, catat engine terpilih, digest input, status keluar native, dan hasil lengkap. Untuk mutasi file tersimpan, pertahankan rencana serta bukti penerapannya dan baca ulang file. Untuk tugas jarak jauh, ikuti ID-nya hingga status terminal, lalu ambil dan verifikasi hasil sebenarnya. Entri manifes aksi hanya menjelaskan antarmuka yang dapat dipanggil.
Pisahkan pembungkus permintaan engine lokal, aksi rencana pelanggan, dan tugas RTL Cloud tersimpan dalam otomatisasi. Ketiganya berbeda dalam skema input, lokasi sumber, autentikasi, pengiriman, dan penanganan hasil meskipun namanya mengandung “analyze” atau “evolve”.