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

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

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

## 目的

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

## 前提条件

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


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

警告
アップロードできる最大ファイルサイズは**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 yet**と**Upload files or ask the AI to generate them**というヒントが表示されます。

### ゾーンB：ファイルビューア

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

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


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

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

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


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

作業フォルダはファイルを直接公開するため、チャットを開かずに、サイドバーと専用の作業フォルダページからファイルの閲覧・名前変更・移動・アップロード・削除ができます。各[作業フォルダ](/ja/products/ai-studio/concepts#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80)は独自のファイル空間を持ち、その中のすべてのチャットで共有されます。スタンドアロンチャットは、ファイルを上記のチャットごとの Files パネルに保持します。ファイル管理は 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#%E4%BD%9C%E6%A5%AD%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80)を参照してください。 |
| **Files** | 作業フォルダのファイルとフォルダ。**Name**、**Updated**、**Size** を示すテーブルで表示されます。 |
| **Local Skills** | 作業フォルダ内の `.claude/skills/` 配下に定義されたスキル。名前と説明で一覧表示されます。 |
| **Chats** | この作業フォルダで開始された会話。作成アイコンで新しい会話を開始します。 |


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

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

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

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


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

## ファイルカテゴリ

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

| カテゴリ | 拡張子 | アイコンの色 |
|  --- | --- | --- |
| **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生成ファイルにのみ表示されます。アップロードしたファイルはFilesパネルからダウンロードできます |


## 次のステップ

- [File Viewers](/ja/products/ai-studio/files/file-viewers) — StudioがPDF、スプレッドシート、プレゼンテーションなどをレンダリングする方法
- [AI Chat Interface](/ja/products/ai-studio/chat/chat) — ファイルコンテキストを含むメッセージの送信
- [Artifact Output](/ja/products/ai-studio/files/artifacts) — AIが生成する出力ファイル（PPTX、DOCX、PDF、XLSX）
- [Chat Data Retention](/ja/products/ai-studio/security/data-retention) — チャット履歴と関連ファイルの保持期間の設定