メインコンテンツへスキップ
開発中に実行または続行に DevTools の設定を渡すと、ローカルディレクトリの generations.jsonl に、実行ごとに1行の JSON が追記されます。各行には、実行の入力、ステップ、ツールの動き、出力、使用量、Gateway のリクエスト ID が入っています。有効にしない限り、何も記録されません。
Rust 0.2 には DevTools への記録機能がありません。run_with_events でライフサイクルフックを使い、イベントを自分で書き出してください。

環境変数で記録を有効にする

DevTools の設定がない場合、PHASEO_DEVTOOLS=true のときに記録が有効になります。ファイルは PHASEO_DEVTOOLS_DIR に、未設定の場合は作業ディレクトリの .phaseo-devtools に書き出されます。これは DevTools があるすべての言語で同じように動作します。

書き出される内容

各エントリーの type は、実行では agent.run、続行では agent.continue です。agent.continue はメソッド名ではなくエントリーの種類で、continueRun()(TypeScript、PHP、Java)、continue_run()(Python、Ruby)、Continue(Go)、ContinueRun(C#)の呼び出しが書き出すものです。 エントリーには、実行 ID とエージェント ID、ツールの数、そして実行結果全体(ステータス、メッセージ、モデル・プロバイダー・Gateway のリクエスト ID を含むステップ、ツールの動き、使用量、出力)が入っています。失敗した実行には、エラーを含むエントリーが書き出されます(Go と Java では error.message、TypeScript では構造化された失敗の詳細)。Java では書き込みエラーは無視されるため、記録が原因で実行が失敗することはありません。
エントリーには、プロンプト、メッセージ、アプリケーションのコンテキスト、ツールの入力と出力がプレーンテキストで入っています。このディレクトリはソース管理や本番のイメージに含めず、監査用のストアとしても使わないでください。本番環境のテレメトリーにはライフサイクルフックを使ってください。
最終更新日 2026年11月5日