Skip to main content

Jalankan aliran kerja pengekodan Scala dalam CI tempatan

Gunakan contoh ini untuk melihat Raider membaiki pepijat Scala yang kecil, mengesahkan perubahan, dan menghasilkan keputusan yang boleh dibaca mesin. Diskaun lekapan sepatutnya terpakai pada 10,000 sen atau lebih. Kod asalnya menggunakan perbandingan > yang ketat, jadi kes ambang tepat gagal.

Aplikasi ialah BillingCi.scala. Ia menyalin lekapan ke dalam direktori keluaran yang baharu, menjalankan semakan garis dasar, meminta ejen membaiki pepijat, menjalankan semakan pengkompil dan ujian yang bebas, mengumpulkan dua semakan sumber dan tiga semakan sempadan, dan menulis READY atau BLOCKED.

Semakan menggunakan 9,999, 10,000, dan 10,001 sen untuk meliputi kedua-dua belah ambang dan sempadan tepat. Aplikasi menyemak kod keluar dan keluaran pengkompil/ujian, kemudian mengesahkan jawapan semakan sebelum menulis READY.

Sediakan dan jalankan​

JDK 21, sbt, dan penyedia serasi OpenAI yang dikonfigurasi diperlukan. Pasang jq untuk arahan pemeriksaan hasil di bawah; lihat persediaan jika Raider belum dibina sebelum ini. Contoh memerlukan model glm-5.3-flash. Konfigurasikan RAIDER_BASE_URL dan sama ada RAIDER_API_KEY atau RAIDER_API_KEY_CMD menggunakan persekitaran peribadi atau pembantu kelayakan. Jangan letakkan kelayakan dalam file sumber atau argumen arahan.

Bina contoh dan classpath masa jalannya:

sh scripts/build/user-ci.sh

Tetapkan nilai bukan rahsia yang diperlukan dan ikut serta untuk panggilan penyedia:

export RAIDER_PROVIDER=openai
export RAIDER_MODEL=glm-5.3-flash
export RAIDER_LIVE_APPROVED=1

Sekarang pilih direktori keluaran yang baharu dan lancarkan aliran kerja:

RUN_DIR="artifacts/user-ci/run-$(date +%Y%m%d-%H%M%S)"
java -cp "$(cat artifacts/user-ci/classpath.txt)" demo.BillingCi \
"$(cat artifacts/user-ci/runtime-classpath.txt)" \
"$RUN_DIR" \
examples/user-guide/fixture

Argumen ialah classpath masa jalan yang digunakan oleh penyemak Scala, direktori keluaran, dan direktori lekapan. Projek yang disalin berada di $RUN_DIR/workspace.

Binaan mencipta artifacts/user-ci/classpath.txt untuk contoh dan artifacts/user-ci/runtime-classpath.txt untuk proses pengkompil dan ujian. Kekalkan file itu di tempatnya antara binaan dan pelancaran. Direktori keluaran adalah berasingan, jadi larian kemudian mendapat indeks, log, ruang kerja, dan direktori larian natif yang baharu.

Arahan ini membuat panggilan model langsung dan mungkin dikenakan kos. Ia bukan larian kering. Aliran kerja mempunyai had masa keseluruhan lima minit; setiap satu daripada enam larian ejen mempunyai had masa 120 saat. Setiap larian mempunyai had percubaan sendiri, jadi had ini tidak membentuk had permintaan atau kos yang dikongsi.

Ejen pengekodan berjalan dengan kebenaran proses dan registri alat yang dikonfigurasi untuk Raider. Gesaan semakan tidak meminta alat, dan aplikasi menyemak panggilan alat selepas itu; semakan itu bukan kotak pasir. Jalankan ini hanya dengan ruang kerja dan konfigurasi penyedia yang dipercayai.

[]

Fahami hasil ​

