Keberhasilan Pertama CLI
Evaluasi permintaan XLS kecil pada CPU, lalu opsional validasi pembungkus tugas offline dan batas sumber.
Ringkasan
Selesaikan verifikasi dan instalasi terlebih dahulu. Perintah di bawah memakai alti dari direktori PREFIX/bin terpasang. Jalankan sebagai pengguna biasa, bukan root.
Menjalankan Evaluasi XLS CPU Kecil
Permintaan ini menjumlahkan dua nilai 8 bit. Permintaan memakai engine XLS native yang dibatasi, tidak memerlukan toolchain Google, GPU, atau sesi Cloud, dan memperlihatkan overflow dalam hasil.
alti capabilities
alti xls eval --request - <<'JSON'
{
"schema": "altifigence.xls.operation-request.v1",
"operation": "eval",
"input_kind": "xls-ir",
"source": "package demo\ntop fn compute(x: bits[8], y: bits[8]) -> bits[8] { ret sum: bits[8] = add(x, y) }",
"top": "compute",
"backend": "cpu",
"vectors": [["255", "1"], ["0x10", "0b11"]]
}
JSON
Wajibkan kode keluar 0 dan hasil engine untuk kedua vektor: bits[8]:0x0 dan bits[8]:0x13. Ini hanya membuktikan bahwa input tersebut dievaluasi. Untuk dukungan bahasa DSLX yang lebih luas, gunakan jalur Google XLS.
Pemeriksaan Awal Tugas Offline Opsional
Alur kerja berikut membaca manifes aksi dan memvalidasi pembungkus tugas beserta satu file sumber lokal. Alur ini tidak membaca kredensial, menghubungi server, mengunggah sumber, mengirim pekerjaan, atau menjalankan engine RTL. Bukti hasilnya hanya menjelaskan validasi lokal; pengiriman dan kewenangan server tetap false.
1. Memeriksa Manifes Aksi yang Dikirim
alti commands
Perintah yang berhasil menulis satu larik JSON ke stdout dan tidak menulis apa pun ke stderr. Setiap entri berisi name, description, inputSchema, executes, dan class. CLI publik saat ini mengembalikan 25 entri. Nilai executes menjelaskan kontrak penerusan; perintah masih dapat memerlukan engine lokal, izin akun, atau layanan yang dihosting.
2. Menyiapkan Sumber Lokal Privat
Buat workspace privat dalam direktori kerja saat ini yang Anda miliki:
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"
Simpan sumber aman ini sebagai $ALTI_WORKSPACE/inputs/rtl/top.sv:
module top(input logic clock, output logic value);
always_ff @(posedge clock) value <= ~value;
endmodule
Jadikan sumber hanya dapat dibaca dan ditulis pemiliknya:
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"
Pemeriksaan awal menolak sumber yang berada di luar workspace, memiliki lebih dari satu tautan, bukan milik pengguna saat ini, atau dapat ditulis grup atau pengguna lain. Jangan melonggarkan pemeriksaan izin.
Simpan kode berikut sebagai $ALTI_WORKSPACE/job.json:
{
"schema": "altifigence.engine.job.v1",
"job_id": "offline-job-1",
"operation": {
"engine_id": "rtl-engine",
"operation_id": "analyze",
"contract_id": "rtl-analysis-request.v1"
},
"execution_placement": "cloud",
"device_preference": {
"selection": { "mode": "class", "value": "cpu" },
"fallback": "deny"
},
"resources": {
"cpu_slots": 1,
"memory_bytes": 536870912,
"device_slots": 0,
"device_memory_bytes": 0,
"max_wall_time_ms": 30000
},
"inputs": [
{
"artifact_id": "rtl-source-bundle",
"role": "source_bundle",
"artifact_schema": "rtl-source-bundle.v1",
"uri": "workspace://inputs/placeholder",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000"
}
],
"cancellation": { "cancellation_id": "cancel-offline-job-1" }
}
Klien mengganti URI placeholder dan digest dalam salinan validasi di memorinya dengan sumber relatif terhadap workspace yang dipilih dan SHA-256 yang dihitung.
3. Menghasilkan Bukti Hasil Offline
alti --json job validate \
--job "$ALTI_WORKSPACE/job.json" \
--workspace-root "$ALTI_WORKSPACE" \
--source rtl/top.sv
Hasil yang berhasil berupa satu objek JSON di stdout dengan kontrak berikut:
Kolom | Interpretasi yang wajib |
|---|---|
|
|
|
|
| Harus bernilai |
| Harus bernilai |
| Identitas pembungkus yang divalidasi secara lokal |
| Penempatan yang diminta dalam pembungkus, bukan bukti pengiriman |
| URI sumber relatif terhadap workspace yang dinormalisasi |
| Bukti sumber yang dihitung secara lokal |
Status keluar 0 hanya berarti pemeriksaan awal klien ini lulus. Ini tidak berarti sumber telah dikompilasi, server menerima tugas, atau pekerjaan apa pun berjalan.
Output Kegagalan dan Status Keluar
Dengan --json, kegagalan validasi tidak menulis bukti sukses ke stdout dan menulis satu objek altifigence.cli.error.v1 ke stderr. Misalnya, JSON tugas yang tidak valid menghasilkan ENGINE_JOB_JSON_INVALID dengan retryable: false dan keluar dengan status 1.
Untuk pemeriksaan manifes dan pemeriksaan awal offline:
Status keluar | Makna |
|---|---|
| Manifes dicetak, atau pemeriksaan awal klien offline lulus |
| Kegagalan registri, I/O, batas sumber, atau validasi tugas |
| Kegagalan sintaks baris perintah atau parsing argumen |
Perintah alti lain memakai status keluar yang tidak tercantum dalam tabel ini. 3 adalah CLASS_NOT_ALLOWED; 4 menandai permintaan yang ditolak sebelum penerusan, dan baik alti whoami dan alti login keluar dengan kode 4 dalam rilis ini; perintah yang didukung engine meneruskan status keluar engine itu sendiri, ditambah 126 ketika engine tidak dapat dimulai dan 127 ketika tidak ditemukan. Jika skrip Anda akan menjalankan lebih dari dua perintah di atas, gunakan kontrak lengkap dalam Referensi Perintah dan secara default anggap setiap status bukan nol sebagai kegagalan.
Pisahkan stdout dan stderr serta periksa status keluar sebelum mem-parsing bukti hasil. Gunakan halaman perintah engine dan Cloud untuk eksekusi atau pengiriman eksplisit; keduanya tidak terjadi sebagai efek samping pemeriksaan awal offline.
Memilih langkah berikutnya
Simpan hasil CPU dua vektor sebagai pemeriksaan instalasi cepat. Untuk mengevaluasi desain sendiri, ubah satu input pada satu waktu dan pertahankan permintaan serta hasil lengkap. Fitur bahasa yang lebih besar mungkin memerlukan jalur Google XLS terpisah; eksekusi CUDA memerlukan pemilihan backend eksplisit dan perangkat yang dapat digunakan.
Untuk pekerjaan RTL grafis, lanjutkan dengan eksekusi RTL pertama DDS. Untuk skrip, gunakan Perintah engine. Untuk file tersimpan jarak jauh, masuk menggunakan autentikasi Cloud native dan pilih organisasi/proyek yang benar.