メインコンテンツへスキップ
split_typeがsmartの場合、Boxドキュメント分割はpromptを使用して、ページをどのようにグループ化して、出力ドキュメントに分割するかを決定します。プロンプトが明確で具体的であるほど、より信頼性の高い分割結果が得られます。
スマート分割はAIユニットを消費します。Boxは、4ページ処理するごとに1 AIユニットを消費します。

前提条件

使用を開始する前に、ガイドに記載されている手順に従って、Platformアプリを作成し、アクセストークンを生成してください。 以下も必要です。
  • Boxにすでに格納されているソースPDF
  • アプリが書き込み可能なBox上の保存先フォルダ
  • ページをどのようにグループ化するかを説明するプロンプト。

構成するパラメータ

プロンプトのガイドライン

  • 指定したBoxファイルがソースドキュメントであることを伝えます。
  • ページ数、QRコードなどのマーカー、内容の条件といった、分割ルールを説明します。
  • 契約書の添付資料の後に署名ページが続くケースなど、順序が重要な場合は、ページ番号順にページ範囲を指定します。
  • 含めるページやセクションを明確に指定します。また、必要に応じて除外するページやセクションも指示します。
  • 「適当に分割する」や「いい感じに分割する」といった曖昧な表現は避けます。

プロンプトの例

明示的なページグループ

範囲を自然言語で説明し、1つのファイルを2つのドキュメントに分割します。
この結果、2つの出力が生成されます。1つは1~3ページ目、もう1つは5~8ページ目に対応しています。
正確なページ範囲がすでにわかっている場合は、代わりにsplit_type: "manual"とsplit_definitionを使用してください。決定的な結果については、を参照してください。

QRコードを分割点として使用する

各QRコードページを、ドキュメントの区切りとして扱います。QRコードページの前までのページが1つの出力ドキュメントとなり、QRコードページ自体は特に指定がない限り出力から除外されます。
この結果、マーカーページによって区切られた連続したページ範囲が生成されます。たとえば、マーカーが5ページ目と11ページ目にある場合、出力は1~4ページ目と6~10ページ目になります。

内容に基づいた契約書のページ分割

本人確認書類、署名ページ、締結済みの契約条件など、実質的な契約に関する内容を含むページのみを保持し、定型的な利用規約は除外します。また、保持するセクションを順番に分割します。
この結果、1~3ページ目と4~6ページ目など、条件に一致する連続した内容のブロックごとに1つの出力が生成されます。

スマート分割ジョブを作成する

cURL
レスポンスには、分割ジョブのIDが含まれています。
このIDを使用して、します。そのレスポンスに含まれるsplit_definitionには、Boxがプロンプトから導き出したページ範囲が表示されます。そのため、プロンプトによって期待どおりのグループ化が行われたかどうかを確認できます。
最終更新日 2026年10月14日