コンテンツにスキップ

スレッド (Threads)

エージェントとの個々の会話はスレッド (Thread) として管理されます。スレッドには作成された日時を基にした名前が自動的に付けられます。

  • + New をクリックすると、新しいまっさらな会話を開始できます。
  • 過去のスレッドはメッセージ入力欄の上に一覧表示されます。

スレッドの保存場所

スレッドはローカルファイルシステムに保存され、セッションをまたいで永続化されます。各スレッドは以下の 3 つのファイルとして保存されます:

ファイル名 格納内容
thread_{id}.json 完全なメッセージ履歴
thread_{id}.meta.json タイトル、タイムスタンプ、メッセージ数
thread_{id}.runs.json 実行ごとのプロバイダー、モデル、および MCP サーバー情報

runs ファイルは、スレッド内の各応答でどの AI プロバイダー、モデル、および MCP サーバーが使用されたかを追跡・記録します。

保存場所は XDG Base Directory 仕様に準拠しています:

プラットフォーム パス
macOS / Linux ~/.local/share/griptape_nodes/threads/
Windows %USERPROFILE%\.local\share\griptape_nodes\threads\

Griptape Nodes デスクトップ版の場合、アプリケーションデータフォルダ内の xdg_data_home/griptape_nodes/threads/ フォルダにスレッドが保持されます。お使いのマシンでの正確な場所を確認するには、App Settings → App Data Locations を開いてください。

履歴ファイルが破損した場合、Griptape Nodes は他のスレッドに影響が及ばないよう、そのファイルを自動的に退避(.corrupt-<timestamp> サフィックスを付与してリネーム)します。