> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 利用可能なツール
Box MCPサーバーでは、AIエージェントがBoxのコンテンツや機能を操作できるようにするツールを利用できます。これらのツールはカテゴリ別に分類されているため、シナリオに適合した機能をすばやく見つけることができます。
## ユーザーと認証
ユーザー認証を管理したり、認証済みユーザーに関する情報を取得したりします。
| ツール | 説明 |
| ---------- | ---------------------------- |
| `who_am_i` | 現在認証されているBoxユーザーの詳細な情報を返します。 |
## ファイルとフォルダ
Boxのファイルやフォルダにあるリソースにアクセスして、管理と変更を行うことができます。このツールを使用して、コンテンツ、メタデータ、バージョン管理を制御できます。
### 読み取り専用
| ツール | 説明 |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `get_download_url` | Boxからバイナリファイルをダウンロードするための、1回のみ使用できる一時的なURLを発行します。構成の詳細については、[こちら](#upload-and-download-url-tools)を参照してください。 |
| `get_file_content` | Boxに保存されているファイルのコンテンツを返します。 |
| `get_file_details` | メタデータ、権限、バージョンの詳細など、ファイルの詳しい情報をBoxから取得します。 |
| `get_file_preview` | Boxに保存されているファイルに関するプレビューウィジェットを返します。 |
| `get_folder_details` | メタデータ、権限、コラボレーション設定など、フォルダの詳しい情報を取得します。 |
| `list_folder_content_by_folder_id` | フォルダ内のファイル、フォルダ、ウェブリンクのページ分割されたリストを取得します。
ルートフォルダには`folder_id`「0」を使用します。`id`、`type`、`name`、`etag`は常に返されます。`limit`は省略可能なフィールドです。 |
### 書き込み
| ツール | 説明 |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `copy_file`1 | 既存のファイルをBox内の宛先フォルダにコピーします。 |
| `copy_folder`1 | 既存のフォルダをBox内の宛先親フォルダにコピーします。 |
| `create_folder`1 | Box内にフォルダを作成します。 |
| `create_metadata_template` | Enterpriseメタデータテンプレートを作成します。`enterprise`スコープ、`display_name`、および`fields`配列 (省略可) が必須です。 |
| `get_upload_url` | Boxにバイナリファイルをアップロードするための、1回のみ使用できる一時的なURLを発行します。構成の詳細については、[こちら](#upload-and-download-url-tools)を参照してください。 |
| `move_file`1 | 既存のファイルをBox内の宛先フォルダに移動します。ファイルIDは変更されず、`parent_folder_id`の指定が必須です。 |
| `move_folder`1 | フォルダをBox内の新しい親フォルダに移動します。フォルダIDは変更されず、`parent_folder_id`の指定が必須です。 |
| `set_file_metadata`1 | テンプレート用のファイルに対して、カスタムメタデータを作成または更新 (アップサート) します。`list_metadata_templates`と`get_metadata_template_schema`を使用して、`scope`、`template_key`、および`fields`を検索します。 |
| `set_folder_metadata`1 | テンプレート用のフォルダに対して、カスタムメタデータを作成または更新 (アップサート) します。`list_metadata_templates`と`get_metadata_template_schema`を使用して、`scope`、`template_key`、および`fields`を検索します。 |
| `update_file_properties`1 | ファイルのプロパティ (名前、説明、タグ、コレクション) を更新します。名前は最大255文字まで指定でき、特に指定しない限りファイル拡張子は変更されません。説明は最大256文字まで指定できます。タグは最大100個まで追加または更新できます。 |
| `update_folder_properties`1 | フォルダのプロパティ (名前、説明、タグ、コレクション) を更新します。名前は最大255文字まで指定できますが、`/`、`\`、`.`、`..`、および先頭や末尾のスペースを含めることはできません。説明は最大256文字まで指定できます。タグは最大100個まで更新できます。 |
| `update_metadata_template` | アトミックスキーマ操作 (例: `addField`、`editField`、`removeField`) を使用して、メタデータテンプレートのスコープと`template_key`を更新します。 |
| `upload_file`1 | 新しいファイルをBoxにアップロードします。 |
| `upload_file_version`1 | ファイルコンテンツ全体を提供してBox内の既存のファイルを更新することで、新しいファイルバージョンをアップロードします。 |
## 検索
キーワード、名前、または構造化メタデータクエリと、オプションのフィルタおよびスコープを使用して、コンテンツとコンテナを検索します。
| ツール | 説明 |
| ------------------------------ | -------------------------------------------------------------------------------- |
| `get_metadata_template_schema` | メタデータテンプレートのスキーマとフィールドキーを返します。 |
| `list_metadata_templates` | 利用可能なBoxメタデータテンプレート (enterpriseまたはglobal) のリストを取得します。 |
| `search_files_keyword` | キーワードを使用してファイルを検索します。メタデータフィルタ、ファイル拡張子によるフィルタ処理、フィールドの選択がサポートされています。 |
| `search_files_metadata` | SQLに似たメタデータクエリを使用してファイルを検索します。パラメータを使用した複雑なフィルタ処理、フィールドの選択、フォルダの範囲指定がサポートされています。 |
| `search_folders_by_name` | キーワードの照合を使用して、名前でBox内のフォルダを検索します。 |
## コラボレーション
コメント、共有リンク、コラボレーション管理ツールによるチームのコラボレーションを可能にします。
### 読み取り専用
| ツール | 説明 |
| -------------------------- | ----------------------------------------------- |
| `list_file_comments` | ファイルのすべてのコメントのリストを取得します。 |
| `list_item_collaborations` | 項目の既存のすべてのコラボレーションのリストを取得します。 |
| `list_tasks` | ファイルに関するすべてのタスク (ステータス、メッセージ、期日を含む) のリストを取得します。 |
### 書き込み
| ツール | 説明 |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `add_file_shared_link` | Boxファイルの共有リンクを作成または更新します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 |
| `add_folder_shared_link` | Boxフォルダの共有リンクを作成または更新します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 |
| `create_collaboration` | ユーザーまたはグループをファイル、フォルダ、またはHubに招待します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 |
| `create_file_comment`1 | ファイルにコメントを作成します。 |
| `update_collaboration` | ファイル、フォルダ、またはHubのコラボレーションを更新します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 |
## Box AI
AIを活用したツールを使用して、質問、インサイトの抽出、ファイルやHubでのコンテンツの分析を行います。
| ツール | 説明 |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ai_extract_freeform` | Box AIを使用して、自然言語のプロンプト (固定テンプレートなし) でファイルからメタデータを抽出します。
テキストレプリゼンテーションは最大2 MBまで対応しています。ドキュメント、PDF、プレゼンテーション、テキストをサポートします。1つ以上の`file_ids`に対応しています。 |
| `ai_extract_structured` | Box AI抽出エージェント (強化) とカスタムフィールドの定義を使用して、ファイルから構造化されたキー/値メタデータを抽出します。 |
| `ai_extract_structured_from_fields` | Box AIとカスタムフィールドの定義を使用して、ファイルから構造化メタデータを抽出します。
1つ以上のファイルに対応しています。フィールドタイプには、`string`、`date`、`float`、`enum`、`multiSelect`が含まれます。 |
| `ai_extract_structured_from_fields_enhanced` | Box AI抽出エージェント (強化) とカスタムフィールドの定義を使用して、ファイルから構造化メタデータを抽出します。
ユーザーが抽出エージェント (強化) を指定した場合にのみ使用します。このツールは、標準のBox AI Extractツールよりもコストがかかります。フィールドタイプには、`string`、`date`、`float`、`enum`、`multiSelect`が含まれます。 |
| `ai_extract_structured_from_metadata_template` | 既存のBoxメタデータテンプレートを使用して、ファイルから構造化メタデータを抽出します。
`template_key`および`scope` (例: `enterprise`または`global`) は必須です。
ファイルコンテンツのテキストレプリゼンテーションを処理します。 |
| `ai_extract_structured_from_metadata_template_enhanced` | 既存のBoxメタデータテンプレートと抽出エージェント (強化) を使用して、ファイルから構造化メタデータを抽出します。
ユーザーが抽出エージェント (強化) を指定した場合にのみ使用します。このツールは、標準のBox AI Extractツールよりもコストがかかります。 |
| `ai_qa_hub` | Box Hubに関する質問を行い、Hubのコンテンツに基づいて回答を返します。可能な場合は、引用情報も表示します。 |
| `ai_qa_multi_file` | Box AIを使用して複数のファイルに関する質問を行い、可能な場合は引用情報も表示します。 |
| `ai_qa_single_file` | Box AIを使用して、単一のファイルに関する質問を行い、可能な場合は引用情報も表示します。
テキストレプリゼンテーションは最大2 MBまで対応しています。ファイルサイズがこれを超える場合は、最初の2 MBのみ処理されます。 |
## Hub
Hubを作成および管理して、特定のトピックやプロジェクトに関するコンテンツとリソースのコラボレーションを整理します。
### 読み取り専用
| ツール | 説明 |
| ----------------- | -------------------------------------- |
| `get_hub_details` | 特定のHubに関する詳細情報を取得します。 |
| `get_hub_items` | 特定のHubに関連付けられた項目 (ファイルおよびフォルダ) を取得します。 |
| `list_hubs` | 認証済みのユーザーがアクセスできるすべてのHubのリストを取得します。 |
### 書き込み
| ツール | 説明 |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `add_items_to_hub`1 | Hubにファイル、フォルダ、またはウェブリンクを追加します。 |
| `copy_hub`1 | 既存のHubの構造や設定を含め、そのコピーを作成します。元のHubは変更されません。新しいタイトルは最大50文字まで指定できます。タイトルを指定しない場合は、デフォルトのタイトルが使用されます。 |
| `create_hub` | Hubを作成します。 |
| `update_hub`1 | Hubのタイトルと説明を更新します。 |
## Doc Gen
プレースホルダタグ付きのテンプレートを使用して、ドキュメントの生成を自動化し、カスタムドキュメントを大規模に作成します。
### 読み取り専用
| ツール | 説明 |
| --------------------------- | ------------------------------------------------- |
| `get_docgen_template_by_id` | Doc Genテンプレートの詳細を取得します。 |
| `list_docgen_templates` | 認証済みのユーザーがアクセスできるすべてのBox Doc Genテンプレートのリストを取得します。 |
### 書き込み
| ツール | 説明 |
| ------------------------ | ---------------------------------------------------------------------- |
| `create_docgen_batch` | 指定されたデータをプレースホルダタグに入力して、Doc Genテンプレートからドキュメントを生成します。 |
| `create_docgen_template` | Boxファイル (`.docx`または`.pptx`) を、ドキュメント生成を自動化するためのドキュメント生成テンプレートとして設定します。 |
## アップロードURLツールとダウンロードURLツール
> アップロードURLツールとダウンロードURLツールを使用するには、AIエージェントがファイル転送リクエストをネットワークに直接送信できる必要があります。宣言型エージェントにはその機能がないため、このツールはエージェント型 (コード実行型) 環境でのみサポートされます。
一部のクライアントでは、アップロードURLおよびダウンロードURLを適切に機能させるためにドメイン許可リストが必要です。
Zonesを利用しないお客様の場合、許可リストには以下のドメインが含まれます。
```
upload.box.com
upload.app.box.com
upload.ent.box.com
dl.boxcloud.com
public.boxcloud.com
```
必要なドメインは、ご利用のBox Zoneによって異なります。完全なリストについては、[Box Zonesの新しいドメイン](https://support.box.com/hc/en-us/articles/16726358708371-New-Box-Zones-Domains)を参照してください。
または、ワイルドカードドメインを使用して、すべてのサブドメインを許可することもできます。
```
upload.*.box.com
*.boxcloud.com
*.box.com
```
## フィードバック
Box MCPサーバーに関するフィードバックや質問を共有するには、Box Developer Communityフォーラムの[Box AI APIスレッド](https://community.box.com/box-ai-api-8)を参照してください。
> 1 Only works on items that meet **all** of the following:
>
> * その項目自体に外部コラボレータが存在しない
> * その項目自体に共有リンクが存在しない
> * ルートフォルダを含むすべての親フォルダに、外部コラボレータや共有リンクが存在しない