Skip to content
Last updated

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

WebDesktopMobile

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

注意

AIはアップロードされたファイルをサーバー側のサンドボックス内で処理します。ファイルはそのチャットが保存されている作業フォルダに属し、サイドバーと作業フォルダページから閲覧できます。ローカルのファイルシステムにはアクセスしません。

目的

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

前提条件

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

ファイルサイズの制限

警告

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


ファイルのアップロード

チャット入力欄からアップロードしてAIにすぐ渡すこともできますし、チャットを開かずに作業フォルダのページから直接そのフォルダにアップロードすることもできます。

チャット入力欄から

WebおよびDesktop

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

お使いのコンピューターからチャットエリアにファイルを直接ドラッグ&ドロップすることもできます。チャット上にファイルをドラッグすると、Drop files hereというメッセージとともに青いオーバーレイが表示されます。ドロップすると、ファイルが保留中の添付ファイルに追加されます。一方、サイドバーのファイルツリーからファイルをドラッグした場合は、何もアップロードされず、そのパスが入力欄に挿入されます — ファイルはすでにStudio内にあるためです。作業フォルダをまたいで作業するを参照してください。

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

Mobile(iOS)

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

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

作業フォルダページから

WebおよびDesktop

  1. サイドバーから作業フォルダのページを開きます
  2. ファイルを入れたいフォルダに移動します
  3. Uploadをクリックしてファイルを選択します

ファイルは uploads/ ではなく、表示しているフォルダに保存されます。チャットを始める前にデータセットを目的の場所へ置くには、この方法が直接的です。作業フォルダ内でのファイル整理を参照してください。

添付ファイルの保存先

チャット入力欄に添付したファイルは uploads/ ディレクトリに保存されます。このディレクトリは最初のアップロード時にStudioが作成します。

WebおよびDesktop

添付ファイルは常に uploads/ に保存され、保存先を選ぶ操作はありません。作業フォルダ内のチャットでは、その作業フォルダ自身の uploads/ ディレクトリになるため、添付ファイルは作業フォルダページの Uploads セクションと、サイドバーのファイルツリーに、そのフォルダの他の内容と並んで表示されます。作業フォルダに属さないチャットでは、uploads/ はそのチャット専用です。

アップロード後に別の場所へ整理するには、作業フォルダページで uploads/ の外に移動します。行を Files セクションの別のフォルダにドラッグしてください。作業フォルダ内でのファイル整理を参照してください。

Mobile(iOS)

Mobileでは、ファイルを添付するとディレクトリパス入力欄が表示され、チャットのファイル空間内のどのフォルダに保存するかを選べます。

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

作業フォルダのファイルは /home/agent/work/{dirname} 配下に置かれるため、その作業フォルダ内のチャットから送信した添付ファイルは /home/agent/work/{dirname}/uploads/ に保存されます。作業フォルダに属さないチャットは /home/agent/chats/{chatId} に独自のファイル空間を持ち、その中の uploads/ に添付ファイルを保存します。いずれの場合も、すべての作業フォルダが /home/agent/work/ 配下でAIから利用できます。作業フォルダをまたいで作業するを参照してください。

ファイルのダウンロード

AIが生成したファイル

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

  • ファイルアイコン — カテゴリ別に色分けされ、アイコンの下に拡張子が表示されます(スプレッドシートは緑、ドキュメントは青、画像は紫など)
  • ファイル名
  • 種類のラベル — ファイル形式(例:「HTML」、「Markdown」、「PDF」)、または該当するカテゴリ(例:「Spreadsheet」、「Presentation」)
  • Downloadボタン — ファイルをデバイスにダウンロードします

カード自体をクリックすると、組み込みビューアでファイルが開きます。

File card in chat showing generated file with download button

ファイルビューアから

WebおよびDesktop

  1. ファイルを開きます — チャットのメッセージ、サイドバーのファイルツリー、作業フォルダページのいずれからでも開けます
  2. ビューアのヘッダーにあるダウンロードアクションをクリックします

開かずにダウンロードするには、作業フォルダページでそのファイルの ⋯ メニューを開き、Downloadを選択します。

Mobile(iOS)

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

ファイルビューアパネル

Studioの右側にあるパネルは、開いたファイルを表示するビューアであり、ファイルマネージャーではありません。ファイルの閲覧と整理は、サイドバーのファイルツリーと作業フォルダページで行います(作業フォルダ内でのファイル整理を参照)。パネルは、チャットのメッセージ・サイドバー・作業フォルダページのいずれかから開いたファイルを表示します。

タブ

開いたファイルはそれぞれパネルのヘッダーにタブとして並びます。タブをクリックすると表示を切り替え、Xをクリックすると閉じます。Studioはチャットごと・作業フォルダごとに別のタブ一式を保持するため、会話を移動しても開いていたファイルが混ざりません。現在のチャットとは別の作業フォルダのファイルはフォルダ名 / ファイル名と表示され、ビューアは内容の上にそのフォルダ名を示します。

パネルコントロール

コントロール 説明
Downloadアクティブなタブのファイルをデバイスに保存します
Deleteアクティブなタブのファイルを削除します。Studioは事前に確認を求めます
Maximize / Minimizeアクティブなファイルを画面全体に拡大し、パネルに戻します
パネルを閉じるパネルを折りたたみます。再度開くボタンは、表示中のチャットまたは作業フォルダに開いているタブがあるときに表示されます

