エディタの概要 (The Editor)

エディタは、Griptape Nodes のワークフローを視覚的に構築、実行、および検査するためのビジュアルワークスペースです。基本構造はキャンバス形式であり、ノードをキャンバス上にドラッグして配置し、互いに接続線で結び、結果を実行します。ウィンドウ内の他のすべての要素（ヘッダー、メニューバー、左右のサイドバー）は、このキャンバスをサポートするために存在します。ワークフローの命名と実行、追加するノードの検索、実行中のノードの動作の検査などを担います。

このページでは各領域のツアーを提供します。特定の作業手順をお探しの場合は、次のステップセクションから、ノード操作、グループ化、ワークフロー実行、メディアエディタ、ライブラリ管理などの個別ガイドを参照してください。

キャンバス (The Canvas)

キャンバスはワークフローが実際に配置されるメインエリアです。ノードは入力と出力を備えたボックスとして表現され、ノード間の接続は、あるノードの出力ポートから別のノードの入力ポートへと引く線によって表されます。構築するすべてのロジックはここに集約されます。

キャンバス内の基本的なナビゲーション操作：

パン（画面移動）: Space キーを押しながらドラッグする（ノード上にカーソルがある場合でも機能します）、またはマウスの中央ボタン（ホイールクリック）でドラッグします。
ズーム（拡大・縮小）: マウスホイールのスクロールやトラックパッドのピンチ操作、左上隅のズームスライダー（設定で有効化されている場合）、または Z キーを押しながら左右にドラッグする Photoshop スタイルのスクラブズームを使用します。
選択: キャンバスの空いている場所からドラッグして矩形選択枠で複数のノードを一括選択するか、Shift キーを押しながら個別のノードをクリックして選択対象に追加・解除します。

隅にあるミニマップ (Minimap)（非表示の場合はエディタ設定で切り替え可能）はグラフ全体を俯瞰表示し、内部をクリックまたはドラッグすることで目的の場所に素早くジャンプできます。左下のコントロールクラスターには、ズームイン/ズームアウト/全体表示（フィット）ボタンと、装飾用の Griptape ロゴ透かしを非表示にする Toggle Clean Mode ボタンが用意されており、ワークフローのスクリーンショットを撮影する際に便利です。

キャンバス上で Tab キーを押すと、カーソル位置に Add Node（ノード追加）メニューが開きます。配置後のノードに対して実行できるすべての操作についてはノード操作ガイドを、キャンバスショートカットの完全なリストについてはキーボードショートカットを参照してください。

ヘッダー (The Header)

ウィンドウ最上部を横断するヘッダーは、3 つのクラスターに分かれています。

左側には、サイドバー切り替えボタンとメニューバー、そしてワークフロー名が配置されています。未保存の変更がある場合はワークフロー名の末尾に * が表示され、一度でも保存されるとファイル名（<workflow>.py）がその下に表示されます。まだ一度も保存されていない新規ワークフローでは、作業用の名前のみが表示されます。

中央には、実行制御ボタン群が配置されています：

ボタン	動作
Run Workflow	ワークフロー全体を最初から実行します。
Run To Selected	選択中の単一ノードまで（上流からそのノードまで）を実行します。
Run From Selected	選択中の単一ノードから開始し、下流に向かって実行します。
Cancel Run	現在実行中のワークフローを停止します。

Run To Selected と Run From Selected は、ノードがちょうど 1 つだけ選択されている場合にのみ有効になります。「実行可能」の意味や部分実行の動作仕様については、ワークフローの実行を参照してください。

右側には、エンジンピッカー（エディタが対話する実行中エンジンの切り替え）、エラー履歴のドロップダウン、および公開ダイアログを開く Publish Workflow ボタンが配置されています。

メニューバーはヘッダー左側のクラスター、サイドバー切り替えボタンの隣にあります。3 つのメニューで構成されています。

File（ファイル）

現在のワークフローファイルの作成、オープン、保存、および管理を行います：

New / Open... — 新規ワークフローを作成するか、既存のワークフローを参照して開きます。
Rename... — ワークフローの名前を変更します（Griptape 公式のテンプレートワークフローでは無効です。編集用コピーを作成するには Save As を使用してください）。
Save / Save As... / Save As New Version — Save As New Version は上書きする代わりに新しいバージョン管理ファイル（my_workflow_v002.py など）として書き出します（一度保存されたワークフローでのみ表示されます）。
AutoSave — 自動保存の有効/無効を切り替えます。設定へのショートカットも含まれます。
Refresh Libraries — エンジンを再起動することなくライブラリの変更を再読み込みします。
Report Issue — バグ報告を提出します。
Exit — エディタを終了します。
Delete <workflow name> — 現在のワークフローファイルを完全に削除します。

