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.logdanfinal-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, sepertirun.json,events.jsonl,summary.md, dan, apabila tersedia,lineage.scaladanlineage-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_HOMEke pemasangan JDK 21 dan jalankan semulash 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
1atauBLOCKED: periksadecision.json, status peringkat dalampipeline-index.json, kemudiansummary.mddan transkrip peringkat yang berkaitan. Bandingkanbaseline-check.logdanfinal-independent-check.log; garis dasar dijangka melaporkan hanyaFAIL exact-threshold, manakala semakan akhir sepatutnya melaporkanDiscountSpec: PASS 3 boundaries. - Keluar
24: had masa keseluruhan telah luput. Indeks mungkin menyatakanUNKNOWN; 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.