ベータ機能 (Beta Features)

ベータ機能は、まだすべてのユーザー向けに標準提供する準備が整っていない新機能です。これらを有効にして先行してお試しいただくことができ、いつでも無効に戻すことができます。ベータ機能はエディタ設定内の Beta Features ページから管理します。

Beta Features

ベータ機能の有効化と無効化

エディタのヘッダーにある Settings メニューを開き、All Settings を選択して、左側リストの最下部にある Beta Features をクリックします。各機能には、どこで何が変更されるかの簡潔な説明と、有効/無効を切り替えるトグルスイッチが用意されています。選択した内容は他の設定と一緒に保存されるため、次回エディタを開いたときにも状態が維持されます。

機能は提供元ごとにグループ分けされています：

Editor（エディタ）機能 — エディタの外観や動作を変更します。
Engine（エンジン）機能 — ワークフローの実行方法など、バックグラウンドでの動作を変更します。接続しているエンジンから提供されるため、エンジンの種類やバージョンによって一覧の内容が異なる場合があります。

ノードライブラリもベータ機能を提供できます。これらはエンジンの機能と並んで Engine グループに表示されます。通常、そのライブラリのノードに設定を追加または変更するものであり、説明文に対象が記載されています。ライブラリが読み込まれているときに表示され、削除されると一覧から消去されます。

すべてを標準の挙動に戻したい場合は、Reset all（すべてリセット）をクリックします。すべての機能がデフォルト状態（ほぼ常にオフ）に戻ります。

キャンバス上にすでに配置されているノードの挙動

ノード上の設定を追加または非表示にするライブラリ機能の場合、有効/無効を切り替えた後にキャンバスに追加したノードに変更が反映されます。キャンバス上にすでに配置されている既存のノードは、作成時の設定を維持します。既存のノードを更新するには、ノードを更新（リフレッシュ）するか、一度削除して再追加するか、ワークフローを保存して再度開き直してください。

トグルスイッチが変更できない場合

自身の個人設定以外の要因によって値が決定されている場合、トグルスイッチはグレーアウト（無効表示）されます。これは、プロジェクト、ワークスペース、または環境変数によって値が強制設定されている場合に発生します。トグルの下にあるメモに、何によって設定されているかが明記されます。このページから再びコントロールできるようにするには、該当箇所で値を変更するか削除してください。

ベータ機能利用時の留意点

ベータ機能は変更または廃止される可能性があります。 各機能は、数か月以内に Griptape Nodes の標準機能として正式採用されるか、廃止されます。その場合、このページから項目が削除され、以前保存した選択内容は効力を失います。
ワークフローの互換性は安全に保たれます。 ベータ機能がワークフローの保存形式を変更することはありません。機能のオン/オフに関係なくワークフローは同一に開かれるため、異なるベータ機能を有効にしている他のユーザーとも安全にワークフローを共有できます。
粗削りな挙動が含まれる場合があります。 予期しない動作が発生した場合は、機能をオフにして標準の挙動に戻してください。

エディタを使用しないベータ機能の設定

選択内容は、griptape_nodes_config.json ファイルの beta_features セクションに各機能の ID をキーとして保存されます：

{
    "beta_features": {
        "canvas_toolbar_placement_button": true
    }
}

ライブラリの機能は library_beta_features に保存され、ライブラリ名を小文字にし、スペースや記号をアンダースコアに変換した名前がキーになります。例えば「Acme Image Tools」というライブラリの場合：

{
    "library_beta_features": {
        "acme_image_tools": {
            "sharpen_after_upscale": true
        }
    }
}

値として認識されるのは true または false のみです。"yes" などの他の値は無視され、エンジンログに警告が出力されてデフォルト値が使用されます。ここでの記述ミスが他の通常設定に影響を与えることはありません。

また、環境変数を使用して単一セッション限定で機能を有効にすることも可能です。大文字にした機能 ID を GTN_CONFIG_BETA_FEATURES__ の後ろに付与します：

GTN_CONFIG_BETA_FEATURES__PARALLEL_BRANCH_RESOLUTION=true gtn

ライブラリ機能の場合は、GTN_CONFIG_LIBRARY_BETA_FEATURES__ の後に大文字のライブラリ識別キー、2 つのアンダースコア、そして機能 ID を指定します：

GTN_CONFIG_LIBRARY_BETA_FEATURES__ACME_IMAGE_TOOLS__SHARPEN_AFTER_UPSCALE=true gtn

上記で使用した機能名およびライブラリ名は説明用のサンプルです。自身で開発中のライブラリにベータ機能を追加する方法については、ライブラリの作成を参照してください。設定ファイルと環境変数の読み込み順序については、エンジン設定を参照してください。