設定・管理設定
対象: ServerRpc(Client に紐づくサーバー全体の操作) RPC 全体の概要とページ一覧は RPC を参照してください。contentExclusion
セッション作成前に、コンテンツ除外ポリシーのJSONを検証できます。policiesJson は未解析のJSON文字列のままCLIに渡されます。JSONの解析またはスキーマ検証に失敗した場合は、CLIからのRPCエラー(JsonRpcException)が発生します。
これはポリシー自体を検証するサーバースコープのRPCです。セッションの作業ディレクトリ内のパスを実際の除外ポリシーに照らして確認するには、セッションスコープの contentExclusion()->checkPaths() を使います。
managedSettings (experimental: 管理設定)
管理設定の読み取り、ポリシー解決、スキーマ取得、検証、合成プレビュー、キャッシュ破棄を行います。settings (experimental: 設定ファイルの操作)
設定ファイルから指定したキーを削除し、表示用に秘匿値を置き換えます。removeRawKey()は読み込みに失敗したキーなど、正規の設定パスではないキーもそのまま削除できます。ファイルが解析できない場合は上書きせずstatusがinvalidになります。redactValueForDisplay()はbasePathで指定した設定ツリー上の位置を基に秘匿値をプレースホルダーへ置き換えるため、ユーザーへの表示やログ出力に使えます。
providersConfig (experimental: プロバイダー設定)
providersConfig()->addModel()はサーバーの保存済みプロバイダー設定にモデルを追加する実験的なRPCです。プロバイダーが未保存の場合は作成され、providerAddedで確認できます。永続的な操作ですが、実行中のセッションは変更しません。
ProvidersConfigAddModelRequestを渡せます。任意のcredentialはCLIによってOSキーチェーンに保存され、結果には返されません。
同じprovidersConfig()から、保存済みの設定を読み取り・更新・削除できます。これらも実験的なAPIであり、実行中のセッションは変更しません。
read()は保存順の設定を返しますが、認証情報、ヘッダー、コマンドなどの秘密情報は返しません。各プロバイダーのcredentialStatusはpresent、absent、unavailableのいずれかです。updateProvider()は共通設定を差し替え、省略された認証情報、カスタムヘッダー、ローカルモデル設定を維持します。updateModel()は指定されたプロバイダー名とモデルIDのモデル定義を差し替えます。removeModel()が最後のモデルを削除した場合はプロバイダーと管理対象の認証情報も削除され、providerRemovedがtrueになります。各更新・削除には対応するProvidersConfigUpdateProviderRequest、ProvidersConfigUpdateModelRequest、ProvidersConfigRemoveModelRequestも使用できます。