> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/create-and-import.md).

# ワークスペースの作成とファイルのインポート

ファイルライブラリでファイルワークスペースやフォルダーを作成し、フォルダーの追加、ファイルやフォルダー全体のアップロード、アップロードパネルでの進行状況とアップロードされなかった理由の確認、不要なワークスペースやフォルダーの削除を行う方法を説明します。

ファイルは**ファイルワークスペース**に保存します。ワークスペースを作成すると、複数のファイルをまとめてアップロードしたり、パソコン内のフォルダーをサブフォルダーごとアップロードしたりできます。ワークスペース内にフォルダーを作成して分類することもできます。

## 利用シーン <a href="#use-case" id="use-case"></a>

マーケティング担当者が新製品のキャンペーンを引き継ぎましたが、関連ファイルはメールの添付ファイル、クラウドドライブ、同僚のパソコンに分散しています。担当者は <mark style="color:blue;">マイファイル</mark> に「新製品キャンペーン」ワークスペースを作成し、同僚が整理した素材のフォルダーをそのままワークスペースにドラッグします。サブフォルダーの階層はそのまま保たれます。続いてツールバーから <mark style="color:blue;">ファイルをアップロード</mark> を選び、仕様書と 11 MB の製品カタログ PDF をまとめて選択します。アップロードは右下のパネルで進むため、待っている間に他のフォルダーを整理できます。パネルには、フォルダー内の 0 KB の空のファイルがアップロードされなかったことが表示されるので、同僚に正しいファイルを依頼します。以後、資料を探すときも、AI に整理を依頼するときも、このワークスペースから始められます。

***

## ファイルワークスペースの作成 <a href="#create-workspace" id="create-workspace"></a>

### 1. スペースを選択する <a href="#select-space" id="select-space"></a>

左側のメニューで <mark style="color:blue;">ファイルライブラリ</mark> をクリックし、スペースツリーで保存先を選択します。個人用の資料は <mark style="color:blue;">マイファイル</mark>、組織全体で使う資料は <mark style="color:blue;">組織共有ファイル</mark>（組織スペースの編集権限が必要です）、部門をまたいで使う資料は該当する [共有スペース](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/shared-spaces.md) を選択します。

### 2. ファイルワークスペースを追加する <a href="#add-workspace" id="add-workspace"></a>

スペースツリーの上にある <mark style="color:blue;">ファイルワークスペースを追加</mark> をクリックし、<mark style="color:blue;">場所</mark> を確認します。<mark style="color:blue;">ファイルワークスペース名</mark> を入力して <mark style="color:blue;">作成</mark> をクリックすると、新しいワークスペースがスペースツリーと一覧にすぐに表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-47ece4307d57991c2755a97a3cdc3b1734a00bf6%2Ffile-library-create-workspace.png?alt=media" alt="ファイルワークスペースの追加ダイアログ。場所にマイファイルが選択され、ファイルワークスペース名が入力されています"><figcaption><p>ダイアログにはワークスペースの作成先が表示されます</p></figcaption></figure>

{% hint style="info" %}
スペースの最上位にはワークスペースのみ作成でき、ファイルを直接アップロードすることはできません。スペースのルートでは、アップロードメニューの <mark style="color:blue;">ファイルをアップロード</mark> が無効になるため、先にワークスペースを開くか、作成してください。<mark style="color:blue;">フォルダーをアップロード</mark> は引き続き使用でき、アップロードしたフォルダーはそのままファイルワークスペースになります。
{% endhint %}

### 3. フォルダーを追加する（任意） <a href="#add-folder" id="add-folder"></a>

ワークスペース内で <mark style="color:blue;">フォルダーを追加</mark> をクリックすると、さらに分類できます。フォルダーの階層は、スペースのルートから数えて最大 10 階層です。

***

## ファイルとフォルダーのアップロード <a href="#import-files" id="import-files"></a>

ファイルとフォルダーは、ワークスペース（またはワークスペース内のフォルダー）にアップロードします。ファイルを選択するとすぐにアップロードが始まり、進行状況は画面右下のアップロードパネルに表示されます。アップロード中も、ファイルライブラリの閲覧や整理を続けられます。

