> 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/use-in-maigpt.md).

# MaiGPT でワークスペースを利用する

ファイルのワークスペースから MaiGPT の会話を開始し、AI がファイルを探して全文を読んでから回答する方法を説明します。ワークスペースガイド、会話の添付ファイルの自動格納、AI が生成したファイルの自動保存の仕組みも紹介します。

ワークスペースを MaiGPT に接続すると、ファイルを一つずつアップロードする必要がなくなります。AI が質問に応じてファイルを探し、全文を読んでから、出典を示して回答します。会話中にアップロードした添付ファイルや AI が生成したファイルも、ファイルライブラリに自動保存されます。

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

営業担当者が「A1 上場提案」ワークスペースで <mark style="color:blue;">ここから会話を開始</mark> をクリックします。まず「このワークスペースにはどのようなファイルがありますか？」と質問して AI が参照できる範囲を確認し、続けて「Q3 見積書のプランの違いをまとめてください」と依頼します。AI は見積書を読み、比較表を作成します。顧客から新しい要件書が届いたら、そのまま会話にドラッグすると、「『A1 上場提案』に格納しました」と表示されます。続いて、仕様書と新しい要件に基づいて提案書の構成案を Word ファイルで作成するよう AI に依頼すると、ファイルが担当者の一時保存領域に自動保存され、詳細には元のワークスペースと会話が表示されます。

***

## ワークスペースから会話を開始する <a href="#start-chat" id="start-chat"></a>

### 1. ここから会話を開始 <a href="#start-from-workspace" id="start-from-workspace"></a>

ファイルライブラリで使用するワークスペースを開き、<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-9f16f323c0c88d68d18152cfccf04e075a7aaeaf%2Ffile-library-start-chat.png?alt=media" alt="ワークスペース上部の「ここから会話を開始」ボタン"><figcaption><p>「ここから会話を開始」はワークスペースの一覧の上にあります</p></figcaption></figure>

### 2. ワークスペースの接続を確認する <a href="#workspace-mounted" id="workspace-mounted"></a>

MaiGPT が開くと、入力欄の下にワークスペースのタグ（例：「A1 上場提案」）が表示されます。この会話にワークスペースが接続されていることを示します。タグの横の <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-59acf502eacf4cb74dfc00e95e0571dbb0ceb44c%2Ffile-library-maigpt-mounted.png?alt=media" alt="MaiGPT の入力欄の下に表示された接続中のワークスペースのタグ"><figcaption><p>入力欄の下に表示されるワークスペースのタグです</p></figcaption></figure>

{% hint style="info" %}

* 一つの会話に接続できるワークスペースは一度に一つです。
* ファイルの詳細で <mark style="color:blue;">会話を開始</mark> をクリックするか、複数のファイルを選択して <mark style="color:blue;">会話を開始</mark> をクリックすると、選択したファイルだけを会話に取り込めます。
  {% endhint %}

***

## AI にファイルを読んで回答してもらう <a href="#ai-reads-files" id="ai-reads-files"></a>

ワークスペースを接続したら、ファイル名や内容の説明を使って直接質問できます。

| 質問の例                          | AI の動作                         |
| ----------------------------- | ------------------------------ |
| 「このワークスペースにはどのようなファイルがありますか？」 | フォルダとファイルを一覧表示し、参照できる範囲を確認できます |
| 「Q3 見積書のプランの違いをまとめてください」      | 見積書を探して全文を読み、出典を示して回答します       |
| 「仕様書と競合製品のプレゼン資料の違いを比較してください」 | 必要に応じて複数のファイルを読んでから、違いをまとめます   |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-76bfa236d19a88636d2fc0ca8ea7ce9a12f69af8%2Ffile-library-maigpt-read.png?alt=media" alt="AI が Q3 見積書を読んでプランの比較表を作成し、入力欄の上にワークスペースからの添付ファイルが表示されています"><figcaption><p>AI が読んだファイルを表示します。読んだファイルは「ワークスペースから」と表示された添付ファイルとして示されます</p></figcaption></figure>

