> 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.md).

# ファイルライブラリ

ファイルライブラリは組織のファイルを集約する場所です。ファイルワークスペースでプロジェクトごとの文書を整理し、MaiGPT が直接読み取り・編集できます。すべての変更にバージョン履歴が残り、復元できます。

**ファイルをまとめて、AI がそのまま活用します。**

ファイルライブラリは、組織のファイルを集約する場所です。プロジェクトの仕様書、見積書、FAQ、議事録を同じ**ファイルワークスペース**に入れ、そのワークスペースから MaiGPT の会話を直接開始できます。AI は必要なファイルを自分で見つけ、全体を読んでから回答します。確認後にファイルを直接編集することもできます。AI が生成した文書や画像はファイルライブラリに自動保存されます。アップロード、編集、移動、削除はすべてバージョン履歴に記録され、ワンクリックで復元できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9d34769d4069ac95c86d43726137d31f7367af62%2Ffile-library-overview.png?alt=media" alt="ファイルライブラリの標準パネル：左側に個人・組織・共有・システムの各スペース、右側にデモ用ワークスペース内の2つのファイルを表示"><figcaption><p>左側でワークスペースを選択すると、右側でファイル名、サイズ、更新日時、ソースを確認できます。ここから会話を開始することもできます。画像内の内容はすべて架空のデモデータです。</p></figcaption></figure>

***

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

営業担当者が新製品の発売提案を準備しています。<mark style="color:blue;">マイファイル</mark>に「A1 発売提案」ワークスペースを作成し、仕様書、見積書、FAQ、顧客インタビューの記録をまとめてインポートします。次に、ワークスペースで<mark style="color:blue;">ここから会話を開始</mark>をクリックし、MaiGPT に「Q3 の見積書にあるプランの違いを整理してください」と依頼します。AI は見積書を自分で見つけ、ファイル全体を読んで比較表を作成し、どの文書に基づく情報かも示します。さらに、FAQ の3つ目の質問にある保証期間を2年に変更するよう依頼します。担当者が確認すると、AI がファイルに直接書き込み、バージョン履歴に「会話内で担当者が確認した」という記録が残ります。後で間違いに気づいた場合は、バージョン一覧を開いて復元できます。

***

## ファイルライブラリのスペース <a href="#spaces" id="spaces"></a>

左側のスペースツリーは、次の4つに分かれています。

| スペース                  | 閲覧できる人               | 用途                                                                                                 |
| --------------------- | -------------------- | -------------------------------------------------------------------------------------------------- |
| **個人スペース › マイファイル**   | 自分のみ                 | 個人の作業用ファイルです。AI が生成したファイルは、その中の<mark style="color:blue;">一時保存領域</mark>に自動保存されます                    |
| **組織スペース › 組織共有ファイル** | 組織スペースの閲覧権限を持つメンバー   | 製品文書やブランド素材など、組織全体で共有する資料です                                                                        |
| **共有スペース**            | 許可されたロールに応じてアクセス可能   | 部門をまたいで利用するフォルダーです。詳しくは[共有スペース](/maiagent-user-guide/ja/work/file-library/shared-spaces.md)をご覧ください |
| **システム › 会話の添付ファイル**  | 自分（組織オーナーは組織全体を閲覧可能） | 参加した会話の添付ファイルのうち、ワークスペースにまだ整理されておらず、課金が続いているものを表示します。ダウンロードや早期削除ができます                              |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ee60e7c521d1f5894315550c4c65b993519eb9ef%2Ffile-library-spaces.png?alt=media" alt="ファイルライブラリ左側のスペースツリー：個人スペース、組織スペース、共有スペース、システム"><figcaption><p>スペースツリーは「個人スペース、組織スペース、共有スペース、システム」に分かれています。</p></figcaption></figure>

スペースの最上位には**ファイルワークスペース**のみ作成でき、ファイルを直接アップロードすることはできません。ファイルはすべて、ワークスペースまたはその中のフォルダーに保存します。

***

## ファイルワークスペースとは <a href="#workspace" id="workspace"></a>

ファイルワークスペースは、関連するファイルをまとめたフォルダーです。通常はプロジェクト、顧客、トピックごとに作成します。ワークスペースには次の3つの特徴があります。

* **AI の作業範囲**：ワークスペースで<mark style="color:blue;">ここから会話を開始</mark>をクリックすると、そのワークスペースが MaiGPT に接続され、中のファイルを読み取り・編集できます。
* **ワークスペースのガイド**：システムが「このワークスペースに何があり、どう使うか」を説明するガイドを自動作成します。AI は回答時にその内容を参照します。
* **バージョン履歴**：ワークスペース内のすべての変更が記録され、ワンクリックで復元できます。