### アップロードの入口 <a href="#upload-entry" id="upload-entry"></a>

* **ツールバー**：ワークスペースまたはフォルダーを開き、ツールバーのアップロードアイコンをクリックして、<mark style="color:blue;">ファイルをアップロード</mark> または <mark style="color:blue;">フォルダーをアップロード</mark> を選択します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-5a61bfcd6765fcf7cc1673a54d5fd09871a81171%2Ffile-library-upload-menu.png?alt=media" alt="ファイルライブラリのツールバーにあるアップロードメニュー。ファイルをアップロードとフォルダーをアップロードが表示されています"><figcaption><p>ツールバーのアップロードボタンから、ファイルまたはフォルダーのアップロードを選べます</p></figcaption></figure>

* **フォルダーの右クリックメニュー**：一覧、サムネイル、左側のスペースツリーにあるフォルダーを右クリックすると、メニューの 1 行目にフォルダー名が表示されます。<mark style="color:blue;">ファイルをアップロード</mark>、<mark style="color:blue;">フォルダーをアップロード</mark>、<mark style="color:blue;">フォルダーを追加</mark> のいずれかを選ぶと、フォルダーを開かなくても、そのフォルダーに追加されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0a6ccc76d2c8c3fa0a1e91add1fdfbf466eaa09c%2Ffile-library-folder-context-menu.png?alt=media" alt="「見積」フォルダーを右クリックした状態。メニューの 1 行目はフォルダー名で、その下にファイルをアップロード、フォルダーをアップロード、フォルダーを追加、名前の変更、削除が表示されています"><figcaption><p>右クリックメニューのアップロードとフォルダーの追加は、このフォルダーが対象になります</p></figcaption></figure>

* **ドラッグ＆ドロップ**：パソコンからファイルやフォルダーをファイル一覧に直接ドラッグします。ドロップする前に、アップロード先が画面に表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-d35e3ff799d063842bbae5b5878cf36b5ae687de%2Ffile-library-upload-drop.png?alt=media" alt="フォルダーをファイル一覧にドラッグすると、一覧の枠が点線になり、下に「デモ用アップロード手順（架空）」へアップロードされることを示すメッセージが表示されています"><figcaption><p>ドラッグ中は、ドロップ後のアップロード先が表示されます</p></figcaption></figure>

{% hint style="info" %}
無効になっているオプションは、マウスを重ねると理由が表示されます。たとえば、スペースのルートにはファイルを直接アップロードできません。外部ソースから同期されたフォルダーは読み取り専用で、右クリックメニューに鍵アイコンが表示され、ファイルのアップロード、フォルダーのアップロード、フォルダーの追加がすべて無効になります。
{% endhint %}

### ファイルのアップロード <a href="#upload-files" id="upload-files"></a>

<mark style="color:blue;">ファイルをアップロード</mark> を選択すると、パソコンのファイル選択ウィンドウが開き、複数のファイルをまとめて選択できます。選択するとすぐにアップロードが始まり、確認の操作は不要です。ファイルは 1 件ずつアップロードパネルに表示され、同時にアップロードされるのは最大 3 ファイルです。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-3d052e32ce61ed9c67460f0bdb8663b736db1a83%2Ffile-library-upload-queue.png?alt=media" alt="タイトルが「1 件をアップロード中」のアップロードパネル。PDF 1 件が進行バーとともにアップロード中で、空のメモ.txt と編集マニュアル.epub が理由付きでアップロードされなかったと表示されています"><figcaption><p>アップロードパネルにはファイルごとの進行状況が表示され、アップロードされなかったファイルには理由が表示されます</p></figcaption></figure>

パネルに表示されるファイルの状態は次のとおりです。

