メインコンテンツまでスキップ

Raider を使い始める

このページでは、チェックアウトを用意し、Raider を起動し、最初の作業のしかたを選びます。タブインターフェース、Scala REPL、またはコマンドラインです。コマンドは、リポジトリのルートにいることを前提とします。

1. Java の用意とビルド​

Raider の例には JDK 21 が必要です。JDK 21 のディストリビューションをインストールし、下の /path/to/jdk-21 を実際のインストールパスに置き換えてください。これは現在のシェルに Java を設定し、そのツールを PATH の先頭に置きます。

export JAVA_HOME="/path/to/jdk-21"
export PATH="$JAVA_HOME/bin:$PATH"
java -version

バージョン出力は Java 21 を示しているはずです。sbt と Python 3 もインストールしてください。プロジェクトは sbt 1.11.4 と Scala 3.9.0 を固定しています。ランタイムクラスパスと例のバンドルを、一度ビルドします。

sh scripts/build/user-examples.sh

スクリプトは、artifacts/user-examples/classpath.txt と task-summary.jar を示す成功行を出力します。ビルドログ全体は artifacts/user-examples/build.log に書き出します。このシェルを開いたまま、クラスパスを読み込みます。

RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)

あとで新しいターミナルを開いた場合は、リポジトリのルートに戻り、JAVA_HOME と PATH を再度設定し、そこで RAIDER_CP=... コマンドを実行してください。チェックアウトが変わらない限り、ビルド自体を繰り返す必要はありません。

2. 起動方法を選ぶ​

タブインターフェース​

ターミナルインターフェースを、次で起動します。

RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main --tabs

これはスクリプト化されたモックバックエンドで起動し、プロバイダへのリクエストは行いません。タブインターフェースでは、入力は下書きとして保存され、Scala は評価されません。:help、続いて :new notes、:tabs、:quit を試してください。使えるコマンドと現在の制限は、タブガイドを参照してください。

Scala REPL​

Scala を評価するには、--tabs なしで REPL を起動します。

RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main

raider> プロンプトで、Scala と、スクリプト化されたエージェントリクエストを試します。

case class Check(name: String, passed: Boolean)
val checks = List(Check("compile", true), Check("tests", false))
checks.filterNot(_.passed).map(_.name)
scout.ask("Explain what a failed check means in one sentence")

最初の 3 行は Scala コンパイラを通ります。scout の返答は固定のモックテキストであり、あなたのプロジェクトに基づく回答ではありません。REPL のコマンドは :help、終了は :quit です。さらなる例は REPL ガイドにあります。

コンパイラを使う REPL は :type <expression> もサポートします。これは式を現在のバインディングに対してコンパイルし、評価せずにその型を出力します。たとえば、:type scout("Review the parser") は AgentAsk[String] を報告します。プロバイダへのリクエストは行いません。Tab 補完は、Scala コンパイラのライブなバインディングを使います。--tabs モードでは、:scrollback <tab> と入力すると、保持されているイベント行と退避件数が表示されます。コマンドの接頭辞の上で Tab を押すと、コマンドパレットが開きます。タブシェルの下書きはローカルのテキストのままで、送信されたプロンプトではありません。コマンドの面と現在の制限は、TUI ガイドに書かれています。

タブモードは、読み取り専用のプランフェーズも出します。提案されたプランは、実行の前に Plan タブへ表示されます。それを確認し、:approve で実行を一度開始するか、:reject で進行中のプランフェーズを取り消します。プランフェーズは、ツール回復の分類により読み取り専用です。承認は、実行への明示的な遷移です。決定的なプランシナリオのコーパスは、オフライン評価のフィクスチャであり、ライブのモデル品質を主張するものではありません。ADR-028とプランモードの評価ノートを参照してください。

コマンドライン​

CLI は、対話プロンプトなしでエージェントのタスクを実行します。--out のパスは親ディレクトリです。Raider はその中に work-<id> フォルダを作ります。モックのタスクは固定の応答を使うので、実際のコード変更を期待するのではなく、コマンドの形を学ぶために使ってください。

java -cp "$RAIDER_CP" raider.cli.Main run \
--agent coder --provider mock \
--input "Read README.md and summarize the project" \
--workspace . --out artifacts/first-run

コマンドは、作業ディレクトリを含む結果の行を出力します。そこにある run.json と summary.md を見てください。生成されている場合、transcript.json に実行のトレースが入っています。組み込みの coder は、ファイルとプロセスのツールを持ちます。ファイルを編集する可能性があるタスクには、使い捨てのワークスペースを使ってください。

完了したヘッドレス実行は、それぞれ events.jsonl を書き出します。これは raider resume が使うイベントジャーナルです。出力された作業ディレクトリがあれば、次を実行します。

RUN_DIR='artifacts/first-run/work-<id>' # Replace <id> with the printed directory name.
java -cp "$RAIDER_CP" raider.cli.Main resume "$RUN_DIR"

