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

データを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** | ビューアを画面全体に拡大または縮小します |


## ファイルカテゴリ

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に保存されたファイルには、以下の保持ルールが適用されます：

| シナリオ | ファイルへの影響 |
|  --- | --- |
| **スタンドアロンチャットを削除した場合** | そのチャットに紐づくすべてのファイルが完全に削除されます |
| **プロジェクトチャットを削除した場合** | ファイルは**削除されません** プロジェクトワークスペースにて引き続きアクセスできます |
| **自動期限切れ** | チャット開始から**28日後**に、スタンドアロンチャットに保持されたファイルは自動的に削除されます プロジェクトチャットに保持されたファイルは削除されません |


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

## Treasure Studio Labsとの違い

| 機能 | Treasure Studio Labs | Treasure AI Studio |
|  --- | --- | --- |
| **ファイルストレージ** | ローカルファイルシステム | サーバー側（クラウド） |
| **アップロード方法** | ローカルファイル参照 | ブラウザアップロード / モバイルピッカー |
| **ドラッグ＆ドロップ** | サポートあり（ローカルパス） | サポートあり（ファイルアップロード） |
| **Filesパネル** | 作業フォルダブラウザ | タブ付きビューアを備えたFilesパネル |
| **クロスデバイスアクセス** | 不可 — ローカルマシン上のファイルのみ | 可能 — ファイルはチャットごとにサーバー側に保存 |
| **ディレクトリ選択** | ローカルファイルシステムパス | オートコンプリート付き仮想ディレクトリ |


## 確認

- [ ] プラスボタンからファイルを添付し、サムネイル/ピルとして表示されることを確認する
- [ ] ファイルとともにメッセージを送信し、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）