Box Developerドキュメント
ログイン

Box Developerドキュメントの新しいベータ版サイトがまもなくリリースされる予定です。最新の開発者向けガイド、APIリファレンス、AI搭載の検索により、Boxを使用した迅速な開発をサポートします。更新情報については今しばらくお待ちください。

Box AI

ガイド Box AI

Box AI

Box AI APIを使用すると、Platformアプリケーション内でBox AI機能を利用できます。たとえば、Box AIの質疑応答機能をサードパーティ製アプリケーションに実装したり、自社製品のコンテンツエディタ内で直接コンテンツを生成したりできます。

Box AI APIの機能

Box AI APIには、アプリケーションのワークフローで大規模言語モデル (LLM) を利用できるように設計された多数の機能が用意されています。

Box AIに対して、ユーザーの質問への回答、ドキュメントの内容の要約、ドキュメントで使用できるテキストの生成を求めることができます。また、Box AIを使用して、スキーマやメタデータテンプレートなど、指定した入力データからメタデータを抽出することもできます。

Box AI for UI Elements機能を使用すると、アプリにBox AIを組み込むことができます。

Box AIに質問する

Boxに保存しているドキュメントで作業している間など、Box AI APIを使用して、そのコンテンツについて質問することができます。

Box AIは、指定されたファイルに基づいて、コンテンツに関する質問に回答したり、要約を生成したりできます。

ドキュメント内の [Box AI]

ユーザーがドキュメントでの作業中にBox AIを操作する方法の例については、Box AI for Documentsを参照してください。

Box AIを使用してテキストを生成する

Box AI APIを使用すると、テキストをゼロから生成したり、Box Note内の既存のテキストから生成したり、プレビュー内の特定のドキュメントに基づいて生成したりすることができます。たとえば、プレビュー表示している記事に基づいてテンプレートやアジェンダを作成するようBox AIに求めることができます。

また、もう1つの例として、Box Notesでは、テキストの生成や既存メモのコンテンツのリファインにBox AIを使用します。詳細については、Box AI for Notesを参照してください。

Notes内の [Box AI]

メタデータの抽出

POST /2.0/ai/extractおよびPOST /2.0/ai/extract_structuredエンドポイントを使用すると、指定した入力からデータを抽出し、キー/値ペアの形式で返すことができます。

  • extract_structuredエンドポイントは、メタデータテンプレートから取得したあらかじめ定義された構造、または一連のフィールドに従ってデータを抽出する場合に使用します。ドキュメントが短い場合に使用してください。
  • ドキュメントが長くて複雑な場合は、抽出エージェント (強化) を使用します。
  • extractエンドポイントは、プロンプトを使用してファイルからデータを抽出する場合に使用します。プロンプトには、JSONやXMLなどの形式の文字列化バージョン、またはプレーンテキストを含めることができます。

抽出エージェント (強化)

抽出エージェント (強化) は、複雑なドキュメントからキー/値ペアを抽出するよう設計されています。検出や検索を容易にするため、非構造化コンテンツをメタデータに変換します。

Box AI APIを介してエージェントを使用すると、非構造化データを、実稼働環境のデータベース、サードパーティ製システム、分析で使用する構造化された出力に変換できます。

抽出エージェント (強化) は、Gemini 2.5 Proを使用して思考連鎖推論機能を提供し、抽出された値とその回答の根拠となる推論の両方を返します。

構成の上書き

デフォルトのエージェント構成を上書きし、独自のカスタム設定を導入するには、Box AI APIリクエストで利用可能なai_agentパラメータを使用できます。

詳細については、AIエージェントのデフォルト構成を参照してください。

Box AI for UI Elements

Box AI for UI Elementsはコンテンツプレビューで利用可能で、これにより、Platformアプリケーション内で直接ドキュメントについて質問することができます。Box AI for UI Elementsを使用してプロジェクトにBox AI機能を埋め込む方法をご確認ください。

サポートされている言語

Box AIは、英語、日本語、フランス語、スペイン語など、多くの言語で使用できます。ただし、基になるモデルは、主に英語のドキュメントでトレーニングされています。つまり、他の言語のプロンプトで返される回答は、英語の場合よりも低品質になる可能性があります。テストでは、要約、文法やつづりの確認、質問への回答について満足のいく結果が示されていますが、結果は英語の場合と異なる可能性があることに留意してください。

言語を日本語に切り替えると、より適切な結果が得られます。

[ユーザーアクティビティ] レポート (UAR) でのBox AI API

[ユーザーアクティビティ] レポートには、ユーザーがBoxで実行している操作の概要が示されます。Box管理者は、このレポートを使用して、所定の期間内にユーザーが行った操作を確認できますが、これにはBox AIに対する操作も含まれます。レポートには、Box管理者がBox AIの詳細を取得するために選択できる以下の操作が用意されています。

  • AIクエリ: ユーザーがBox AIに対してクエリを実行し、レスポンスを受け取りました。
  • AIクエリの失敗: ユーザーがBox AIに対してクエリを実行したが、レスポンスがありませんでした。