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

Scala REPL チュートリアル

REPL を使って、Scala から Raider を調べます。エージェントのリクエストを試し、その答えを変換し、2 つのレビューを比較し、短い会話を続けます。下の例は、現在のソースチェックアウトと、組み込みの scout および worker バインディングを使います。

REPL を起動する​

リポジトリルートからユーザー向けの例をビルドし、モックモードでコンパイラ付き REPL を起動します。

sh scripts/build/user-examples.sh
RAIDER_CP=$(cat artifacts/user-examples/classpath.txt)
RAIDER_PROVIDER=mock java -cp "$RAIDER_CP" raider.repl.Main

raider> プロンプトで Scala を入力します。:reset を実行するまで、バインディングは後の入力でも有効です。複数行の定義は、空行で送信します。例を次に示します。

case class Check(name: String, passed: Boolean)
val checks = List(Check("compile", true), Check("tests", false))
checks.filterNot(_.passed).map(_.name)

最後の式は List("tests") に評価されます。実際のプロバイダを試すには、プロバイダのセットアップ に従い、REPL を起動する前に、エンドポイント、モデル、資格情報を非公開の環境へ設定してください。

使い捨てプロジェクトで Raider にコードを変更させ、確認させるには、オフラインの請求修復 に従ってください。スクリプト化されたスタンドと、独立した Scala のコンパイルおよびテストのコマンドを使います。上の短いモック REPL のリクエストは、ファイルを変更しません。

リクエストを 1 つ作る​

すぐに実行すべきリクエストには、ask を呼び出します。

scout.ask("Explain what a failed test means in one sentence")

呼び出しは、アシスタントの答えを String として返します。モックモードでは、答えは固定されたスクリプトのテキストであり、プロジェクトは検査しません。設定済みのライブプロバイダは、代わりにその応答を返します。

[]

遅延 ask を用意し、その結果を map する ​

{#prepare-a-lazy-ask-then-map-its-result}

scout(prompt) を呼び出すと、リクエストを送出せずに AgentAsk[String] が作られます。:type で中身を調べ、答えが必要なときに .run() を呼び出します。.map は最終的な答えを変換し、ask を遅延のまま保ちます。

val ask = scout("Summarize the parser entry point")
:type ask

val answer: String = ask.run()
val answerLength = scout("Summarize the parser entry point").map(_.length)
:type answerLength
val length: Int = answerLength.run()

型の照会は AgentAsk[String] と AgentAsk[Int] を報告します。どちらの .run() 呼び出しもリクエストを実行します。map された方は、答えの文字数を返します。:type は式をコンパイルしますが、評価はしません。この例の実行可能な版は 02lazy-map.repl です。

レビューとテスト計画を並列に依頼する​

2 つの遅延 ask を作り、map で結果にラベルを付けます。all(...).run() は、両方の結果をタプルとして返します。

val code = "if subtotalCents > 10000 then 1000 else 0"
val policy = "A 1000-cent discount applies at 10000 cents and above."

val reviewAsk = scout(
s"$policy Review this expression: $code. Give one boundary counterexample. Do not use tools."
).map(answer => ("review", answer))

val testAsk = worker(
s"$policy Return expected [subtotalCents, discountCents] pairs for " +
"9999, 10000, and 10001. Return only JSON; do not use tools."
).map(answer => ("tests", answer))

val (review, testPlan) = all(reviewAsk, testAsk).run()
review._1 // "review"
testPlan._1 // "tests"

タプルのラベルは、どの答えがどのリクエストに属するかを示します。モックモードでは、答えの文字列は固定されたフィクスチャの応答です。この例が示すのは Scala の組み合わせであり、レビューの品質ではありません。より完全なプロンプトと応答の確認は、請求レビューのフィクスチャ にあります。

上限付きバッチで複数の項目をレビューする​

各入力が独自の ask を必要とするときは、batch(inputs, parallelism)(f) を使います。結果は入力の順に返り、同時実行数は要求した数を超えません。

val areas = List("boundary", "integer cents", "test coverage")
val notes = batch(areas, parallelism = 2) { area =>
scout(s"Review $area in this expression: $code. Give one observation; do not use tools.")
.map(answer => area -> answer)
}.run()

notes.map(_._1) // List("boundary", "integer cents", "test coverage")

各結果は、入力ラベルと応答を含む (String, String) の組です。バッチのフィクスチャ は、スクリプト化されたプロバイダを使って、順序が保たれた結果を示します。

バックグラウンドジョブを実行する​

.start(prompt) を使うと、すぐにジョブハンドルが得られます。await はその結果を返します。同じ完了結果を見るために、再度呼び出せます。cancel() はキャンセルを要求し、ジョブがすでに終了していれば false を返します。

val job = worker.start("Review the parser for an empty-input bug. Do not use tools.")
job.id
val result = job.await

ファサードのジョブとその ID を一覧するには、:jobs を使います。ID でキャンセルするには :cancel <id> と入力します。ジョブのトレースを調べるには :log <id> を使います。キャンセルは、すでに起きた外部の効果を取り消せません。バックグラウンドジョブのフィクスチャ を参照してください。

会話をメモリに保持する​

openSession(agent) は Chat を作ります。成功した各 ask は、ユーザーメッセージとアシスタントの返信を追加します。次の ask は、その会話履歴を受け取ります。

val chat = openSession(worker)
val first = chat.ask("Review this parser: def parsePort(raw: String): Int = raw.toInt")
val second = chat.ask("What happens for an empty string?")
chat.messages.size // 4: two user messages and two replies

履歴は、現在の REPL プロセス内にあるこの Chat オブジェクトに属します。プロセスをまたいでは保存されず、Chat に close() メソッドはありません。モックの返信は固定テキストであり、モデルが前のターンを使ったことを示すものではありません。セッションのフィクスチャ は、スクリプト化された場合を示します。

andThen で型付きステージを接続する​

Program[I, O] は、入力型 I から出力型 O へのステージを表します。andThen は、最初の出力型が次の入力型と一致するときにステージをつなぎます。合成したプログラムを適用すると Task が作られます。ランナーがそのタスクを解釈します。

import raider.core.{Program, Task}

val parseCount: Program[String, Int] =
Program.fromFunction("parse-count")(text => Task.succeed(text.toInt))
val describeCount: Program[Int, String] =
Program.fromFunction("describe-count")(count => Task.succeed(s"count=$count"))
val describeInput: Program[String, String] = parseCount.andThen(describeCount)
val pending: Task[String] = describeInput("3")

この純粋な Scala のパイプラインは、モデルへのリクエストを行いません。実行可能な型付きワークフローについては、TaskSummary.scala と 型付きバンドルのウォークスルー を参照してください。2 つの Program ステージを合成し、バンドルランナーを通して実行します。

REPL では、:help がコマンドを一覧します。現在のコンソールは、:type <expression>、:jobs、:cancel <id>、:log <id>、:reset、:quit(:q と :exit も)をサポートします。:session コマンドはありません。Scala では openSession を使ってください。JobHandle.send(message) は現在 CapabilityUnsupported を投げるため、実行中のジョブをこのファサードから操作することはできません。

エージェントとツールのコードは、Raider プロセスの権限で実行されます。ツールの方針は、エージェントランタイムを通る呼び出しに適用されます。REPL に入力した任意の Scala に対するサンドボックスではありません。

ここでの DSL の例は、REPL を通して実行されます。生成されたリネージ投影は、記録された構造の記述であり、再生ではありません。ライブの CI ルートと、別に生成された統合投影との区別については、リネージのウォークスルー を参照してください。