Manage（管理）

ワークフローが依存するリソースの管理画面へ移動します：

Model Management — ノードが必要とする利用可能な AI モデルを管理します。
Library Management — ノードライブラリのインストール、更新、設定を行います。詳細はノードライブラリガイドを参照してください。
Engine Management — エディタが接続可能なエンジンを管理します。
Project Management — 切り替え可能なプロジェクトを管理します。GUI でのプロジェクト管理を参照してください。

Settings（設定）

設定可能なすべての項目が Settings サブメニュー（All Settings、Agent Settings、Editor Settings、Theme Settings、Engine Settings、File System、Libraries、Library Settings、MCP Servers、API Keys & Secrets、およびベータ機能）の下にまとめられています。その下には 3 つのアクションが用意されています：Copy Path to Settings（設定ファイルのパスをクリップボードにコピー）、Show Settings Folder（設定フォルダを Finder/エクスプローラー/ファイルマネージャーで表示）、Reset Settings to Default（設定をデフォルトにリセット）。

これらはエンジンとエディタの動作を設定します。Griptape Nodes デスクトップ版をお使いの場合、アプリケーション独自の設定（テーマ、ライセンス、ログファイル、アップデートチャンネル）は、ウィンドウ右上隅のアカウントメニューからアクセスするアプリ設定で管理されます。

左サイドバーは、ワークフローに追加するノードやライブラリを検索する場所です。タブの上には Favorites（お気に入り）セクションがあり、ノードに星（スター）を付けてピン留めしておくことで、毎回探す手間を省くことができます。その下には、アクティブなタブを絞り込むための検索ボックスがあります。

検索ボックスの下には 2 つのタブがあります：

Nodes — 組み込みおよびインストール済みライブラリの両方から、利用可能なすべてのノードをカテゴリ別に整理して表示します。
Libraries — 同じノード群を、カテゴリ別ではなく提供元ライブラリ別に整理して表示します。これは閲覧用のビューです。ライブラリ自体のインストール、更新、削除を行うには Manage → Library Management を使用してください（ノードライブラリガイドを参照）。

いずれかのタブからノードをキャンバス上にドラッグすることで、ワークフローに追加できます。ヘッダーにあるサイドバー切り替えボタン（またはそのショートカットキー）をクリックすると、サイドバーを細いアイコンレールに折りたたむか、完全に閉じることができます。

右サイドバーには、Sidebar Panels と題されたタブ付きパネル群が収容されています。閉じるボタンの隣にあるドロップダウン（3 つのドットのアイコン）から各パネルの表示/非表示を切り替えることができ、各エントリの目のアイコンで現在どのパネルが表示されているかを確認できます。ここでパネルを非表示にしても何かが破棄されるわけではなく、再度有効化すればいつでもタブが復帰します。

4 つの主要パネル：

Chat — エディタ内でエージェントスレッドと直接対話できます。モデル/プロバイダーの選択や、接続した MCP サーバーの利用が可能です。
Code — ワークフローから生成された Python コードを構文ハイライト付きエディタで表示し、検索やコード実行が行えます。
Logs — 実行ログストリームを表示します。重要度（Debug、Info、Warning、Error、Critical）でのフィルタリングや検索が可能です。
Properties — キャンバス上で現在選択されているノード（または複数ノード）のパラメータを表示・編集します。各ノードの入力を設定する場所であるため、ワークフロー構築後は通常ここで多くの時間を過ごすことになります。

サイドバーが閉じている場合でも、キャンバス右上隅付近のフローティングボタンをクリックすることで再度開くことができます。

次のステップ

キーボードショートカット — 目的別に整理されたエディタ内の全ショートカット一覧。
ノード操作ガイド — ノードの追加、接続、名前変更、ロック、複製などの操作手順。
ノードのグループ化 — ノードのグループ化とグラフの整理整頓手法。
ワークフローの実行 — 全体実行、選択ノードまでの実行、選択ノードからの実行の違いと使い分け。
メディアビューアとエディタ — 画像、動画、その他のメディアパラメータ用の内蔵ビューアおよびエディタの解説。
モデルとライブラリの管理 — Model Management および Library Management 画面の詳細。