ファイルの読み取りには、次のルールがあります。

* **一度に読み取れるファイルは最大 5 件です**。それ以上のファイルが必要な場合は、複数回に分けて質問してください。
* **解析中または解析に失敗したファイルは読み取れません**。解析が完了してから質問してください。
* **ファイル名が曖昧な場合**、AI はどのファイルかを先に確認します。
* **ワークスペース内の項目が 300 件を超える場合**、AI はまずフォルダ単位の概要を参照し、質問に応じて下の階層を探します。
* 閲覧権限のみのメンバーでも AI にファイルを読んでもらえますが、AI がファイルを変更することはありません。

***

## ワークスペースガイド <a href="#workspace-guide" id="workspace-guide"></a>

各ワークスペースには <mark style="color:blue;">ワークスペースガイド</mark> があり、保存されている内容や各ファイルの用途を説明しています。AI は回答時にこのガイドを参照します。ワークスペースを開き、上部のツールバーにある <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-7e44520401145484a5766f50ccee59803925f4eb%2Ffile-library-instructions-entry.png?alt=media" alt="ワークスペース上部のツールバー。ドキュメントのアイコンにポインターを合わせると、ワークスペースガイドのヒントが表示されます"><figcaption><p>ワークスペースガイドは「ここから会話を開始」の右側のツールバーにあります</p></figcaption></figure>

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

営業担当者が「A1 上場提案」のワークスペースガイドを開くと、見積書と仕様書に基づいてシステムがファイルマップを整理済みであることが確認できます。見積に関する回答で AI にもう一つ注意事項を加えさせたいので、<mark style="color:blue;">編集</mark> をクリックして「見積は Q3 見積書を基準とし、有効期限が過ぎている場合はユーザーに注意を促す」と追記します。まず入力欄の下の <mark style="color:blue;">保存</mark> をクリックして下書きを確定し、続いてウィンドウ右下の <mark style="color:blue;">保存</mark> をクリックすると、「ワークスペースガイドを保存しました」と表示され、ガイドの横に担当者の名前と更新日時が記録されます。数日後、同僚が競合製品の比較資料をアップロードしました。担当者が再びガイドを開くと、更新案が生成されたことを示す通知が表示されています。<mark style="color:blue;">更新案を適用</mark> をクリックして新しい内容を先に確認し、問題がなければ <mark style="color:blue;">保存</mark> をクリックすると、ガイドは自動メンテナンスに戻ります。

### ガイドを確認する <a href="#view-workspace-guide" id="view-workspace-guide"></a>

ウィンドウの上部にガイドの内容が表示され、右側に最終更新の情報が表示されます。

* **システムが自動更新したガイド**：<mark style="color:blue;">最終更新：</mark> と日時のみが表示されます。
* **右下の保存ボタンで保存されたガイド**（更新案を適用して保存した場合を含む）：日時の前に最後に保存した人の名前が付き、たとえば「王小明・最終更新：2026-10-25 10:51:55」と表示されます。システムが次にガイドを自動更新するまで、この表示が続きます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-863dd7cef93a69ce2a4ff8eee5c5de59227f8c8c%2Ffile-library-instructions-auto.png?alt=media" alt="ワークスペースガイドのウィンドウ。システムが整理したファイルマップと参照方針が表示され、右上には最終更新日時のみが表示され、右下の保存ボタンは無効になっています"><figcaption><p>自動更新されたガイドには更新日時のみが表示されます。まだ変更していない場合は保存できません</p></figcaption></figure>

ガイドにまだ内容がない場合（たとえばワークスペースにファイルがない場合）は、「ワークスペースガイドが未設定です。「再生成」をクリックすると、AI が既存のファイルに基づいて提案を生成します」と表示されます。