| 状態            | 説明                                                                                                                                                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| アップロード待ち      | 順番待ちです。前のファイルが終わると開始します                                                                                                                                                                                                   |
| アップロード中       | アップロード中です。下に進行バーが表示されます                                                                                                                                                                                                   |
| 一時停止・ネットワーク待ち | ネットワークが切断されています。接続が回復すると自動的に再開します                                                                                                                                                                                         |
| 一時停止          | 一時停止した状態です。<mark style="color:blue;">再開</mark> をクリックすると続きからアップロードします                                                                                                                                                      |
| アップロード済み      | アップロードが完了しました。マウスを重ねて <mark style="color:blue;">ファイルの場所を表示</mark> をクリックできます                                                                                                                                               |
| 未アップロード       | ファイルが送信されなかった、または受け付けられませんでした。下に理由が表示されます                                                                                                                                                                                 |
| アップロード失敗      | アップロードされなかったファイルがあり、パネルの上部に「N 件のファイルのアップロードに失敗しました」と表示されます。送信中に切断され、自動で数回再送しても失敗した場合は、<mark style="color:blue;">再試行</mark> をクリックして再送できます。ファイル自体が規定を満たしていない場合（たとえば空のファイルや未対応の形式）は再試行ボタンが表示されないため、ファイルを修正してからアップロードし直してください |
| キャンセル済み       | このファイルのアップロードをキャンセルしました                                                                                                                                                                                                   |

### フォルダー全体のアップロード <a href="#upload-folder" id="upload-folder"></a>

<mark style="color:blue;">フォルダーをアップロード</mark> を選択してパソコン内のフォルダーを選ぶか、フォルダーをファイル一覧に直接ドラッグします。フォルダーはサブフォルダーの階層ごと作成され、アップロードパネルでは 1 行を占めて「アップロード済み / 合計 件のファイル」と表示されます。アップロードされなかったファイルがある場合は、「N 件のファイルが未アップロード」を開くと、各ファイルのパスと理由を確認できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ec5a1f055b15a8227a43b8fcdec5922d968700b5%2Ffile-library-upload-folder-result.png?alt=media" alt="アップロードパネルのデモプロジェクト資料フォルダー。3 / 5 件のファイルと表示され、展開すると未アップロードの 2 件が表示されています。編集マニュアル.epub は未対応の形式、空のメモ.txt はファイルが空です"><figcaption><p>フォルダーは 1 行で表示され、展開するとアップロードされなかったファイルとその理由を確認できます</p></figcaption></figure>

フォルダーをアップロードするときの動作は次のとおりです。

* 隠しファイルや隠しフォルダー（たとえば `.git`、`.DS_Store`）、およびシステムが生成する `Thumbs.db` と `desktop.ini` は自動的にスキップされ、未アップロードとしては表示されません。
* 未対応の形式のファイル、サイズ上限を超えるファイル、空（0 KB）のファイルは送信されず、その行の未アップロード一覧に表示されます。その行には「アップロード失敗」と表示されますが、他のファイルは通常どおりアップロードが完了します。サブフォルダーにこのようなファイルしかない場合、そのサブフォルダーは作成されません。
* アップロード先に同名のフォルダーがすでにある場合は、フォルダー全体がアップロードされず、「同じ名前のフォルダーがすでにあります」と表示されます。先に名前を変更してからアップロードしてください。

{% hint style="info" %}
**空のフォルダーが作成されるのは、ドラッグ＆ドロップの場合だけです。** <mark style="color:blue;">フォルダーをアップロード</mark> で選択すると、ブラウザーはファイルの一覧しか渡さないため、ファイルが入っていないフォルダーはファイルライブラリに表示されません。空のフォルダーを残したいときは、パソコンからフォルダーをファイル一覧に直接ドラッグしてください。`.DS_Store` などの隠しファイルだけが入ったフォルダーは空のフォルダーとは見なされず、作成されません。
{% endhint %}

### アップロード中の操作 <a href="#during-upload" id="during-upload"></a>

