Box Developerドキュメント

Box AI

ガイド Box AI

Box AI

Endpoints related to metadata extraction are currently a beta feature offered subject to Box’s Main Beta Agreement, and the available capabilities may change. Box AI API is available to all Enterprise Plus and Enterprise Advanced customers.

Box AI APIを使用すると、カスタムアプリケーション内で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リクエストで利用可能なai_agentパラメータを使用できます。

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

Box AI for UI Elements

Box AI for UI Elementsはコンテンツプレビューで利用可能で、これにより、カスタムアプリケーション内で直接ドキュメントについて質問することができます。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に対してクエリを実行したが、レスポンスがありませんでした。