### 編集、保存、キャンセル <a href="#edit-workspace-guide" id="edit-workspace-guide"></a>

ガイドの変更は二段階です。まずウィンドウ内で下書きを編集し、最後に右下の <mark style="color:blue;">保存</mark> をクリックして初めて実際に書き込まれます。

{% stepper %}
{% step %}

### 下書きを編集する <a href="#edit-draft" id="edit-draft"></a>

<mark style="color:blue;">編集</mark> をクリックすると、内容が入力可能なテキストボックスに変わります。編集が終わったら、テキストボックスの下の <mark style="color:blue;">保存</mark> をクリックします。これはウィンドウ内の下書きが更新されるだけで、まだワークスペースには書き込まれません。編集中は右下の <mark style="color:blue;">保存</mark> が無効になるため、先に編集を終了してください。
{% endstep %}

{% step %}

### 確認して保存する <a href="#save-guide" id="save-guide"></a>

下書きが現在の内容と異なる場合にのみ、右下の <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-ad14cbc225db14aca341af562c15fb9c86acf3b4%2Ffile-library-instructions-draft.png?alt=media" alt="ワークスペースガイドのウィンドウ。回答方針のセクションを追加した下書きが表示され、右下の保存ボタンをクリックできます"><figcaption><p>下書きを編集すると、右下の保存をクリックできるようになります</p></figcaption></figure>
{% endstep %}
{% endstepper %}

途中で変更をやめたい場合は、<mark style="color:blue;">キャンセル</mark> をクリックしてウィンドウを閉じます。下書きはそのまま破棄され、ガイドは元の内容のままです。

* **手動で保存した後は自動で上書きされません**：一度保存したガイドは、その後ファイルに変更があってもシステムが直接書き換えることはなく、更新案を生成します。詳しくは次の節をご覧ください。
* **再生成**：<mark style="color:blue;">再生成</mark> をクリックすると、システムが現在のファイルに基づいてガイドを書き直し、下書きに入れて「新しいガイドの提案を生成しました」と表示します。右下の <mark style="color:blue;">保存</mark> をクリックすると保持され、<mark style="color:blue;">キャンセル</mark> をクリックすると何も変更されません。

### 更新案を適用する <a href="#apply-suggestion" id="apply-suggestion"></a>

ガイドが手動で変更されていない場合は、ファイルのインポート、移動、削除、添付ファイルの格納後に、システムがガイドを自動で書き直します。短時間に複数の変更があった場合は、一度の更新にまとめられます。バージョン履歴には <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-7e38ed29321fc12ea3da0ce146cd3fcc53646480%2Ffile-library-instructions-pending.png?alt=media" alt="ワークスペースガイドのウィンドウ。上部にファイルの変更を検出したことを示す黄色の通知と「更新案を適用」ボタンが表示され、右側には最後に保存した人の名前（マスク済み）と最終更新日時が表示されています"><figcaption><p>手動で保存したガイドでファイルに変更があると、代わりに更新案が通知されます</p></figcaption></figure>

1. 通知内の <mark style="color:blue;">更新案を適用</mark> をクリックします。提案内容が下書きに入り、先に確認できます。この時点ではまだ書き込まれていません。
2. 問題がなければ、右下の <mark style="color:blue;">保存</mark> をクリックします。適用後、ガイドは自動メンテナンスに戻り、以降のファイルの変更は直接反映されます。システムが次に自動更新するまでは、ガイドの横にあなたの名前と保存日時が表示されたままです。
3. 先に提案内容を修正したい場合は、<mark style="color:blue;">編集</mark> をクリックして調整してから保存します。この場合は手動での保存として扱われ、ガイドは自動メンテナンスに戻りません。

{% hint style="warning" %}
手動で保存しても、この更新案は消えません。提案を修正して保存した場合も、更新案に対応せずに直接編集して保存した場合も、ウィンドウ上部の通知は表示され続けます。この状態で <mark style="color:blue;">更新案を適用</mark> をクリックすると、提案内容によって、直前に保存した変更が上書きされます。適用する前に必ず確認してください。
{% endhint %}

