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

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

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

## 目的

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

## 前提条件

- Treasure AI Studioにサインイン済みであること（[はじめに](/ja/products/ai-studio/getting-started)）
- アクティブなチャットセッションがあること


## ファイルサイズの制限

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

## ファイルのアップロード

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

### チャット入力欄から

#### WebおよびDesktop

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


お使いのコンピューターからチャットエリアにファイルを直接**ドラッグ＆ドロップ**することもできます。チャット上にファイルをドラッグすると、**Drop files here**というメッセージとともに青いオーバーレイが表示されます。ドロップすると、ファイルが保留中の添付ファイルに追加されます。一方、サイドバーのファイルツリーからファイルをドラッグした場合は、何もアップロードされず、そのパスが入力欄に挿入されます — ファイルはすでにStudio内にあるためです。[作業フォルダをまたいで作業する](/ja/products/ai-studio/concepts/work-folders#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%82%92%E3%81%BE%E3%81%9F%E3%81%84%E3%81%A7%E4%BD%9C%E6%A5%AD%E3%81%99%E3%82%8B)を参照してください。

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

#### Mobile

1. コンポーザーの**プラスボタン**（+）をタップして、**ファイルを添付**シートを開きます
2. 以下から選択します：
  - **カメラ** — 写真を撮影して添付する
  - **フォトライブラリ** — フォトライブラリから画像や動画を選択する
  - **ファイル** — ドキュメントを参照して選択する
3. 複数のファイルを選択できます。ファイルはテキストエリアの下に**X**付きの**チップ**として表示されます
4. メッセージを入力して**送信**をタップします


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

### 作業フォルダページから

#### WebおよびDesktop

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


ファイルは `uploads/` ではなく、表示しているフォルダに保存されます。チャットを始める前にデータセットを目的の場所へ置くには、この方法が直接的です。[作業フォルダ内でのファイル整理](#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E5%86%85%E3%81%A7%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E6%95%B4%E7%90%86)を参照してください。

### 添付ファイルの保存先

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

#### WebおよびDesktop

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

アップロード後に別の場所へ整理するには、作業フォルダページで `uploads/` の外に移動します。行を **Files** セクションの別のフォルダにドラッグしてください。[作業フォルダ内でのファイル整理](#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E5%86%85%E3%81%A7%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E6%95%B4%E7%90%86)を参照してください。

#### Mobile

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

- 入力欄には `uploads`（共有作業フォルダでは `my/uploads`）があらかじめ入力されています
- パスを入力し始めると、既存のフォルダから**オートコンプリートの候補**が表示されます
- 既存のフォルダを選択するか、新しいパスを入力して新しいフォルダを作成できます


技術的な注意事項
作業フォルダのファイルは `/home/agent/work/{dirname}` 配下に置かれるため、その作業フォルダ内のチャットから送信した添付ファイルは `/home/agent/work/{dirname}/uploads/` に保存されます。作業フォルダに属さないチャットは `/home/agent/chats/{chatId}` に独自のファイル空間を持ち、その中の `uploads/` に添付ファイルを保存します。いずれの場合も、すべての作業フォルダが `/home/agent/work/` 配下でAIから利用できます。[作業フォルダをまたいで作業する](/ja/products/ai-studio/concepts/work-folders#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%82%92%E3%81%BE%E3%81%9F%E3%81%84%E3%81%A7%E4%BD%9C%E6%A5%AD%E3%81%99%E3%82%8B)を参照してください。

## ファイルのダウンロード

### AIが生成したファイル

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

- **ファイルアイコン** — カテゴリ別に色分けされ、アイコンの下に拡張子が表示されます（スプレッドシートは緑、ドキュメントは青、プレゼンテーションはローズ、画像は紫など）
- **ファイル名**
- **サイズと種類** — ファイルサイズに続けて形式が表示されます（例：「248.6 KB · PowerPoint」）。専用のラベルがない形式ではカテゴリ名（「Spreadsheet」「Document」）が使われ、サイズはStudioが把握するまで表示されません
- **Download**ボタン — ファイルをデバイスにダウンロードします


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

sale_trends_2026.htmlという生成ファイルのチャット内ファイルカード。.htmlと記された青いドキュメントアイコン、ファイル名、HTMLという種類ラベル、ダウンロードボタンが表示されている
### ファイルビューアから

#### WebおよびDesktop

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


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

### Mobile

メッセージ内のファイルカードをタップすると、ファイルのプレビューが開きます。Mobileにはダウンロード、共有、保存の機能はありません。チャットのファイルプレビューからは**ファイルを削除**できます。

## ファイルビューアパネル

Studioの右側にあるパネルは、開いたファイルを表示するビューアであり、ファイルマネージャーではありません。ファイルの閲覧と整理は、サイドバーのファイルツリーと作業フォルダページで行います（[作業フォルダ内でのファイル整理](#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E5%86%85%E3%81%A7%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E6%95%B4%E7%90%86)を参照）。パネルは、チャットのメッセージ・サイドバー・作業フォルダページのいずれかから開いたファイルを表示します。

### タブ

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

### パネルコントロール

| コントロール  | 説明  |
|  --- | --- |
| **アーティファクトを削除** | アクティブなタブのファイルを削除します。Studioは事前に確認を求め、削除は取り消せません |
| **アーティファクトをダウンロード** | アクティブなタブのファイルをデバイスに保存します |
| **アーティファクトを最大化** | アクティブなファイルをほぼ全画面のオーバーレイで開きます。**最大化したアーティファクトを閉じる**または**Escape**でパネルに戻ります。[最大化](/ja/products/ai-studio/files/file-viewers#%E6%9C%80%E5%A4%A7%E5%8C%96)を参照してください |
| **パネルを閉じる** | パネルを折りたたみます。再度開くボタンは、表示中のチャットまたは作業フォルダに開いているタブがあるときに表示されます |


ファイルがどのビューアで表示されるかは種類によって決まります。[File Viewers](/ja/products/ai-studio/files/file-viewers)を参照してください。

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

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

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

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

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

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

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

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


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

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

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

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

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


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

[共有作業フォルダ](/ja/products/ai-studio/shared-folders)でも同じ操作が使えますが、境界が 1 つ加わります。フォルダ本体がメンバーに見える範囲で、その中の **自分のみ** バッジが付いた `my/` ディレクトリだけが自分専用です。共有側の行の操作は、自分の[ワークモード](/ja/products/ai-studio/shared-folders/work-modes)が書き込める場所でのみ利用でき、それ以外では「このフォルダの共有部分には追加・編集できません — 閲覧のみです。」という理由付きで無効になります（行が無効になるのではなくファイル系のセクションそのものが消えている場合は、モードが狭いのではなく失われています。[ワークモードを失ったとき](/ja/products/ai-studio/shared-folders/work-modes#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%A2%E3%83%BC%E3%83%89%E3%82%92%E5%A4%B1%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D)を参照してください）。チャットの添付は `my/uploads/` に入るため、チームに見せる操作は明示的な移動です。行の⋯メニューの**共有側へ移動 (my/ から出す)**か、`my/` からのドラッグで行います。[自分の領域からファイルを共有する](/ja/products/ai-studio/shared-folders/using-a-shared-work-folder#%E8%87%AA%E5%88%86%E3%81%AE%E9%A0%98%E5%9F%9F%E3%81%8B%E3%82%89%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E5%85%B1%E6%9C%89%E3%81%99%E3%82%8B)を参照してください。

### MIGRATED_HOME フォルダ

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

現在の Studio はチャットごとに独立した環境を与え、永続的に保持するのは作業フォルダ内のファイルだけです。そのため、以前ホームディレクトリにあったこれらのファイルは破棄されず、作業フォルダの中へ移動されました。今後どうなるかについては[チャット終了後に残るもの](/ja/products/ai-studio/security#%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E7%B5%82%E4%BA%86%E5%BE%8C%E3%81%AB%E6%AE%8B%E3%82%8B%E3%82%82%E3%81%AE)を参照してください。

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

作業フォルダページの Files セクション。自分で作成した memory フォルダと reports フォルダの間に MIGRATED_HOME フォルダが並び、その下に生成された 3 つの HTML レポートファイルが表示されている
`MIGRATED_HOME` はアーカイブとして扱ってください。ここに書き込まれるものはもうありません。必要なものは作業フォルダの側へ移動し、残りは削除してください。作業フォルダ内の他のディレクトリと同じように扱えるため、⋯ メニューの **Delete** でこのフォルダごと中身も削除されます。

## ファイルカテゴリ

Studioはファイルを拡張子によって分類し、色分けされたアイコンで表示します。カテゴリが決めるのはアイコンだけで、どのビューアで開くかは別に決まります。そのためカテゴリとビューアが一致しない場合があります（[対応ビューアー](/ja/products/ai-studio/files/file-viewers#%E5%AF%BE%E5%BF%9C%E3%83%93%E3%83%A5%E3%83%BC%E3%82%A2%E3%83%BC)を参照）：

| カテゴリ | 拡張子 | アイコンの色 |
|  --- | --- | --- |
| **Spreadsheet** | csv, xlsx, xls, tsv | 緑 |
| **Document** | md, txt, pdf, doc, docx, html, htm | 青 |
| **Presentation** | pptx, ppt | ローズ |
| **Image** | png, jpg, jpeg, gif, svg, webp | 紫 |
| **Code** | js, ts, py, sql, sh, yaml, yml | アンバー |
| **Data** | json, xml, mmd, mermaid | 青 |
| **Journey** | *.journey.yaml, *.journey.yml | 緑 |
| **File** | その他すべての拡張子 | グレー |


## アップロードエラー

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

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

## ファイルの保持と削除

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

| シナリオ | ファイルへの影響 |
|  --- | --- |
| **作業フォルダに属さないチャットを削除した場合** | そのチャットに紐づくすべてのファイルが完全に削除されます |
| **作業フォルダチャットを削除した場合** | ファイルは**削除されません**。作業フォルダのワークスペースで引き続きアクセスできます |
| **自動期限切れ** | 作業フォルダに属さないチャットのファイルは、設定された[チャット保持期間](/ja/products/ai-studio/security/data-retention)（デフォルト: 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 フォルダ](#migrated_home-%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80)を参照してください |
| AIが作成したファイルが作業フォルダに見当たらない | 永続するのは作業フォルダ内に書き込まれたファイルだけです。AIがそれ以外の場所に書き込んだ作業用のファイルはチャットとともに消えます。そのチャットがまだ残っていれば、開いてAIに作業フォルダへ保存し直すよう頼んでください（環境にまだ残っている可能性があります）。残っていない場合は新しいチャットで再度依頼してください。[チャット終了後に残るもの](/ja/products/ai-studio/security#%E3%83%81%E3%83%A3%E3%83%83%E3%83%88%E7%B5%82%E4%BA%86%E5%BE%8C%E3%81%AB%E6%AE%8B%E3%82%8B%E3%82%82%E3%81%AE)を参照してください |


## 次のステップ

- [File Viewers](/ja/products/ai-studio/files/file-viewers) — StudioがPDF、スプレッドシート、プレゼンテーションなどをレンダリングする方法
- [共有作業フォルダを使う](/ja/products/ai-studio/shared-folders/using-a-shared-work-folder) — `my/` の境界と、ファイルを共有する方法
- [AI Chat Interface](/ja/products/ai-studio/chat/chat) — ファイルコンテキストを含むメッセージの送信
- [AI-Generated Files](/ja/products/ai-studio/files/artifacts) — PPTX、DOCX、PDF、XLSX の成果物をAIに依頼する
- [Chat Data Retention](/ja/products/ai-studio/security/data-retention) — チャット履歴と関連ファイルの保持期間の設定