***

## ファイルライブラリとナレッジベースの違い <a href="#vs-knowledge-base" id="vs-knowledge-base"></a>

[ナレッジベース](/maiagent-user-guide/ja/build/knowledge-base/km.md)は、試験で使うカンニングペーパーのようなものです。内容をあらかじめチャンクに分割し、Agent がすばやく答えを見つけてユーザーに回答できるため、外部向けのカスタマーサポートや FAQ に適しています。ファイルライブラリは、宿題をするときに手元に置く教科書全体のようなものです。AI が元ファイル全体を読み、執筆、集約、書き直しを支援します。ファイルの編集やバージョンの保存もできます。

「答えを探す」ならナレッジベース、「ファイルを扱う」ならファイルライブラリを使います。利用シーン、よくある誤用、判断表、両者の併用方法については、[ナレッジベース vs ファイルライブラリ：用途の違いと使い分け](/maiagent-user-guide/ja/work/file-library/vs-knowledge-base.md)をご覧ください。

***

## 有効化と権限 <a href="#availability-and-permissions" id="availability-and-permissions"></a>

ファイルライブラリは、デフォルトでは**オーナーのみ操作できます**。メンバーに利用を許可するには、オーナーまたはロール管理権限を持つ人がカスタムロールを作成し、必要なファイルライブラリ権限を選択して、そのロールにメンバーを追加してください。デフォルトのロールではファイルライブラリ権限を付与できません。メンバーが利用できるスペースは、所属するカスタムロールのファイルライブラリ権限で決まります。

| 権限               | 制御する範囲                                                         |
| ---------------- | -------------------------------------------------------------- |
| **ファイルライブラリ権限**  | 左側メニューに<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-d83cf25adcc0559c0ea7a948457e8875afc70fb0%2Ffile-library-role-permissions.png?alt=media" alt="ロール権限ページのファイルライブラリ権限セクション。6つの権限を表示"><figcaption><p>ロール権限ページでファイルライブラリ権限を選択します。</p></figcaption></figure>

設定方法は[ロール・権限管理](/maiagent-user-guide/ja/org/roles/role-permission.md#permission-structure-overview)をご覧ください。閲覧権限のみのメンバーに対しても、MaiGPT はファイルを読み取れますが、編集は行いません。

ファイルライブラリ権限を一切持たないメンバーには、左側メニューにファイルライブラリが表示されません。ファイルライブラリの URL を直接開くと、「現在、ファイルライブラリの権限がありません。組織管理者にお問い合わせください」と表示されます。MaiGPT の会話では、ファイルライブラリのマウントや添付の操作が無効になります。

***

## 利用制限 <a href="#limits" id="limits"></a>

| 項目         | 制限                                                                                        |
| ---------- | ----------------------------------------------------------------------------------------- |
| 1ファイルのサイズ  | 10 MB                                                                                     |
| 対応形式       | PDF、DOC、DOCX、PPT、PPTX、XLS、XLSX、CSV、TXT、MD、JSON、HTML、PNG、JPG、JPEG、GIF、WebP、MP3、WAV、M4A、MP4 |
| フォルダーの階層数  | 最大10階層                                                                                    |
| 一括移動・削除    | 1回につき最大200ファイル                                                                            |
| ファイルのバージョン | 各ファイルの最新20バージョンを保持します                                                                     |

保存料金は[Credits の課金制度：ファイルライブラリのストレージ料金](/maiagent-user-guide/ja/others/credits.md#file-library-storage)をご覧ください。

***

## 次のステップ <a href="#next-steps" id="next-steps"></a>

* [ワークスペースの作成とファイルのインポート](/maiagent-user-guide/ja/work/file-library/create-and-import.md)
* [検索、フィルター、ファイルの詳細](/maiagent-user-guide/ja/work/file-library/search-and-details.md)
* [MaiGPT でワークスペースを使う](/maiagent-user-guide/ja/work/file-library/use-in-maigpt.md)
* [AI にファイルの編集・整理を依頼する](/maiagent-user-guide/ja/work/file-library/ai-edit.md)
* [バージョン履歴と復元](/maiagent-user-guide/ja/work/file-library/versions.md)
* [共有スペース](/maiagent-user-guide/ja/work/file-library/shared-spaces.md)
* [オンライン編集](/maiagent-user-guide/ja/work/file-library/online-editing.md)
* [ナレッジベース vs ファイルライブラリ：用途の違いと使い分け](/maiagent-user-guide/ja/work/file-library/vs-knowledge-base.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.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.
