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.

Bash
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

Bash
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:

Bash
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:

SystemVerilog
module top(input logic clock, output logic value);
    always_ff @(posedge clock) value <= ~value;
endmodule

Jadikan sumber hanya dapat dibaca dan ditulis pemiliknya:

Bash
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:

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

Bash
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

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

Harus bernilai false

server_authority_verified

Harus bernilai false

job_schema, job_id, operation

Identitas pembungkus yang divalidasi secara lokal

execution_placement

Penempatan yang diminta dalam pembungkus, bukan bukti pengiriman

source.workspace_uri

URI sumber relatif terhadap workspace yang dinormalisasi

source.sha256, source.size_bytes

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

0

Manifes dicetak, atau pemeriksaan awal klien offline lulus

1

Kegagalan registri, I/O, batas sumber, atau validasi tugas

2

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.