> ## Documentation Index
> Fetch the complete documentation index at: https://docs-docflow.textin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

> 画面上でインテリジェントレビュー機能を利用する方法

<Tip>
  インテリジェントレビュー機能を利用すると、文書抽出結果の正確性やコンプライアンスを自動で確認できます。このページでは、画面上でレビュー機能を利用する基本的な流れを説明します。
</Tip>

インテリジェントレビューは DocFlow が提供する自動レビュー機能です。設定したレビュー規則にもとづいて文書抽出結果を自動で確認し、潜在的な問題を素早く見つけられるようにします。

## レビュー機能の概要

インテリジェントレビュー機能の基本フローは次のとおりです。

1. **レビュー規則を設定** - 規則リポジトリ内に規則グループと規則を作成し、レビュー基準を定義します
2. **レビュータスクを作成** - レビュー対象の抽出タスクを選択し、レビュータスクを送信します
3. **レビュー結果を確認** - どの規則が通過し、どの規則が不通過だったか、またそのレビュー根拠を確認します

## 画面での利用手順

### ステップ 1: 規則リポジトリを作成

レビュー管理画面では、最初に **規則リポジトリ（Rule Repository）** を作成します。規則リポジトリはレビュー規則を整理、管理するためのコンテナです。

* 「規則リポジトリを作成」ボタンをクリックします
* 規則リポジトリ名を入力します（例: 「請求書レビュー規則リポジトリ」）
* 保存すると規則リポジトリ ID を取得できます

### ステップ 2: 規則グループを作成

規則リポジトリの配下に **規則グループ（Rule Group）** を作成し、規則を分類して管理します。

* 作成済みの規則リポジトリを選択します
* 「規則グループを作成」をクリックします
* 規則グループ名を入力します（例: 「請求書コンプライアンスチェック」）
* 保存すると規則グループ ID を取得できます

### ステップ 3: レビュー規則を作成

規則グループの配下に具体的な **レビュー規則（Rule）** を作成し、レビュー基準を定義します。

規則を作成する際は、次の項目を設定します。

* **規則名**: 規則を識別するための名前
* **規則プロンプト**: レビュー規則を説明するプロンプト。AI のレビュー判定を導くために使用されます
* **適用カテゴリ**: この規則を適用する文書カテゴリ（例: 請求書、契約書など）
* **リスクレベル**: 規則のリスクレベル（高リスク、中リスク、低リスク）
* **参照フィールド**: レビュー時に値を参照する抽出フィールド

規則の例:

* 規則名: 「請求金額チェック」
* 規則プロンプト: 「請求金額が 0 より大きく、1000000 未満であることを確認する」
* 適用カテゴリ: 請求書
* リスクレベル: 高リスク
* 参照フィールド: 請求金額

### ステップ 4: レビュータスクを作成

抽出が完了したタスクがある場合、そのタスクに対してレビュータスクを作成できます。

* レビュー対象の抽出タスクを選択します（extract\_task\_ids）
* 使用する規則リポジトリを選択します（repo\_id）
* タスク名を入力します
* レビュータスクを送信します

システムは規則リポジトリ内の規則と抽出タスクを自動で照合し、マッチした規則に対してレビューを実行します。

### ステップ 5: レビュー結果を確認

レビュータスクを送信すると、システムが自動でレビューを実行します。次の結果を確認できます。

* **タスクステータス**: レビュータスク全体の状態（未レビュー、レビュー中、成功、失敗など）
* **規則グループ結果**: 各規則グループのレビュー状況
* **規則結果**: 各規則のレビュー結果（通過 / 不通過）
* **レビュー根拠**: AI が提示したレビュー根拠。通過または不通過になった理由を確認できます
* **位置アンカー**: レビュー根拠に対応する原文上の位置。問題箇所の特定に利用できます

## レビュー結果の説明

レビュー結果には次の情報が含まれます。

* **レビューステータス**:
  * `0`: 未レビュー
  * `1`: レビュー通過
  * `2`: レビュー失敗
  * `3`: レビュー中
  * `4`: レビュー不通過

* **レビュー根拠**: AI が提示したレビュー理由。なぜそのレビュー結果になったかを説明します

