Skip to content
Last updated

ファイルのアップロードとダウンロード

WebDesktopMobile

データをStudioに取り込み、結果を出力します。CSV、PDF、ドキュメントをアップロードしてAIに分析のコンテキストを提供し、AIが生成したレポート、プレゼンテーション、データセットをダウンロードできます。これらはすべてサーバー側に保存され、どのデバイスからでもアクセス可能です。

注意

AIはアップロードされたファイルをサーバー側のサンドボックス内で処理します。ファイルはチャットごとに保存され、Filesパネルからアクセスできます。ローカルのファイルシステムにはアクセスしません。

目的

ローカルデバイスとStudioのサーバー側環境の間でファイルをやり取りし、AIがデータを分析できるようにするとともに、その出力結果をエクスポートできるようにします。

前提条件

  • Treasure AI Studioにサインイン済みであること(はじめに
  • アクティブなチャットセッションがあること

ファイルサイズの制限

警告

アップロードできる最大ファイルサイズは1ファイルあたり100 MBです。それより大きなファイルを扱う必要がある場合は、ファイルを小さなチャンクに分割するか、関連する部分のみをアップロードすることをご検討ください。


ファイルのアップロード

チャットセッションにファイルをアップロードする方法は2つあります。チャット入力欄からアップロードする方法と、Filesパネルからアップロードする方法です。

チャット入力欄から

WebおよびDesktop

  1. チャット入力ツールバーのプラスボタン(+)をクリックします
  2. ファイルピッカーから1つ以上のファイルを選択します
  3. ファイルがテキストエリアの下にサムネイルとして表示され、ファイル名とカテゴリアイコンが示されます
  4. メッセージを入力します(例:「このレポートを要約してください」または「このCSVをテーブルに読み込んでください」)
  5. 送信をクリックすると、ファイルがアップロードされ、メッセージと一緒に送信されます

チャットエリアにファイルを直接ドラッグ&ドロップすることもできます。チャット上にファイルをドラッグすると、Drop files hereというメッセージとともに青いオーバーレイが表示されます。ドロップすると、ファイルが保留中の添付ファイルに追加されます。

送信前に保留中のファイルを削除するには、サムネイルのXボタンをクリックします。

Mobile(iOS)

  1. チャット入力ツールバーのプラスボタン(+)をタップします
  2. 以下から選択します:
    • File — ドキュメントを参照して選択する
    • Camera — 写真を撮影して添付する
    • Photos — フォトライブラリから選択する
  3. ファイルがテキストエリアの下にピルとして表示されます
  4. メッセージを入力して送信をタップします

保留中のファイルを削除するには、ピルのXをタップします。

Filesパネルから

WebおよびDesktop

  1. チャットヘッダーのフォルダアイコンをクリックしてFilesパネルを開きます
  2. パネル上部のUploadボタンをクリックします
  3. ファイルピッカーからファイルを選択します
  4. ファイルが現在のディレクトリにアップロードされます

ディレクトリの指定

チャット入力欄にファイルが添付されている場合、ディレクトリパス入力欄が表示されます。これにより、チャットのファイルシステム内のどのフォルダにファイルをアップロードするかを指定できます。

  • デフォルトの場所はルートディレクトリです(「(root)」と表示されます)
  • パスを入力し始めると、既存のフォルダからオートコンプリートの候補が表示されます
  • 既存のフォルダを選択するか、新しいパスを入力して新しいフォルダを作成できます
技術的な注意事項

各チャットセッションは、/home/agent/chats/{chatId} をルートとする独立したファイルシステムを持ちます。チャット入力欄からアップロードされたファイルは、このルート内の指定されたディレクトリパスに保存されます。ディレクトリパス入力欄は、現在のフォルダツリーに基づいてオートコンプリートを使用します。

ファイルのダウンロード

AIが生成したファイル

AIがファイル(レポート、スプレッドシート、プレゼンテーション、その他の出力)を作成すると、チャットにCreated fileカードが表示され、以下の情報が含まれます:

  • ファイルアイコン — カテゴリ別に色分けされています(スプレッドシートは緑、ドキュメントは青、画像は紫など)
  • ファイル名ファイルサイズ
  • カテゴリラベル(例:「Spreadsheet」、「Document」、「Presentation」)
  • Previewボタン — 組み込みビューアでファイルを開きます
  • Downloadボタン — ファイルをデバイスにダウンロードします
File card in chat showing generated file with download button

Filesパネルから

WebおよびDesktop

  1. Filesパネルを開きます(チャットヘッダーのフォルダアイコン)
  2. ファイルツリー内の任意のファイルにカーソルを合わせます
  3. ホバー時に表示されるダウンロードアイコンをクリックします

または、ビューアでファイルを表示中の場合:

  1. ビューアのフッターにあるDownloadボタンをクリックします

Mobile(iOS)

任意のファイルカードのPreviewボタン(目のアイコン)をタップしてファイルを開きます。モバイルでのダウンロード機能は、ファイルのプレビュー時にiOSのシェアシートを通じて処理されます。

Filesパネル

Filesパネルは、各チャットセッション内のファイルマネージャーです。2つのゾーンで構成されています:

ゾーンA:ファイルエクスプローラー

現在のチャットセッション内のすべてのファイルを表示する階層フォルダツリーです。

  • フォルダはフォルダアイコンとともに表示され、クリックで展開/折りたたみができます
  • ファイルはカテゴリ別の色付きアイコン、名前、サイズとともに表示されます
  • ファイルにカーソルを合わせるとダウンロードボタンが表示されます
  • ファイルをクリックするとビューア(ゾーンB)で開きます

ファイルがまだ存在しない場合、パネルにはNo files yetUpload files or ask the AI to generate themというヒントが表示されます。

ゾーンB:ファイルビューア

開いたファイルが表示されるタブ付きビューアエリアです。開いている各ファイルには独自のタブが割り当てられます:

  • タブバー — 色付きドットインジケーターとともにファイル名が表示されます。Xをクリックするとタブを閉じます
  • ビューアエリア — 適切なビューアを使用してファイルをレンダリングします(File Viewersを参照)
  • フルスクリーン切り替え — ビューアを画面全体に拡大します

ファイルが選択されていない場合、ビューアにはSelect a tab to view fileと表示されます。

パネルコントロール

コントロール説明
フォルダアイコン(チャットヘッダー)Filesパネルの開閉を切り替えます。ファイルが存在するがパネルが閉じている場合、ドットバッジが表示されます
Reloadボタン(更新アイコン)サーバーからファイルリストを更新します
Uploadボタン現在のディレクトリにファイルをアップロードします
Fullscreen / Exit fullscreenビューアを画面全体に拡大または縮小します

作業フォルダ内でのファイル整理

作業フォルダはファイルを直接公開するため、チャットを開かずに、サイドバーと専用の作業フォルダページからファイルの閲覧・名前変更・移動・アップロード・削除ができます。各作業フォルダは独自のファイル空間を持ち、その中のすべてのチャットで共有されます。スタンドアロンチャットは、ファイルを上記のチャットごとの Files パネルに保持します。ファイル管理は WebとDesktop で利用できます。

サイドバーのファイルツリー

サイドバーの Work Folders セクションで、作業フォルダの横にあるシェブロンをクリックして展開します。展開された各作業フォルダには、その ChatsFiles(作業フォルダのファイルツリー。オンデマンドで読み込まれます)が表示されます。

ドットファイルと作業フォルダの CLAUDE.md は淡色表示され、末尾にソートされます。任意のファイルをクリックするとビューアで開きます。Refresh files を使うとサーバーからツリーを再読み込みします。ツリーはサイドバーにあるため、会話を開始しなくても作業フォルダのファイルを確認できます。

作業フォルダを展開し、その Chats リストと Files ツリー(末尾にソートされた淡色の CLAUDE.md と .claude エントリを含む)を表示した Treasure AI Studio のサイドバー

作業フォルダページ

サイドバーで作業フォルダの名前をクリックすると、そのページが開きます。ページは作業フォルダ内のすべてを次のセクションに整理して意味的に表示します:

セクション 内容
Instructionこの作業フォルダのすべてのチャットで AI が従う標準ガイダンス。CLAUDE.md として保存されます。コアコンセプトを参照してください。
Files作業フォルダのファイルとフォルダ。NameUpdatedSize を示すテーブルで表示されます。
Local Skills作業フォルダ内の .claude/skills/ 配下に定義されたスキル。名前と説明で一覧表示されます。
Chatsこの作業フォルダで開始された会話。作成アイコンで新しい会話を開始します。

Files セクションでは、フォルダのシェブロンをクリックするとインライン展開し、フォルダ名をクリックするとその中に入ります。Work Folders をルートとするパンくずリストが現在位置を示します。ファイルをクリックすると、全画面のファイルビューで開きます。

Instruction、Files、Local Skills、Chats の各セクションを表示した作業フォルダページ。Files テーブルにはフォルダとファイルが一覧表示され、New folder と Upload ボタンが並ぶ

ファイルの管理

作業フォルダページから、作業フォルダのファイルを直接整理できます:

操作 方法
UploadUpload をクリックして、現在表示しているフォルダにファイルを追加します。
New folderNew folder をクリックして名前を入力します。名前に / を含めたり、. または .. にすることはできません。
Renameファイルまたはフォルダの ⋯ メニューを開き、Rename を選択します。
Moveファイルまたはフォルダを別のフォルダにドラッグして移動します。移動は単一の作業フォルダ内に限られ、作業フォルダ間でファイルをドラッグすることはできません。
Delete⋯ メニューを開き、Delete を選択します。ファイルとフォルダを削除できます。フォルダを削除するとその中身もすべて削除されるため、Studio は項目数を表示し、事前に確認を求めます。
Ask AIファイルまたはフォルダの Ask AI(✨ボタン)をクリックすると、その作業フォルダで、コンポーザにパスが事前入力された状態で新しいチャットが開始されます。
Note

ファイル整理は作業フォルダに適用されます。スタンドアロンチャットは、ファイルをチャットごとの Files パネルに保持し、サイドバーのファイルツリーからは閲覧できません。

ファイルカテゴリ

Studioはファイルを拡張子によって分類し、色分けされたアイコンで表示します:

カテゴリ拡張子アイコンの色
Spreadsheetcsv, xlsx, xls, tsv
Documentmd, txt, pdf, doc, docx, html, htm
Presentationpptx, ppt
Imagepng, jpg, jpeg, gif, svg, webp
Codejs, ts, py, sql, sh, yaml, ymlオレンジ
Datajson, xml, mmd, mermaid
Journey*.journey.yaml, *.journey.ymlティール
Fileその他すべての拡張子グレー

アップロードエラー

ファイルのアップロードに失敗した場合、**File upload failed. Message not sent.**というメッセージが表示されます。すべてのファイルのアップロードが失敗した場合、メッセージはAIに送信されません。

バッチ内の一部のファイルが成功し、他のファイルが失敗した場合、メッセージは正常にアップロードされたファイルのみとともに送信されます。

ファイルの保持と削除

Studioに保存されたファイルには、以下の保持ルールが適用されます:

シナリオファイルへの影響
スタンドアロンチャットを削除した場合そのチャットに紐づくすべてのファイルが完全に削除されます
作業フォルダチャットを削除した場合ファイルは削除されません 作業フォルダワークスペースにて引き続きアクセスできます
自動期限切れ設定されたチャット保持期間(デフォルト: 28日)の経過後に、スタンドアロンチャットに保持されたファイルは自動的に削除されます。作業フォルダチャットに保持されたファイルは削除されません
重要

ファイルの削除は永続的であり、元に戻すことができません。スタンドアロンチャットを削除する前、または保持期間の期限切れ前に、必要なファイルをダウンロードしてください。

確認

  • プラスボタンからファイルを添付し、サムネイル/ピルとして表示されることを確認する
  • ファイルとともにメッセージを送信し、AIがその内容を参照することを確認する
  • 「Created file」カードのDownloadボタンを使用してAI生成ファイルをダウンロードする

トラブルシューティング

問題解決策
File upload failed. Message not sent.ネットワーク接続を確認して再試行してください。ファイルは100 MB未満である必要があります。それより大きい場合は、ファイルを分割するか、関連するセクションのみをアップロードしてください
アップロードしたファイルがAIに参照されないAIはファイルの内容を非同期で処理します。アップロードインジケーターが完了するまで待ってから、メッセージを再送信してください
Downloadボタンが表示されないDownloadボタンは「Created file」カード上のAI生成ファイルにのみ表示されます。アップロードしたファイルはFilesパネルからダウンロードできます

次のステップ

  • File Viewers — StudioがPDF、スプレッドシート、プレゼンテーションなどをレンダリングする方法
  • AI Chat Interface — ファイルコンテキストを含むメッセージの送信
  • Artifact Output — AIが生成する出力ファイル(PPTX、DOCX、PDF、XLSX)
  • Chat Data Retention — チャット履歴と関連ファイルの保持期間の設定