Skip to main content

Mula menggunakan Raider

Gunakan halaman ini untuk menyediakan checkout, memulakan Raider, dan memilih cara kerja pertama: antara muka tab, Scala REPL, atau baris arahan. Arahan mengandaikan anda berada di akar repositori.

1. Sediakan Java dan bina​

Contoh Raider memerlukan JDK 21. Pasang agihan JDK 21, kemudian gantikan /path/to/jdk-21 di bawah dengan laluan pemasangan sebenar. Ini menetapkan Java untuk shell semasa dan meletakkan alatnya dahulu pada PATH:

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

Output versi sepatutnya mengenal pasti Java 21. Pasang sbt dan Python 3 juga; projek ini menyemat sbt 1.11.4 dan Scala 3.9.0. Bina classpath masa jalan dan bundel contoh sekali:

sh scripts/build/user-examples.sh

Skrip mencetak baris kejayaan yang menamakan artifacts/user-examples/classpath.txt dan task-summary.jar. Ia menulis log binaan penuh ke artifacts/user-examples/build.log. Biarkan shell ini terbuka dan muatkan classpath:

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

Jika terminal baharu dibuka kemudian, kembali ke akar repositori, tetapkan JAVA_HOME dan PATH sekali lagi, dan jalankan arahan RAIDER_CP=... di situ. Binaan itu sendiri tidak perlu diulang melainkan checkout berubah.

2. Pilih cara untuk bermula​

Antara muka tab​

Mulakan antara muka terminal dengan:

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

Ini bermula dengan bahagian belakang tiruan berskrip dan tidak membuat permintaan penyedia. Dalam antara muka tab, masukan disimpan sebagai draf; ia tidak menilai Scala. Cuba :help, kemudian :new notes, :tabs, dan :quit. Lihat panduan tab untuk arahan yang tersedia dan had semasa.

Scala REPL​

Untuk penilaian Scala, mulakan REPL tanpa --tabs:

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

Pada gesaan raider>, cuba Scala dan permintaan ejen berskrip:

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")

Tiga baris pertama dijalankan melalui pengkompil Scala. Balasan scout ialah teks tiruan yang tetap, bukan jawapan berdasarkan projek anda. Masukkan :help untuk arahan REPL dan :quit untuk keluar. Lebih banyak contoh ada dalam panduan REPL.

REPL yang disokong pengkompil juga menyokong :type <expression>, yang mengkompil ungkapan terhadap pengikatan semasa dan mencetak jenisnya tanpa menilainya. Sebagai contoh, :type scout("Review the parser") melaporkan AgentAsk[String]; ia tidak membuat permintaan penyedia. Pelengkapan Tab menggunakan pengikatan langsung pengkompil Scala. Dalam mod --tabs, taip :scrollback <tab> untuk menunjukkan baris peristiwa yang dikekalkan dan kiraan pengusiran, dan tekan Tab pada awalan arahan untuk membuka palet arahan. Draf shell tab kekal sebagai teks tempatan, bukan gesaan yang dihantar. Panduan TUI mendokumentasikan permukaan arahan dan had semasanya.

Mod tab juga mendedahkan fasa pelan baca sahaja: pelan yang dicadangkan dipaparkan dalam tab Plan sebelum pelaksanaan. Semak pelan itu, kemudian masukkan :approve untuk memulakan pelaksanaan sekali atau :reject untuk membatalkan fasa pelan yang langsung. Fasa pelan adalah baca sahaja mengikut pengelasan pemulihan alat; kelulusan ialah peralihan yang eksplisit kepada pelaksanaan. Korpus senario pelan yang berketentuan ialah lekapan penilaian luar talian, bukan dakwaan tentang kualiti model langsung. Lihat ADR-028 dan nota penilaian mod pelan.

Baris arahan​

CLI menjalankan tugas ejen tanpa gesaan interaktif. Laluan --out ialah direktori induk; Raider mencipta folder work-<id> di dalamnya. Tugas tiruan menggunakan respons yang tetap, jadi gunakannya untuk mempelajari bentuk arahan dan bukan untuk menjangka perubahan kod yang sebenar:

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

Arahan mencetak baris hasil dengan direktori kerja. Cari run.json dan summary.md di situ; apabila dihasilkan, transcript.json mengandungi jejak larian. coder terbina dalam mempunyai alat file dan proses. Gunakan ruang kerja yang boleh dibuang untuk tugas yang mungkin menyunting file.

Setiap larian tanpa kepala yang selesai menulis events.jsonl, jurnal peristiwa yang digunakan oleh raider resume. Diberi direktori kerja yang dicetak, jalankan:

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