* **位置アンカー**: レビュー根拠に対応する原文上の位置座標。文書上で関連箇所をハイライトするために利用できます

## 用語

このセクションでは、インテリジェントレビュー機能の中核概念を説明します。

### 規則リポジトリ管理

規則リポジトリ管理は、**規則リポジトリ（Rule Repository）** → **規則グループ（Rule Group）** → **規則（Rule）** の 3 階層で構成されます。

#### 規則リポジトリ（Rule Repository）

規則リポジトリはレビュー規則の最上位コンテナで、関連するレビュー規則を整理、管理するために使用します。1 つのワークスペースには複数の規則リポジトリを作成でき、各リポジトリには複数の規則グループを含められます。

**特徴:**

* 業務シナリオごとにレビュー規則を論理的にまとめられます
* レビュータスクを作成する際に、使用する規則リポジトリを指定します
* 規則リポジトリは個別に作成、更新、削除できます

**例:**

* 「請求書レビュー規則リポジトリ」 - 請求書関連のレビュー規則をまとめます
* 「契約書レビュー規則リポジトリ」 - 契約書関連のレビュー規則をまとめます

#### 規則グループ（Rule Group）

規則グループは規則リポジトリ配下の二次分類で、規則をより細かくグルーピングして管理するために使用します。1 つの規則リポジトリには複数の規則グループを含めることができ、1 つの規則グループには複数の規則を含められます。

**特徴:**

* 規則を分類し、検索や管理をしやすくします
* レビュー結果では、規則グループが結果表示の 1 つの単位になります
* 規則グループは個別に作成、更新、削除できます

**例:**
「請求書レビュー規則リポジトリ」の配下には、次のような規則グループを作成できます。

* 「請求書コンプライアンスチェック」 - 請求書がコンプライアンス要件を満たしているかを確認します
* 「請求金額チェック」 - 請求金額の妥当性を確認します
* 「請求日チェック」 - 請求日の有効性を確認します

#### 規則（Rule）

規則はレビューの最小実行単位で、具体的なレビュー基準とロジックを定義します。1 つの規則グループには複数の規則を含められます。

**規則の構成:**

1. **規則名**: 規則を識別、管理するための名前
2. **規則プロンプト（Prompt）**: レビュー規則を説明し、AI のレビュー判定を導くプロンプト。規則の中核であり、レビュー基準とロジックを明確に記述する必要があります
3. **適用カテゴリ（Category IDs）**: この規則を適用する文書カテゴリ。これらのカテゴリに一致する抽出タスクにのみ規則が適用されます
4. **リスクレベル（Risk Level）**:
   * `10`: 高リスク
   * `20`: 中リスク
   * `30`: 低リスク
5. **参照フィールド（Referenced Fields）**: レビュー時に値を取得するために参照する抽出フィールド

**規則の例:**

```json theme={null}
{
  "name": "請求金額チェック",
  "prompt": "請求金額が 0 より大きく、1000000 未満であることを確認し、範囲外の場合はレビュー不通過とする",
  "category_ids": ["invoice_category_id"],
  "risk_level": 10,
  "referenced_fields": [
    {
      "category_id": "invoice_category_id",
      "category_name": "請求書",
      "fields": [
        {
          "field_id": "amount_field_id",
          "field_name": "請求金額"
        }
      ]
    }
  ]
}
```

### レビュー対象

レビュー対象は **抽出タスク（Extract Task）**、つまり文書抽出が完了したタスクです。

**抽出タスクの特徴:**

* 抽出タスクは文書アップロードと抽出フローによって生成されます
* 各抽出タスクは 1 つ以上のファイルに対応します
* 抽出タスクには、フィールド、表、印影などの抽出結果が含まれます
* 抽出が完了したタスクだけをレビュー対象として利用できます

**抽出タスク ID の取得方法:**

* ファイルアップロード API が返す `task_id` から取得します
* ファイル確認 API から、抽出完了済みファイルに対応するタスク ID を取得します

### レビュータスク

レビュータスク（Review Task）は、規則リポジトリを抽出タスクに適用する 1 回のレビュー実行です。

**レビュータスクの構成:**