* **一時停止とキャンセル**：アップロード中の項目は <mark style="color:blue;">一時停止</mark> でき、あとで <mark style="color:blue;">再開</mark> をクリックして続けられます。アップロードをやめる場合は <mark style="color:blue;">アップロードをキャンセル</mark> をクリックします。未アップロードまたは失敗した項目は、<mark style="color:blue;">削除</mark> をクリックするとパネルから消せます。
* **ネットワークの切断**：アップロードが一時停止し、パネルに「ネットワーク接続が切断されました。回復すると自動的に再開します」と表示されます。接続が回復すると中断した位置から続行するため、ファイルを選び直す必要はありません。応答がなかったファイルは自動で数回再送され、それでも失敗した場合にだけ「アップロード失敗」と表示されます。
* **パネルを閉じる**：アップロード中または待機中の項目がある場合は、先に「アップロードをキャンセルしますか？」と確認されます。すべて完了している場合は、そのままパネルが折りたたまれます。
* **ファイルライブラリから移動する**：アップロード中または待機中の項目がある状態で、他のページや他の組織に切り替えると、先に「ファイルライブラリから移動しますか？」と表示されます。<mark style="color:blue;">アップロードを続ける</mark> をクリックすると、そのページにとどまってアップロードが続行されます。<mark style="color:blue;">移動してアップロードをキャンセル</mark> をクリックすると、未完了の項目をキャンセルして移動します。タブを閉じたりページを再読み込みしたりするときも、ブラウザーが先に確認を表示します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-41dcf00fcfbcecead9a92d75c9732532b61d3250%2Ffile-library-upload-leave-confirm.png?alt=media" alt="「ファイルライブラリから移動しますか？」の確認ダイアログ。アップロード中と待機中の項目がキャンセルされることが説明され、アップロードを続けるボタンと移動してアップロードをキャンセルするボタンが表示されています"><figcaption><p>ファイルのアップロード中にファイルライブラリから移動しようとすると、先に確認が表示されます</p></figcaption></figure>

### 対応形式とファイルサイズ <a href="#supported-formats" id="supported-formats"></a>

| 種類     | 形式                                                  |
| ------ | --------------------------------------------------- |
| ドキュメント | PDF、DOC、DOCX、PPT、PPTX、XLS、XLSX、CSV、TXT、MD、JSON、HTML |
| 画像     | PNG、JPG、JPEG、GIF、WebP                               |
| 音声と動画  | MP3、WAV、M4A、MP4                                     |

ファイルのアップロードとフォルダーのアップロードの上限は、1 ファイルあたり **500 MB** です。空（0 KB）のファイルはアップロードできません。ファイルの詳細にある <mark style="color:blue;">新しいバージョンをアップロード</mark> の上限は、引き続き 1 ファイルあたり 10 MB です。詳しくは [オンライン編集](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/online-editing.md) をご覧ください。

ファイルがアップロードされなかった場合は、アップロードパネルに理由が表示されます。

| 理由                         | 対処方法                           |
| -------------------------- | ------------------------------ |
| ファイルが空（0 KB）               | ファイルの内容を確認して、もう一度アップロードします     |
| 未対応の形式（.拡張子）               | 上の表にある対応形式に変換します               |
| 1 ファイルあたりの上限 500 MB を超えている | ファイルを圧縮または分割します                |
| このフォルダーに同名のファイルがすでにある      | 先に名前を変更するか、フォルダー内の古いファイルを削除します |
| ストレージの空き容量が不足している          | 不要なファイルを削除するか、組織の管理者に連絡します     |

***

## ワークスペースやフォルダーの削除 <a href="#delete-workspace-or-folder" id="delete-workspace-or-folder"></a>

ワークスペースのカードやフォルダーを右クリックするか、<mark style="color:blue;">⋯</mark> をクリックし、<mark style="color:blue;">削除</mark> を選択します。

{% hint style="warning" %}
削除できるのは**空の**ワークスペースやフォルダーのみです。先に中のファイルを削除するか、移動してください。ワークスペースを削除すると、その配下の空のフォルダー、ワークスペースのガイド、バージョン履歴も削除されます。スペースのルートや <mark style="color:blue;">一時保存領域</mark> などのシステムフォルダーは削除できません。
{% endhint %}

***

## 関連ページ <a href="#related" id="related"></a>

* [検索、絞り込み、ファイルの詳細](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/search-and-details.md)
* [MaiGPT でワークスペースを使う](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/use-in-maigpt.md)
* [バージョン履歴と復元](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/versions.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/create-and-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