Gantikan <id> dengan akhiran direktori sebenar; ini ialah laporan pemulihan baca sahaja, bukan penerusan. Ia melipat jurnal menjadi keadaan yang boleh diperhatikan dan melaporkan hash artifak tanpa memanggil model, alat, atau tulisan ruang kerja. Keluar 0 bermakna jurnal adalah konsisten (larian mungkin tamat atau terganggu); 26 bermakna awalan yang sah dipulihkan tetapi baris jurnal akhir tidak pasti; 21 bermakna penggunaan atau jurnal yang tidak boleh dibaca atau tiada; 20 bermakna awalan yang dipulihkan tidak dapat dilipat. Kekalkan direktori larian asal, termasuk sebarang ekor yang terkoyak. Resume membaca events.jsonl secara khusus; ia tidak mencari atau menyambung semula daripada file bernama segments.jsonl.

[]

3. Konfigurasikan model langsung ​

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

Panggilan langsung menghantar gesaan dan konteks tugas anda ke endpoint yang dikonfigurasi, dan mungkin dikenakan caj. Sumber menyokong penyedia serasi OpenAI dan serasi Anthropic. Konfigurasikan penyedia, endpoint, model, dan kelayakan dalam persekitaran shell peribadi. Sebagai contoh, tetapkan nilai bukan rahsia untuk perkhidmatan yang dipilih:

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

Jangan letakkan token dalam file ini, argumen arahan, atau URL endpoint. Bekalkan kelayakan menggunakan RAIDER_API_KEY persekitaran peribadi, atau halakan RAIDER_API_KEY_CMD ke pembantu kelayakan yang mencetak kunci pada baris stdout pertamanya:

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

Pembantu mempunyai had 10 saat. CLI menolak --api-key; jika kelayakan tidak dapat diselesaikan, panggilan CLI langsung gagal sebelum penghantaran. Untuk menggunakan Anthropic, tetapkan RAIDER_PROVIDER=anthropic dan konfigurasikan URL asas yang serasi serta modelnya. Untuk larian CLI, hantar endpoint dan model yang sama secara eksplisit:

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 membaca RAIDER_PROVIDER, RAIDER_BASE_URL, RAIDER_MODEL, dan kelayakan daripada persekitarannya. Penanda [scripted-fixture] bermakna respons ialah kandungan tiruan; jangan anggap ia sebagai keluaran model.

Pengangkutan serasi Anthropic menghantar takrif alat dengan name, description, dan input_schema; hasil alat dipulangkan sebagai blok teks berstruktur tool_result.content yang mengandungi hasil JSON yang dipaparkan. Ujian luar talian pendirian tempatan dan wayar silang meliputi pemetaan ini. Contoh pengenalan biasa kekal sebagai contoh tiruan atau penyedia yang dikonfigurasi; ia tidak membuat permintaan Anthropic langsung melainkan dikonfigurasi secara eksplisit.

Untuk larian CI, --require-provenance <manifest.json> menjadikan pengesahan provenans sebagai keperluan pra-semakan sebelum penghantaran. Larian yang berjaya menulis checks.junit.xml di samping artifak larian. Penolakan pra-semakan ialah kegagalan, bukan sandaran terus ke penyedia; rujuk penggunaan CI untuk butiran bundel yang dipercayai dan artifak.

4. Cuba tugas pengekodan​

Teruskan dengan membetulkan pepijat Scala. Contoh membekalkan projek berpepijat dan ujiannya, menjalankan ejen dalam salinan, dan menyemak hasil. Selepas itu, CLI pada projek sendiri boleh digunakan, atau aliran kerja CI tempatan boleh dibina.

Masalah persediaan biasa​

  • Java bukan versi 21: semak bahawa JAVA_HOME menunjuk ke pemasangan JDK dan $JAVA_HOME/bin berada dahulu pada PATH.
  • Binaan tidak dapat menyelesaikan kebergantungan: semak akses rangkaian, atau tetapkan COURSIER_CACHE kepada cache Coursier yang terisi dan jalankan semula binaan.
  • File classpath tiada: jalankan sh scripts/build/user-examples.sh daripada akar repositori dan periksa artifacts/user-examples/build.log.
  • CLI langsung melaporkan kelayakan tiada: semak bahawa persekitaran peribadi atau pembantu tersedia dalam shell ini. Jangan sekali-kali tampal token ke dalam arahan.
  • Penanda tiruan muncul: RAIDER_PROVIDER=mock telah dipilih, atau kelayakan langsung tidak dapat diselesaikan. Semak persediaan penyedia dan kelayakan sebelum mentafsir respons.