ユーザーと認証
ユーザー認証を管理したり、認証済みユーザーに関する情報を取得したりします。| ツール | 説明 |
|---|---|
who_am_i | 現在認証されているBoxユーザーの詳細な情報を返します。 |
ファイルとフォルダ
Boxのファイルやフォルダにあるリソースにアクセスして、管理と変更を行うことができます。このツールを使用して、コンテンツ、メタデータ、バージョン管理を制御できます。読み取り専用
| ツール | 説明 |
|---|---|
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 | 既存のファイルをBox内の宛先フォルダにコピーします。 |
copy_folder | 既存のファイルをBox内の宛先フォルダの親フォルダにコピーします。 |
create_folder | Box内にフォルダを作成します。フォルダは、外部コラボレーションが有効になっておらず、共有リンクも設定されていない親フォルダ内にのみ作成できます。この制限は、その親フォルダの親にも適用されます。 |
create_metadata_template | Enterpriseメタデータテンプレートを作成します。enterpriseスコープ、display_name、およびfields配列 (省略可) が必須です。 |
move_file | 既存のファイルをBox内の宛先フォルダに移動します。ファイルIDは変更されず、parent_folder_idの指定が必須です。 |
move_folder | フォルダをBox内の新しい親フォルダに移動します。フォルダIDは変更されず、parent_folder_idの指定が必須です。 |
set_file_metadata | テンプレート用のファイルに対して、カスタムメタデータを作成または更新 (アップサート) します。list_metadata_templatesとget_metadata_template_schemaを使用して、scope、template_key、およびfieldsを検索します。 |
set_folder_metadata | テンプレート用のフォルダに対して、カスタムメタデータを作成または更新 (アップサート) します。list_metadata_templatesとget_metadata_template_schemaを使用して、scope、template_key、およびfieldsを検索します。 |
update_file_properties | ファイルのプロパティ (名前、説明、タグ、コレクション) を更新します。名前は最大255文字まで指定でき、特に指定しない限りファイル拡張子は変更されません。説明は最大256文字まで指定できます。タグは最大100個まで追加または更新できます。 |
update_folder_properties | フォルダのプロパティ (名前、説明、タグ、コレクション) を更新します。名前は最大255文字まで指定できますが、/、\、.、..、および先頭や末尾のスペースを含めることはできません。説明は最大256文字まで指定できます。タグは最大100個まで更新できます。 |
update_metadata_template | アトミックスキーマ操作 (例: addField、editField、removeField) を使用して、メタデータテンプレートのスコープとtemplate_keyを更新します。 |
upload_file | 新しいファイルをBoxにアップロードします。 |
upload_file_version | ファイルコンテンツ全体を提供して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ファイルの共有リンクを作成または更新します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 | Claudeのみ。他のクライアントは近日対応予定 |
add_folder_shared_link | Boxフォルダの共有リンクを作成または更新します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 | Claudeのみ。他のクライアントは近日対応予定 |
create_collaboration | ユーザーまたはグループをファイル、フォルダ、またはHubに招待します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 | Claudeのみ。他のクライアントは近日対応予定 |
create_file_comment | ファイルにコメントを作成します。外部のコラボレータや共有リンクがないファイルでのみ使用できます。 | すべてのクライアント |
update_collaboration | ファイル、フォルダ、またはHubのコラボレーションを更新します。オープンアクセスの共有リンクを作成したり、組織外のユーザーをコラボレータとして追加したりできます。デフォルトではオフになっています。 | Claudeのみ。他のクライアントは近日対応予定 |
Box AI
AIを活用したツールを使用して、質問、インサイトの抽出、ファイルやHubでのコンテンツの分析を行います。| ツール | 説明 |
|---|---|
ai_extract_freeform | Box AIを使用して、自然言語のプロンプト (固定テンプレートなし) でファイルからメタデータを抽出します。 テキストレプリゼンテーションは最大1 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を使用して、単一のファイルに関する質問を行い、可能な場合は引用情報も表示します。 テキストレプリゼンテーションは最大1 Mbまで対応しています。ファイルサイズがこれを超える場合、最初の1 MBのみ処理されます。 |
Hub
特定のトピックやプロジェクトに関するコラボレーションコンテンツやリソースを整理するためのBox Hubsを作成および管理します。読み取り専用
| ツール | 説明 |
|---|---|
get_hub_details | 特定のHubに関する詳細情報を取得します。 |
get_hub_items | 特定のHubに関連付けられた項目 (ファイルおよびフォルダ) を取得します。 |
list_hubs | 認証済みのユーザーがアクセスできるすべてのHubのリストを取得します。 |
書き込み
| ツール | 説明 |
|---|---|
add_items_to_hub | ファイル、フォルダ、またはウェブリンクをHubに追加します。外部のコラボレータや共有リンクがない項目でのみ使用できます。 |
copy_hub | 既存のHubの構造や設定を含め、そのコピーを作成します。元のHubは変更されません。新しいタイトルは最大50文字まで指定できます。タイトルを指定しない場合は、デフォルトのタイトルが使用されます。 |
create_hub | Hubを作成します。 |
update_hub | 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) を、ドキュメント生成を自動化するためのドキュメント生成テンプレートとして設定します。 |