CLI で最初の成功を確認する

小さな XLS 要求を CPU で評価し、必要に応じてオフラインのジョブエンベロープとソースの境界を検証します。

概要

まず 検証 と インストール を完了してください。以下のコマンドは、インストール済みの alti を、PREFIX/bin ディレクトリから使用します。root ではなく通常のユーザーとして実行してください。

小さな CPU XLS 評価を実行

この要求は 2 つの 8 ビット値を加算します。範囲を限定したネイティブ XLS エンジンを使い、Google ツールチェーン、GPU、Cloud セッションは不要です。オーバーフローを結果で確認できます。

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

終了コード 0 と、両ベクトルのエンジン結果 bits[8]:0x0 および bits[8]:0x13 を必須としてください。これは、この入力を評価したことだけを証明します。より広い DSLX 言語対応には、独立した Google XLS の経路 を使用してください。

任意のオフラインジョブ事前検査

以下のワークフローはアクションマニフェストを読み、ジョブエンベロープとローカルソースファイル 1 件を検証します。認証情報の読み取り、サーバーへの接続、ソースのアップロード、作業送信、RTL エンジン実行は行いません。レシートはローカル検証だけを記述し、送信とサーバーの権限主体は false のままです。

1. 同梱アクションマニフェストを確認

Bash
alti commands

成功すると、stdout に JSON 配列 1 つを書き、stderr には何も書きません。各エントリは name, description, inputSchema, executes と class を含みます。現在の公開 CLI は 25 エントリを返します。executes の値は処理契約を示しますが、コマンドにはローカルエンジン、アカウント権限、ホストされたサービスが必要な場合があります。

2. 非公開のローカルソースを準備

現在のユーザー所有の作業ディレクトリに非公開のワークスペースを作成します:

Bash
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"

この無害なソースを $ALTI_WORKSPACE/inputs/rtl/top.sv として保存します:

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

ソースの読み書きを所有者だけに許可します:

Bash
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"

事前検査は、ワークスペース外、ハードリンクが複数、現在のユーザーが所有していない、グループや他のユーザーが書き込み可能なソースを拒否します。権限検査を緩めないでください。

以下を $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" }
}

クライアントは、メモリ内の検証用コピーでプレースホルダーの URI とダイジェストを、選択したワークスペース相対ソースと計算した SHA-256 に置き換えます。

3. オフラインレシートを生成

Bash
alti --json job validate \
  --job "$ALTI_WORKSPACE/job.json" \
  --workspace-root "$ALTI_WORKSPACE" \
  --source rtl/top.sv

成功した結果は stdout の JSON オブジェクト 1 つで、次の契約を持ちます:

フィールド

必要な解釈

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

次でなければならない:false

server_authority_verified

次でなければならない:false

job_schema, job_id, operation

ローカルで検証したエンベロープの識別情報

execution_placement

エンベロープで要求された配置であり、送信の証拠ではない

source.workspace_uri

正規化されたワークスペース相対のソース URI

source.sha256, source.size_bytes

ローカルで計算したソースの根拠

終了状態 0 は、このクライアント事前検査に合格したことだけを意味します。ソースのコンパイル、サーバーによるジョブ受理、何らかの作業実行を意味しません。

失敗出力と終了状態

次を指定した場合:--json、検証失敗時に stdout へ成功レシートを書かず、stderr に altifigence.cli.error.v1 オブジェクト 1 つを書きます。例えば、不正なジョブ JSON は ENGINE_JOB_JSON_INVALID を生成し、retryable: false を伴って終了状態 1 で終了します。

マニフェストの確認とオフライン事前検査:

終了状態

意味

0

マニフェストを表示した、またはオフラインのクライアント事前検査に合格した

1

レジストリ、I/O、ソース境界、ジョブ検証の失敗

2

コマンドライン構文や引数解析の失敗

その他の alti コマンドは、この表にない終了状態を使います。3 は CLASS_NOT_ALLOWED、4 は処理を渡す前の要求拒否を示し、alti whoami と alti login はこのリリースでどちらも 4 で終了します。エンジンに基づくコマンドはエンジン自身の終了状態をそのまま返し、エンジンを開始できない場合は 126、見つからない場合は 127 を追加します。スクリプトが上記 2 コマンド以外も実行する場合、コマンドリファレンス の完全な契約を使用し、既定ではすべての非 0 状態を失敗として扱ってください。

stdout と stderr を分け、レシートを解析する前に終了状態を確認します。明示的な実行・送信にはエンジンと Cloud コマンドのページを使ってください。オフライン事前検査の副作用として、それらは発生しません。

次の手順を選ぶ

2 ベクトルの CPU 結果を簡単なインストール確認として保持します。自身の設計を評価するときは、入力を 1 つずつ変更し、完全な要求と結果を保持します。より大きな言語機能には独立した Google XLS 経路が必要な場合があります。CUDA 実行には明示的なバックエンド選択と使用可能なデバイスが必要です。

グラフィカルな RTL 作業は DDS の最初の RTL 実行 に進みます。スクリプトには エンジンコマンド を使います。リモートの保存済みファイルには ネイティブ Cloud 認証 でサインインし、正しい組織・プロジェクトを選択します。