{% hint style="info" %}
更新案を確認している間に、システムが新しいファイルの変更に基づいて更新案を更新した場合、<mark style="color:blue;">保存</mark> をクリックすると「更新案が更新されました。最新の内容を確認してから保存してください」と表示され、ウィンドウに最新の内容が読み込まれます。もう一度確認してから適用してください。
{% endhint %}

### 権限 <a href="#workspace-guide-permissions" id="workspace-guide-permissions"></a>

* <mark style="color:blue;">編集</mark>、<mark style="color:blue;">再生成</mark>、<mark style="color:blue;">更新案を適用</mark>、<mark style="color:blue;">保存</mark> が表示されるのは、そのスペースの編集権限がある場合のみです。
* 閲覧権限のみのメンバーは、ワークスペースガイドを開いて内容を確認できますが、変更はできません。

***

## 会話の添付ファイルを自動で格納する <a href="#attachment-filing" id="attachment-filing"></a>

ワークスペースが接続されている会話にファイルをアップロードすると、現在のワークスペースに自動で格納され、画面右上に「『ワークスペース名』に格納しました」と表示されます。格納先を間違えた場合は、通知内の <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-60f0cee512442e5ac7af7f17e10970707b979354%2Ffile-library-attachment-archived.png?alt=media" alt="会話に添付ファイルをアップロードすると、「A1 上場提案」に格納した通知と「元に戻す」ボタンが表示されます"><figcaption><p>格納の通知は操作するまで表示され続けます</p></figcaption></figure>

別のワークスペースに格納したい場合は、「このファイルを顧客案件ワークスペースに入れてください」のように、メッセージで直接指定します。指定したワークスペースが見つからない場合や、書き込み権限がない場合は、ファイルは現在のワークスペースに残り、その理由が通知されます。

***

## AI が生成したファイルを自動保存する <a href="#agent-output" id="agent-output"></a>

AI が会話中に生成したドキュメント、画像、動画は、<mark style="color:blue;">マイファイル</mark> 内の <mark style="color:blue;">一時保存領域</mark> に自動保存されます。別途ダウンロードして整理する必要はありません。

* **右側の Output 一覧**：会話の右側パネルの <mark style="color:blue;">Output</mark> に、その会話で生成されたファイルが時系列で表示されます。プレビューとダウンロードが可能です。<mark style="color:blue;">ファイルライブラリで開く</mark> をクリックすると、ファイルがあるフォルダに移動し、ファイルの詳細が開きます。
* **ファイルの詳細**：一時保存領域で生成されたファイルを開くと、詳細の <mark style="color:blue;">ソース</mark> に <mark style="color:blue;">Agent 生成</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-c3c1a0b7ec28751ead6ea10af6e7f3b9e17cb43b%2Ffile-library-output-panel.png?alt=media" alt="MaiGPT の右側パネルの Output 一覧に、AI が生成した Word ファイルが表示されています"><figcaption><p>右側パネルの Output 一覧です</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-868b4ed5cd33dc10a9f3f72c4446812e16fe4fce%2Ffile-library-agent-output-detail.png?alt=media" alt="一時保存領域のファイル詳細に、ソースとして「Agent 生成」、元のワークスペース、生成元の会話が表示されています"><figcaption><p>生成されたファイルの詳細には、元のワークスペースと生成元の会話が表示されます</p></figcaption></figure>

{% hint style="info" %}
長期保存したい生成ファイルは、一時保存領域から正式なワークスペースに移動できます。
{% endhint %}

***

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

* [AI にファイルの編集・整理を依頼する](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/ai-edit.md)
* [バージョン履歴と復元](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/versions.md)
* [AI チャット](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/chat.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/use-in-maigpt.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.