ファイルがどのビューアで表示されるかは種類によって決まります。File Viewersを参照してください。

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

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

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

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

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

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

作業フォルダページ

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

セクション 内容
Instructionこの作業フォルダのすべてのチャットで AI が従う標準ガイダンス。CLAUDE.md として保存されます。作業フォルダを参照してください。
Files作業フォルダのファイルとフォルダ。NameUpdatedSize を示すテーブルで表示されます。
Uploadsフォルダの uploads/ インボックス(チャット入力欄から添付したファイルの保存先)。各ファイルの名前と最終更新の相対時刻を一覧表示します。フォルダのルートで常に表示され、空のときは 「No files uploaded yet」 と表示されます。行を Files の任意のフォルダにドラッグすると整理できます。サイズと ⋯ メニューを含む完全な一覧は Files にあり、uploads/ も他のディレクトリと同様に表示されます。
アクションとスキル作業フォルダ内の .claude/skills/ 配下に定義されたアクションとスキル — アクションは 実行 ボタン付きで表示され、通常のスキルは折りたたまれた スキル (n) サブグループに入ります。フォルダのルートで表示されます。アクションを参照してください。
Chatsこの作業フォルダで開始された会話。作成アイコンで新しい会話を開始します。

セクションはこの順序で表示されます — FilesUploadsアクションとスキルChats の順で、フォルダの指示とパンくずリストの下に並びます。

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

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

ファイルの管理

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

操作 方法
UploadUpload をクリックして、現在表示しているフォルダにファイルを追加します。
New folderNew folder をクリックして名前を入力します。名前に / を含めたり、. または .. にすることはできません。
Renameファイルまたはフォルダの ⋯ メニューを開き、Rename を選択します。
Downloadファイルの ⋯ メニューを開き、Download を選択すると、開かずにそのままデバイスに保存できます。
Moveファイルまたはフォルダを別のフォルダにドラッグして移動します。Uploads セクションの行をドラッグして外に出すことも、別の作業フォルダに移すこともできます。移動先は、サイドバーの作業フォルダの行やファイルツリー、ページ上のフォルダやパンくずリストの項目にドロップして指定します。移動先に同名の項目がすでにある場合、Studio は移動を拒否してエラーを表示し、何も上書きされません。すでに置かれているフォルダへのドロップや、フォルダ自身のサブツリーへのドロップは拒否され、ポインタにドロップ不可のカーソルが表示されます。
Delete⋯ メニューを開き、Delete を選択します。ファイルとフォルダを削除できます。フォルダを削除するとその中身もすべて削除されるため、Studio は項目数を表示し、事前に確認を求めます。
Ask AIファイルまたはフォルダの Ask AI(✨ボタン)をクリックすると、その作業フォルダで、コンポーザにパスが事前入力された状態で新しいチャットが開始されます。
Note

ファイル整理は作業フォルダに適用されます。作業フォルダに属さないチャットは、ファイルを自身のファイル空間に保持し、サイドバーのファイルツリーや作業フォルダページからは閲覧できません。

MIGRATED_HOME フォルダ

作業フォルダによっては、自分では作成していない MIGRATED_HOME という名前のフォルダが含まれていることがあります。これは、以前 AI のホームディレクトリに置かれていたファイル(シェルの設定、ツールの設定、それ以前のチャットが残していったもの)を収めたフォルダです。これらはどの作業フォルダにも属さない場所にあり、ファイルブラウザーからは見ることができませんでした。

現在の Studio はチャットごとに独立した環境を与え、永続的に保持するのは作業フォルダ内のファイルだけです。そのため、以前ホームディレクトリにあったこれらのファイルは破棄されず、作業フォルダの中へ移動されました。今後どうなるかについてはチャット終了後に残るものを参照してください。

作業フォルダページでは、MIGRATED_HOMEFiles セクションの中に、自分で作成したフォルダやファイルと並んで表示されます。並び順も他のディレクトリと同じく名前順です。

作業フォルダページの Files セクション。自分で作成した memory フォルダと reports フォルダの間に MIGRATED_HOME フォルダが並び、その下に生成された 3 つの HTML レポートファイルが表示されている

MIGRATED_HOME はアーカイブとして扱ってください。ここに書き込まれるものはもうありません。必要なものは作業フォルダの側へ移動し、残りは削除してください。作業フォルダ内の他のディレクトリと同じように扱えるため、⋯ メニューの Delete でこのフォルダごと中身も削除されます。

ファイルカテゴリ

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生成ファイルにのみ表示されます。アップロードしたファイルは作業フォルダページからダウンロードできます — ファイルの ⋯ メニューでDownloadを選択するか、ファイルを開いてビューアのダウンロードアクションを使います
作成した覚えのない MIGRATED_HOME フォルダがある以前 AI のホームディレクトリに置かれていたファイルを、参照できる状態に保つために作業フォルダへ移動したものです。現在ここに書き込まれるものはありません。必要なものだけ残して、あとは削除してください。MIGRATED_HOME フォルダを参照してください
AIが作成したファイルが作業フォルダに見当たらない永続するのは作業フォルダ内に書き込まれたファイルだけです。AIがそれ以外の場所に書き込んだ作業用のファイルはチャットとともに消えます。そのチャットがまだ残っていれば、開いてAIに作業フォルダへ保存し直すよう頼んでください(環境にまだ残っている可能性があります)。残っていない場合は新しいチャットで再度依頼してください。チャット終了後に残るものを参照してください

次のステップ

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