カスタム スプリッター

カスタム スプリッターは、各論理ドキュメントを識別することで、複合ドキュメント（複数のクラスで構成されるドキュメント）を複数の単一クラス ドキュメントに分割する目的で使用するために設計されています。たとえば、住宅ローン パッケージには、申請書、収入証明書、写真付き身分証明書など、複数のクラスが含まれています。カスタム スプリッター プロセッサは、すぐに使用することも、独自のドキュメントとカスタムクラスを使用してゼロからトレーニングすることもできます。

スプリッターの説明と使用方法

ドキュメントに特化し、データを使用してトレーニングと評価を行うカスタム スプリッターを作成するか、生成 AI を使用して事前トレーニング済みのモデルをデプロイできます。これらのプロセッサは、一連のユーザー定義のクラスからドキュメントのクラスを識別します。これで、これらのプロセッサをドキュメントで使用できます。通常は、異なるタイプの論理ドキュメントで構成されるファイルに対してカスタム スプリッター ツールを使用し、それぞれのクラス ID を使用して適切な抽出プロセッサにドキュメントを渡してエンティティを抽出します。

ML モデルは完璧ではなく、ある程度はエラーが発生します。また、通常、分割時のエラーは大きな問題になります（間違った 2 つのドキュメントを作成し、抽出エラーの原因になります）。そのため、分割予測後、実際のファイル分割前に、必ず人間による確認ステップを実施することをおすすめします。ビジネス要件によっては、常に人間によるレビューに代わる方法もあります。

  • 予測の信頼スコアを使用して、人間によるレビューを行わない（十分に高い場合）かどうかを決定します。この信頼スコアのしきい値は、ある信頼スコアのエラー率に関する履歴データに基づいて決定する必要があります。これは、ビジネス プロセスにおけるエラーの許容範囲と、人間によるレビューを省略する要件に基づくビジネス上の決定であるべきです。
  • ユースケースによっては、分割されたドキュメントを、予測されたクラスに応じて適切な抽出ツールに直接転送できます。次に、抽出が不完全であるか、信頼スコアが低い場合は、分割ドキュメントを分離し、元の複合ドキュメントをトリガーして分割の決定をレビューします。これは、ワークフローの要件がかなり複雑になります。

カスタム スプリッター モデルのバージョン

カスタム スプリッターでは、次のモデルを使用できます。モデル バージョンを変更するには、プロセッサ バージョンを管理するをご覧ください。

バージョン 1.5 は信頼スコアをサポートしています。

モデル バージョン 説明 リリース チャンネル リリース日
pretrained-splitter-v1.5-2025-07-14 Gemini 2.5 Flash LLM を活用する一般提供モデル。この事前トレーニング済みモデルは、事前トレーニングなしで使用できます。ゼロショット分割と分類をサポートしています。 Stable 2025 年 7 月 14 日
pretrained-splitter-v1.6-2026-03-09 Gemini 3.1 Flash LLM を活用するリリース候補。 リリース候補 2026 年 3 月 9 日
pretrained-splitter-v1.6-pro-2026-03-09 Gemini 3.1 Pro LLM を活用するリリース候補。 リリース候補 2026 年 3 月 9 日

デフォルトのプロセッサ割り当ての割り当て増加リクエスト（QIR）を行うには、割り当ての調整をリクエストするの手順に沿って操作します。

カスタム スプリッターのバージョンを決定する

カスタム スプリッターを使用する場合は、独自のデータでトレーニングするか、pretrained-splitter-v1.5-2025-07-14 などの生成 AI を使用して事前トレーニング済みのバージョンを使用します。

トレーニング プロセスには数時間かかることがありますが、モデルを独自のデータの特性に合わせて調整できます。事前トレーニング済みバージョンは Gemini モデルに基づいています。これは短時間で本番環境に移行できます。また、これを使用して、ラベル付けスキーマの迅速なイテレーションとテストを行うこともできます。トレーニング データセットは必要ありません。

このガイドは両方のバージョンを対象にしており、手順が異なる場合は、それぞれのバージョンについて説明します。

Google Cloud コンソールでカスタム スプリッターを作成する

このクイックスタート ガイドでは、Document AI で、調達ドキュメントを分割して分類するカスタム スプリッターを作成し、トレーニングする方法について説明します。ドキュメントの準備はほとんど完了しているため、カスタム スプリッターの作成に集中できます。

カスタム スプリッターのトレーニング済みベース バージョンを作成して使用する一般的なワークフローは次のとおりです。

  1. Document AI でカスタム スプリッターを作成します。
  2. 空の Cloud Storage バケットを使用してデータセットを作成します。
  3. プロセッサ スキーマを定義して作成します（クラス）。
  4. ドキュメントをインポートします。
  5. トレーニング セットとテストセットにドキュメントを割り当てます。
  6. Document AI またはラベル付けタスクを使用して、ドキュメントに手動でアノテーションを付けます。
  7. プロセッサをトレーニングします。
  8. プロセッサを評価します。
  9. プロセッサをデプロイします。
  10. プロセッサをテストします。
  11. ドキュメントでプロセッサを使用します。

カスタム スプリッターの事前トレーニング済みバージョンを作成して使用する一般的なワークフローは次のとおりです。

  1. Document AI でカスタム スプリッターを作成します。
  2. 空の Cloud Storage バケットを使用してデータセットを作成します。
  3. 事前トレーニング済みモデルのバージョンを選択します。
  4. プロセッサ スキーマを定義して作成します（クラス）。
  5. （省略可）ドキュメントをインポートします。
  6. （パフォーマンスを評価する場合は省略可）ドキュメントをテストセットに割り当てます。
  7. （省略可）プロセッサを評価します。
  8. プロセッサをテストします。
  9. プロセッサをデプロイします。
  10. ドキュメントでプロセッサを使用します。

このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、「ガイドを表示」をクリックしてください。

ガイドを表示

始める前に

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Document AI, Cloud Storage APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Document AI, Cloud Storage APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

    10.

必要なロール

カスタム スプリッタの作成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

プロセッサの作成

  1. Google Cloud コンソールの Document AI セクションで、[Workbench] ページに移動します。

    Workbench

  2. [カスタム ドキュメントスプリッター] で、[プロセッサを作成] を選択します。custom-splitter-1

  3. [プロセッサを作成] メニューで、プロセッサの名前を入力します（例: my-custom-document-splitter）。

    custom-splitter-2

  4. 最も近いリージョンを選択します。

  5. [作成] を選択します。[プロセッサの詳細] タブが表示されます。