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 の組み合わせであり、レビューの品質ではありません。より完全なプロンプトと応答の確認は、請求レビューのフィクスチャ にあります。