設定リファレンス

このリファレンスでは、ユーザーが設定できる項目、その型、デフォルト値、用途を示します。プロジェクト設定はエージェントディレクトリの設定を上書きします。リソースのリストは結合されます。ファイルの場所と信頼の動作については、設定を参照してください。

モデルと思考#

キャッシュウォーミングは、モデルがキャッシュの有効期間を宣言し、キャッシュミスの回避によって少なくとも $0.05 のコストを削減できると Pi が見積もった場合にのみ実行されます。更新の使用量はセッション合計に算入されますが、モデルのコンテキストには入りません。/session には次の判断が表示されます。拡張機能は cache_warming_decision でその判断を上書きできます。プロンプトキャッシュの有効期間を参照してください。

モデルの選択と思考の制御については、モデルの選択を参照してください。

操作#

ツール#

利用可能な組み込みツールは、read、bash、powershell、edit、write、grep、find、ls です。defaultTools には、組み込み拡張機能によって非アクティブとして登録される codemode と tool_search、および非アクティブとして登録されるその他の拡張機能ツールも指定できます。

+name と -name のエントリだけで構成されるリストは、継承した選択を置き換えるのではなく変更します。たとえば、次の設定ではデフォルトのツールに加えて codemode を有効にします。

{
  "defaultTools": ["+codemode"]
}

これは bash を powershell に置き換え、grep を有効にします：["-bash", "+powershell", "+grep"]。プロジェクト設定はユーザー設定の上に適用されます。+name と -name のエントリだけを含むプロジェクトのリストはユーザーの選択を変更し、修飾のない名前を含むプロジェクトのリストはそれを置き換えます。1 つのリスト内では、修飾のない名前によって選択内容が構成され、その後 +name と -name が順番に適用されます。

/reload は、defaultTools に新たに追加されたツールを有効にします。そこから削除されたツールを無効にしたり、ユーザーが無効にしたまま変更されていないツールを再度有効にしたりすることはありません。--tools、--no-tools、--no-builtin-tools は、再読み込み時にも defaultTools を上書きします。

CLI のツールオプションは、1 回の呼び出しに限りこの設定を上書きします。--tools は +name または -name を受け付けません。コマンドラインを参照してください。

セッションとコンテキスト#

圧縮#

圧縮のトークン値は、非負の安全な整数でなければなりません。各値は、一致するモデルの上書き設定、通常の圧縮設定、組み込みのデフォルトの順に、それぞれ独立して解決されます。プロジェクトとユーザーのオブジェクトは、モデルを検索する前にマージされます。

トリガー、要約、検証の動作については、圧縮リファレンスを参照してください。

分岐の要約#

ターミナルと表示#

形式とプラットフォームの詳細については、テーマとターミナルのセットアップを参照してください。

ネットワークと再試行#

プロバイダーレベルの再試行が必要でない限り、retry.provider.maxRetries は 0 のままにしてください。プロバイダー側で再試行すると、Pi 自身によるクォータおよび使用量上限エラーの処理が遅れることがあります。

シェル#

シェルの設定についてはシェルエイリアス、パッケージマネージャーの動作についてはPi パッケージを参照してください。

リソース#

ユーザー設定内のリソースパスは、エージェントディレクトリを基準に解決されます。プロジェクト設定内のパスは、プロジェクトの .pi ディレクトリを基準に解決されます。絶対パスおよび ~ をサポートします。

リソース配列では、!pattern による glob 除外、+path による完全一致の対象の追加、-path による完全一致の対象の除外をサポートします。Pi は、ユーザーレベルとプロジェクトの両方の設定に記載されたリソースを読み込みます。

組み込み拡張機能は、extensions 内では builtin:mcp、builtin:llama.cpp、builtin:codemode、builtin:tool-search という名前です。これらはデフォルトで読み込まれ、-builtin:mcp を指定すると、そのうちの 1 つが無効になります。プロジェクト設定の +builtin:<name> または -builtin:<name> エントリは、ユーザー設定を上書きします。pi config では、これらが「組み込み」の下に一覧表示されます。--no-extensions でも無効にでき、-e builtin:<name> を指定すると 1 つを明示的に読み込みます。

更新、テレメトリ、警告#