<id> を、実際のディレクトリの接尾辞に置き換えてください。これは読み取り専用の回復レポートであり、続きの実行ではありません。ジャーナルを、観測できる状態へまとめ、モデル、ツール、ワークスペースへの書き込みを起動せずに、アーティファクトのハッシュを報告します。終了コード 0 は、ジャーナルが一貫していることを意味します(実行は終了していても、中断していてもかまいません)。26 は、有効な接頭辞は回復できたものの、最後のジャーナル行が不確かであることを意味します。21 は、使い方の誤り、または読み取れないか存在しないジャーナルを意味します。20 は、回復した接頭辞をまとめられなかったことを意味します。途切れた末尾も含め、元の実行ディレクトリを残してください。resume コマンドが読むのは、具体的に events.jsonl です。segments.jsonl という名前のファイルを探したり、そこから再開したりはしません。

[]

3. ライブのモデルを設定する ​

{#3-configure-a-live-model}

ライブの呼び出しは、プロンプトとタスクのコンテキストを、設定したエンドポイントへ送り、料金が発生することがあります。ソースは、OpenAI 互換と Anthropic 互換のプロバイダをサポートします。プロバイダ、エンドポイント、モデル、資格情報を、プライベートなシェル環境で設定してください。たとえば、選んだサービスについて、シークレットではない値を設定します。

export RAIDER_PROVIDER=openai
export RAIDER_BASE_URL="https://your-provider.example/v1"
export RAIDER_MODEL="your-model-name"

トークンを、このファイル、コマンド引数、またはエンドポイントの URL に入れないでください。プライベート環境の RAIDER_API_KEY で資格情報を渡すか、RAIDER_API_KEY_CMD を、最初の標準出力行にキーを出力する資格情報ヘルパーへ向けてください。

export RAIDER_API_KEY_CMD="/path/to/credential-helper"

ヘルパーには 10 秒の制限があります。CLI は --api-key を拒否します。資格情報を解決できない場合、ライブの CLI 呼び出しは、ディスパッチの前に失敗します。Anthropic を使うには、RAIDER_PROVIDER=anthropic を設定し、その互換ベース URL とモデルを設定します。CLI の実行では、同じエンドポイントとモデルを明示的に渡します。

java -cp "$RAIDER_CP" raider.cli.Main run \
--agent coder --provider "$RAIDER_PROVIDER" \
--base-url "$RAIDER_BASE_URL" --model "$RAIDER_MODEL" \
--input "Read README.md and summarize the project" \
--workspace . --out artifacts/model-run

REPL は、環境から RAIDER_PROVIDER、RAIDER_BASE_URL、RAIDER_MODEL、および資格情報を読みます。[scripted-fixture] マーカーは、応答がモックの内容であることを意味します。モデルの出力として扱わないでください。

Anthropic 互換のトランスポートは、ツール定義を name、description、input_schema 付きで送ります。ツールの結果は、レンダリングされた JSON 結果を含む、構造化された tool_result.content のテキストブロックとして返されます。オフラインのローカルスタンドとクロスワイヤのテストが、この対応をカバーします。通常のオンボーディング例は、モック、または設定済みプロバイダの例のままです。明示的に設定しない限り、ライブの Anthropic リクエストは行いません。

CI の実行では、--require-provenance <manifest.json> により、ディスパッチ前のプリフライト要件として来歴の検証が行われます。成功した実行は、実行のアーティファクトと並べて checks.junit.xml を書き出します。プリフライトの拒否は失敗であり、プロバイダへ直接戻るフォールバックではありません。信頼されたバンドルとアーティファクトの詳細は、CI の使い方を参照してください。

4. コーディングタスクを試す​

続けて、Scala のバグを直すに進みます。例は、バグのあるプロジェクトとそのテストを用意し、コピーの上でエージェントを実行し、結果を確認します。その後は、自分のプロジェクトで CLI を使うか、ローカル CI のワークフローを組み立てられます。

よくあるセットアップの問題​

  • Java がバージョン 21 ではない: JAVA_HOME が JDK のインストールを指していること、および $JAVA_HOME/bin が PATH の先頭にあることを確認します。
  • ビルドが依存関係を解決できない: ネットワークアクセスを確認するか、COURSIER_CACHE を中身のある Coursier キャッシュに設定して、ビルドを再実行します。
  • クラスパスのファイルがない: リポジトリのルートから sh scripts/build/user-examples.sh を実行し、artifacts/user-examples/build.log を調べます。
  • ライブの CLI が資格情報の欠落を報告する: このシェルで、プライベート環境またはヘルパーが使えることを確認します。トークンをコマンドへ貼り付けないでください。
  • モックのマーカーが出る: RAIDER_PROVIDER=mock が選ばれているか、ライブの資格情報を解決できませんでした。応答を解釈する前に、プロバイダと資格情報の設定を確認します。