{#understand-the-result}

Larian yang berjaya keluar 0 dan menulis READY ke decision.json, dengan status talian paip SUCCEEDED dalam pipeline-index.json. READY bermakna garis dasar dikompil dan gagal hanya pada ambang, pembaikan mengubah sumber, kompil akhir yang bebas dan ujian lulus, kedua-dua semakan sumber lulus pengesahan, dan ketiga-tiga semakan sempadan lulus.

Larian yang disekat atau gagal biasanya keluar 1. Jika had masa keseluruhan tamat, indeks ditandakan UNKNOWN dan proses keluar 24; sesetengah peringkat mungkin tidak lengkap. Jawapan ejen semata-mata tidak menetapkan kejayaan: aplikasi menyemak kod keluar proses sebenar dan mengesahkan hasil semakan berstruktur.

Contoh berjaya yang direkodkan mengandungi keputusan ini:

{"verdict":"READY","repairCheckExit":0,"sourceChanged":true,"reviewPasses":2,"boundaryPasses":3,"requiredBoundaryCases":[9999,10000,10001],"detail":"Independent compile and all three expected-discount reviews passed."}

Ini ialah tangkapan sejarah, bukan hasil larian baharu pada mesin anda. Ia direkodkan melalui gerbang pelan pengekodan Yabanin dengan model yang diminta glm-5.3-flash. Lihat larian enam akar yang ditangkap dan unjuran Scala natif yang lengkap.

Dalam larian anda sendiri, bandingkan decision.json dengan status peringkat dalam pipeline-index.json. Keputusan READY sepatutnya sepadan dengan peringkat semakan akhir yang berjaya dan semakan yang berjaya. Jika tidak sepadan, gunakan run.json natif peringkat dan ringkasan untuk memahami sama ada ia gagal sebelum menghasilkan artifak yang lengkap.

Cari file peringkat​

Direktori keluaran mengandungi:

  • decision.json: keputusan aplikasi berjenis.
  • pipeline-index.json: status peringkat dan pautan ke setiap larian natif.
  • baseline-check.log dan final-independent-check.log: keluaran proses pengkompil/ujian.
  • workspace/: lekapan yang disalin, termasuk sumber yang dibaiki apabila larian berjaya.
  • stages/<stage>/native/work-<id>/: file larian natif sesuatu peringkat, seperti run.json, events.jsonl, summary.md, dan, apabila tersedia, lineage.scala dan lineage-data.json.

ID larian ditetapkan pada masa pelaksanaan. Baca nativeWorkDir peringkat pembaikan daripada indeks dan bukan dengan meneka:

jq '{status, decision, stages}' "$RUN_DIR/pipeline-index.json"
STAGE_DIR=$(jq -r '.stages[] | select(.name == "repair") | .nativeWorkDir' \
"$RUN_DIR/pipeline-index.json")
cat "$RUN_DIR/$STAGE_DIR/summary.md"
cat "$RUN_DIR/$STAGE_DIR/lineage.scala"

Untuk menyenaraikan hanya nama peringkat, status, kod keluar, dan direktori artifak:

jq -r '.stages[] | [.name, .status, (.nativeExitCode // "-"), (.nativeWorkDir // "-")] | @tsv' \
"$RUN_DIR/pipeline-index.json"

Komposisi Scala dalam contoh​

Aplikasi membina nilai Program berjenis dan menggubahnya dengan DSL semasa Raider. Petikan ini menggunakan nama pemboleh ubah sebenar contoh; ia tidak menyertakan persediaan di sekitar pernyataan ini:

repairProgram = agentProgram("billing-repair")
verifyProgram = Program.fromFunction[AgentOutput, VerifiedRepair]("verify-repair") { attempt =>
Task(ZIO.attemptBlocking {
val evidence = validateRepair(setup, attempt)
VerifiedRepair(evidence.sourceChanged, readUtf8(setup.source), attempt)
}.mapError(error => RaiderError.OutputValidation(
Option(error.getMessage).getOrElse("repair verification failed")
)))
}
repairAndVerify = repairProgram.andThen(verifyProgram)
repaired <- Task.zio(repairAndVerify(repairInput))

reviews <- Task.zio(all(
reviewProgram(reviewsInput._1),
reviewProgram(reviewsInput._2)
))

boundaryOutcomes <- Task.zio(batch.collect(boundaryInputs, parallelism = 2) { input =>
boundaryProgram(input)
})

Gubahan pertama menyemak percubaan pembaikan sebenar sebelum menghantar hasil yang disahkan ke hadapan. all menjalankan dua semakan bersama-sama. batch.collect memproses tiga masukan sempadan dengan paling banyak dua yang aktif serentak dan memulangkan hasilnya mengikut urutan masukan. Aplikasi mengesahkan hasil dan mencipta keputusan hanya selepas semakan itu.

Aplikasi penuh juga mentakrifkan data masukan/keluaran bagi setiap peringkat, menulis gesaan dan rekod peringkat, dan merekodkan kegagalan. Petikan menunjukkan gubahan utama sahaja; gunakan sumber Scala yang dipautkan untuk program lengkap yang boleh dijalankan.

Selesaikan masalah​

  • Binaan menyatakan JDK 21 diperlukan: halakan JAVA_HOME ke pemasangan JDK 21 dan jalankan semula sh scripts/build/user-ci.sh.
  • Nama persekitaran tiada atau model tidak sah: konfigurasikan endpoint peribadi dan pembantu kelayakan, tetapkan nilai yang diperlukan di atas, dan sahkan model adalah tepat glm-5.3-flash. Program menolak nama model lain.
  • Ralat penyedia atau endpoint: semak bahawa URL asas yang dikonfigurasi ialah URL HTTP(S) tanpa kelayakan yang terbenam, query, atau fragmen, dan bahawa penyedia menerima kunci yang dikonfigurasi. Jauhkan nilai rahsia daripada log dan laporan.
  • Keluar 1 atau BLOCKED: periksa decision.json, status peringkat dalam pipeline-index.json, kemudian summary.md dan transkrip peringkat yang berkaitan. Bandingkan baseline-check.log dan final-independent-check.log; garis dasar dijangka melaporkan hanya FAIL exact-threshold, manakala semakan akhir sepatutnya melaporkan DiscountSpec: PASS 3 boundaries.
  • Keluar 24: had masa keseluruhan telah luput. Indeks mungkin menyatakan UNKNOWN; periksa artifak peringkat yang selesai sebelum memutuskan langkah seterusnya.

Jika larian natif mempunyai summary.md tetapi tiada file garis susur, gunakan ringkasan dan aliran peristiwa dahulu; file garis susur tersedia hanya apabila larian selesai dan peristiwanya dapat dikurangkan.

[]

Garis susur natif dan paparan bersatu ​

{#native-lineage-and-the-unified-view}

Aplikasi langsung ini melancarkan enam larian ejen yang bebas: satu pembaikan, dua semakan, dan tiga semakan sempadan. Setiap satu menulis akar natif dan grafnya sendiri; pipeline-index.json memautkan akar tersebut. Unjuran Scala bersatu yang berasingan menerangkan jenis talian paip yang sama sebagai satu graf delegasi. Ia dijana daripada contoh luar talian; ia bukan keluaran aplikasi langsung ini. Ia ialah perihalan larian kering: ia tidak menghantar sebarang model atau alat dan bukan arahan main semula. Unjuran bersatu semasa yang penuh tersedia dalam file yang dipautkan itu; unjuran sejarah yang penuh daripada enam akar langsung dipautkan di atas.