* **タスク名**: レビュータスクを識別するための名前
* **規則リポジトリ ID**: 使用する規則リポジトリを指定します
* **抽出タスク ID リスト**: レビュー対象となる抽出タスク ID のリスト

**レビュータスクの実行フロー:**

1. **規則マッチング**: システムが規則リポジトリ内の規則と抽出タスクのカテゴリを照合します
   * マッチング条件: 規則の `category_ids` に含まれるすべてのカテゴリが、抽出タスクのカテゴリリストに存在する必要があります
   * マッチング結果: マッチした規則だけが実行されます
2. **フィールド取得**: マッチした規則に参照フィールドが設定されている場合、システムは抽出結果からそれらのフィールド値を取得します
   * 参照フィールドは空でもかまいません。空の場合は文書の原文のみを使用します
   * フィールドが欠落している場合、そのフィールド値は空になりますが、レビューは実行されます
3. **AI レビュー**: 規則プロンプトとフィールド値（存在する場合）にもとづいて、AI がレビュー判定を行います
4. **結果生成**: レビューステータス、レビュー根拠、位置アンカーなどを含むレビュー結果を生成します

### レビュー規則と抽出タスクのマッチング方法

システムは **カテゴリマッチング** によってレビュー規則と抽出タスクを照合します。**参照フィールドは規則マッチングには関係しません**。参照フィールドは、あるカテゴリをレビューするときに抽出フィールド値を使用する必要がある場合、どのフィールドを使うかを指定するためのものです。参照フィールドは空でもかまいません。

#### マッチング規則

規則マッチングの判定基準は次のとおりです。

* 規則には `category_ids`（適用カテゴリリスト）が設定されています
* 抽出タスクには 1 つ以上の文書カテゴリが含まれます
* **規則の `category_ids` に含まれるすべてのカテゴリが抽出タスクのカテゴリリストに存在する場合、規則はマッチします**
* **規則の `category_ids` のいずれかが抽出タスクのカテゴリリストに存在しない場合、規則はマッチしません**

#### マッチング例

レビュー対象の抽出タスクに **A、B、C** の 3 つのカテゴリが含まれているとします。

* **レビュー規則 1**: 関連カテゴリ `["A", "B"]`
* **レビュー規則 2**: 関連カテゴリ `["C"]`
* **レビュー規則 3**: 関連カテゴリ `["C", "D"]`

マッチング結果:

* ✅ **レビュー規則 1**: マッチ成功（A と B がどちらも抽出タスクのカテゴリリストに存在）
* ✅ **レビュー規則 2**: マッチ成功（C が抽出タスクのカテゴリリストに存在）
* ❌ **レビュー規則 3**: マッチ失敗（D が抽出タスクのカテゴリリストに存在しない）

#### 参照フィールドの役割

**重要**: 参照フィールド（`referenced_fields`）は規則マッチングには関係しません。

参照フィールドの役割は次のとおりです。

* 規則がマッチし、レビューを実行する際に、規則プロンプトで抽出フィールド値が必要な場合、その値を参照フィールドから取得します
* 参照フィールドは空でもかまいません。空の場合、レビュー時には抽出フィールドを使わず、文書の原文のみを使用します
* 規則がフィールドを参照していても、抽出タスク内でそのフィールドが欠落している場合、該当フィールド値は空になりますが、レビュー自体は実行されます

**例:**

```json theme={null}
{
  "name": "請求金額チェック",
  "prompt": "請求金額が 0 より大きく、1000000 未満であることを確認する",
  "category_ids": ["invoice"],
  "referenced_fields": [
    {
      "category_id": "invoice",
      "fields": [
        {
          "field_id": "amount_field_id",
          "field_name": "請求金額"
        }
      ]
    }
  ]
}
```

この例では、次のように動作します。

* 規則マッチング: 抽出タスクのカテゴリに `invoice` が含まれていれば、規則はマッチします
* 参照フィールド: 規則がマッチすると、レビュー判定時に抽出結果から「請求金額」フィールドの値を取得します
* 「請求金額」フィールドが欠落している場合もレビューは実行されますが、そのフィールド値は空になります

### 参照フィールド

