> 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/search-and-details.md).

# 検索、フィルタ、ファイルの詳細

ファイルライブラリでスペースを横断してファイルを検索し、種類で絞り込み、ファイルの詳細を確認するほか、ファイルを一括で移動、削除、ダウンロードできます。

ファイルが増えても、保存場所を覚えておく必要はありません。上部の検索欄から、アクセスできるすべてのスペースを横断してファイルを検索できます。検索結果には保存場所が表示され、クリックするだけで開けます。

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

顧客から電話で前四半期の見積もりについて問い合わせがありました。営業担当者は、ファイル名に「見積」という文字が含まれていたことしか覚えていません。ファイルライブラリ上部で「見積」を検索すると、「Q3 見積書.xlsx」が表示され、その下に「マイファイル › A1 発売提案」と保存場所が表示されます。ファイルを開くと右側に詳細が表示され、そのまま <mark style="color:blue;">ダウンロード</mark> を押して顧客に添付送信できます。

***

## スペースを横断した検索 <a href="#search" id="search"></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-ee3ba9e442d64fec672468a280fcfcce5677eb54%2Ffile-library-search.png?alt=media" alt="ファイルライブラリで「見積」を検索した結果。ファイル名の下に保存場所が表示されています"><figcaption><p>検索結果には「表示可能なすべてのスペースを横断」とファイルの保存場所が表示されます</p></figcaption></figure>

{% hint style="info" %}
現在のスペース内でワークスペースだけを探す場合は、一覧上部の <mark style="color:blue;">このスペースのファイルワークスペースを検索</mark> を使用できます。
{% endhint %}

***

## 種類による絞り込みと表示の切り替え <a href="#filter-and-view" id="filter-and-view"></a>

ワークスペース内で <mark style="color:blue;">種類：すべて</mark> をクリックすると、表示するファイルの種類を複数選択できます（Excel やプレゼンテーションだけを表示する場合など）。何も選択していない場合は、すべての種類が表示されます。一覧右上で <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-0db83e06a2c1b2a6238460208de5df15083bc043%2Ffile-library-type-filter.png?alt=media" alt="PDF、Word、PowerPoint、Excel などを複数選択できる種類フィルターメニュー"><figcaption><p>種類は複数選択できます。未選択の場合はすべて表示されます</p></figcaption></figure>

***

## ファイルの詳細 <a href="#file-details" id="file-details"></a>

ファイル名をクリックすると、右側にファイルの詳細が開き、次の内容が表示されます。

* **上部の操作**：ダウンロード、移動、削除
* <mark style="color:blue;">編集</mark>、<mark style="color:blue;">新しいバージョンをアップロード</mark>：[オンライン編集](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/online-editing.md) を参照してください。ファイルを変更すると <mark style="color:blue;">バージョン</mark> も表示されます。[バージョン履歴と復元](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/versions.md) を参照してください
* **基本情報**：サイズ、保存場所、作成日時、作成者、更新日時、更新者、ソース（<mark style="color:blue;">アップロード</mark>、<mark style="color:blue;">Agent 出力</mark> など）。AI が生成したファイルには、生成元のワークスペースと会話も表示されます
* **ファイルのプレビュー**
* <mark style="color:blue;">会話を開始</mark>：このファイルを新しい MaiGPT の会話に追加します

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-4bbb0a527a9155c2673bd54336c8d152358d2605%2Ffile-library-file-detail.png?alt=media" alt="ファイル詳細サイドバー。上部に編集と新しいバージョンのアップロードがあり、その下に基本情報、ファイルのプレビュー、会話を開始ボタンが表示されています"><figcaption><p>ファイル詳細サイドバー</p></figcaption></figure>

***

## 一括操作 <a href="#batch-actions" id="batch-actions"></a>

一覧左側のチェックボックスを選択するか、ヘッダー行で全選択すると、上部に <mark style="color:blue;">移動</mark>、<mark style="color:blue;">削除</mark> などの操作が表示されます。1 回に最大 **200** 個のファイルを処理できます。個別のファイルは、その行の <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> を選択することもできます。

{% hint style="info" %}
削除したファイルは、ワークスペースの <mark style="color:blue;">バージョン履歴</mark> から復元できます。詳しくは [バージョン履歴と復元](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/versions.md) を参照してください。
{% endhint %}

***

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

* [ワークスペースの作成とファイルのインポート](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/create-and-import.md)
* [MaiGPT でワークスペースを使用](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/use-in-maigpt.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/search-and-details.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.