参照フィールド（Referenced Fields）は、レビュー時に使用する抽出フィールド値を指定するためのものです。**参照フィールドは規則マッチングには関係しません**。規則がマッチした後、そのカテゴリをレビューするときにどのフィールド値を使うかをシステムに伝えます。

**重要事項:**

* 参照フィールドは空でもかまいません。空の場合、レビュー時には文書の原文のみを使用します
* 参照フィールドは規則マッチングに影響しません。規則マッチングはカテゴリ（`category_ids`）のみを基準にします
* 参照したフィールドが抽出結果内に存在しない場合もレビューは実行されますが、そのフィールド値は空になります

**参照フィールドの構造:**

参照フィールドはカテゴリ単位で整理され、各カテゴリには次の情報を含められます。

* **通常フィールド（Fields）**: 文書内のキーと値のペア
* **表フィールド（Tables）**: 文書内の表フィールド

**参照フィールドの役割:**

* 規則がマッチしてレビューが実行される際、システムは抽出結果から参照フィールドの値を取得します
* フィールド値はコンテキスト情報として AI に渡され、規則プロンプトと組み合わせてレビュー判定に使用されます
* フィールド値が欠落していてもレビューは実行されますが、規則プロンプトがそのフィールドに依存している場合、レビュー精度に影響する可能性があります

**参照フィールドの例:**

```json theme={null}
{
  "referenced_fields": [
    {
      "category_id": "invoice_category_id",
      "category_name": "請求書",
      "fields": [
        {
          "field_id": "invoice_code_id",
          "field_name": "請求書コード"
        },
        {
          "field_id": "invoice_amount_id",
          "field_name": "請求金額"
        }
      ],
      "tables": [
        {
          "table_id": "invoice_items_table_id",
          "table_name": "請求明細",
          "fields": [
            {
              "field_id": "item_name_id",
              "field_name": "品目名"
            }
          ]
        }
      ]
    }
  ]
}
```

### レビュー根拠

レビュー根拠（Reasoning）は、AI が提示するレビュー理由です。なぜそのレビュー結果になったかを説明します。

**レビュー根拠の特徴:**

* レビュー根拠はテキスト形式で、レビュー判定の過程を説明します
* 関連するフィールド値や文書内容が参照されることがあります
* ユーザーがレビュー結果を理解する助けになります

**位置アンカー（Anchors）:**

位置アンカーは、レビュー根拠に対応する原文上の位置情報です。文書内でレビュー根拠に該当する具体的な箇所を特定するために使用します。

**位置アンカーの構造:**

```json theme={null}
{
  "anchors": [
    {
      "start_pos": 0,      // reasoning 内の開始文字位置
      "end_pos": 10,       // reasoning 内の終了文字位置
      "text": "原文内容",   // 原文の内容
      "vertices": [        // 原文内容の外接四角形座標
        0, 0, 100, 0, 100, 100, 0, 100
      ],
      "file_id": "file_id" // ファイル ID
    }
  ]
}
```

**位置アンカーの役割:**

* 文書上でレビュー根拠に対応する位置をハイライトできます
* ユーザーが問題箇所を素早く特定できます
* レビュー結果を視覚的に表示できます

### レビュー結果ステータス

レビュー結果には複数のステータスがあり、レビューの段階や結果を表します。

* `0`: 未レビュー
* `1`: レビュー通過
* `2`: レビュー失敗
* `3`: レビュー中
* `4`: レビュー不通過
* `5`: 認識中
* `6`: キュー待ち
* `7`: 認識失敗

### まとめ

インテリジェントレビュー機能は、規則リポジトリ、規則グループ、規則の 3 階層でレビュー基準を管理します。カテゴリマッチングとフィールド参照によって規則を抽出タスクへ適用し、AI がレビュー判定を行い、レビュー根拠と位置アンカーを含む結果を生成することで、文書内の潜在的な問題を素早く把握できるようにします。

## 次のステップ

* [API で規則リポジトリを管理](./rule_management) - REST API を使用して規則リポジトリを管理します
* [API でレビュータスクを作成](./create_task) - REST API を使用してレビュータスクを作成します
* [レビュー結果の取得と利用](./get_result) - REST API を使用してレビュー結果を取得し、処理します
