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

# 結果の見方

> ABBYY Vantage の抽出結果の読み方を説明します。JSON構造、ExtractedData、信頼度スコア、RawValue、検証フラグ、およびテーブルfieldsを理解します。

[API](/ja/vantage/getting-started/api) または [web UI](/ja/vantage/getting-started/ui) でドキュメントを処理すると、Vantage は抽出されたfieldsの値、信頼度スコア、検証フラグを含む構造化データを返します。このページでは、その出力の見方を説明します。

<div id="result-structure-at-a-glance">
  ## 結果の構造の概要
</div>

すべての結果は同じ階層構造になっています。

```
ExtractedDataTransaction
├── SkillName, SkillId
├── Documents[]
│   ├── ExtractedData
│   │   ├── DocumentDefinition    ← fieldスキーマ（抽出可能な項目）
│   │   └── RootObject            ← field値（抽出された内容）
│   │       └── Fields[]
│   │           ├── Name
│   │           └── List[]
│   │               ├── Value
│   │               ├── Annotation (Confidence, RawValue, ...)
│   │               ├── NeedVerification
│   │               └── isVerified
│   └── ClassificationResult      ← ドキュメントタイプ（分類が適用された場合）
└── SourceFiles[]
```

ほとんどのユースケースでは、抽出された値にアクセスするには `Documents[0].ExtractedData.RootObject.Fields` をたどるだけで十分です。

<div id="reading-extracted-fields">
  ## 抽出されたフィールドの見方
</div>

以下は、ABBYY Invoice Skill で処理した請求書の簡略化した例です。

```json theme={null}
{
  "SkillName": "ABBYY Invoice",
  "SkillId": "a1b2c3d4-...",
  "Documents": [
    {
      "ExtractedData": {
        "RootObject": {
          "Fields": [
            {
              "Name": "InvoiceNumber",
              "List": [
                {
                  "Value": "INV-2024-0042",
                  "Annotation": {
                    "Confidence": 97,
                    "RawValue": "INV-2024-0042",
                    "Source": "Text"
                  },
                  "NeedVerification": false,
                  "isVerified": false
                }
              ]
            },
            {
              "Name": "InvoiceDate",
              "List": [
                {
                  "Value": "2024-03-15",
                  "Annotation": {
                    "Confidence": 94,
                    "RawValue": "March 15, 2024",
                    "Source": "Text"
                  },
                  "NeedVerification": false,
                  "isVerified": false
                }
              ]
            },
            {
              "Name": "TotalAmount",
              "List": [
                {
                  "Value": "1,250.00",
                  "Annotation": {
                    "Confidence": 62,
                    "RawValue": "1.250,00",
                    "Source": "Image"
                  },
                  "NeedVerification": true,
                  "isVerified": false
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
```

各fieldsには、次のプロパティが含まれます。

| Property                | 意味                                                                |
| ----------------------- | ----------------------------------------------------------------- |
| `Name`                  | Skillで定義されたfield名 (例: "InvoiceNumber"、"VendorName")               |
| `Value`                 | 正規化後の抽出値 — 日付はISO形式に変換され、数値は標準化されます                               |
| `Annotation.Confidence` | 抽出結果に対するVantageの確信度を示す、0～100の整数                                   |
| `Annotation.RawValue`   | 正規化前の、OCRで認識された元のテキスト                                             |
| `Annotation.Source`     | 値の取得元がドキュメントの `Text` レイヤーか、`Image` からの読み取りかを示します                  |
| `NeedVerification`      | fieldが人による確認対象としてフラグ付けされている場合は `true` (例: 確信度が低い、または検証ルールに失敗した場合) |
| `isVerified`            | 手動確認でオペレーターがすでにその値を確認済みの場合は `true`                                |

<Callout type="tip">
  上の `TotalAmount` が `Confidence: 62`、`NeedVerification: true` になっている点に注目してください。生の値 `1.250,00` (欧州形式) は `1,250.00` に正規化されていますが、確信度が低いため、VantageはOCR結果に完全な確信を持てていなかったことがわかります。これはまさに、人による確認が必要な種類のfieldです。
</Callout>

<div id="table-fields-line-items">
  ## テーブル fields (明細)
</div>

請求書の明細のようなテーブルを抽出するSkillでは、それらは繰り返しグループを含むfieldsとして表されます。各行は、そのfieldの `List` 配列内の `ExtractedObject` として表され、それぞれ独自のサブfieldを持ちます。

```json theme={null}
{
  "Name": "LineItems",
  "List": [
    {
      "Fields": [
        { "Name": "Description", "List": [{ "Value": "Consulting services", ... }] },
        { "Name": "Quantity",    "List": [{ "Value": "10", ... }] },
        { "Name": "UnitPrice",   "List": [{ "Value": "100.00", ... }] },
        { "Name": "Amount",      "List": [{ "Value": "1,000.00", ... }] }
      ]
    },
    {
      "Fields": [
        { "Name": "Description", "List": [{ "Value": "Travel expenses", ... }] },
        { "Name": "Quantity",    "List": [{ "Value": "1", ... }] },
        { "Name": "UnitPrice",   "List": [{ "Value": "250.00", ... }] },
        { "Name": "Amount",      "List": [{ "Value": "250.00", ... }] }
      ]
    }
  ]
}
```

各行は同じfield構造を持つため、コード内で繰り返し処理しやすくなっています。

<div id="confidence-scores-in-practice">
  ## 実際の運用における信頼度スコア
</div>

信頼度スコアは、抽出された値に対して Vantage がどの程度確信を持っているかを示します。信頼度には、いくつかの要因が影響します。

* **文書品質** — 不鮮明なスキャン、低解像度の画像、または手書き文字はスコアを低下させます
* **レイアウトの複雑さ** — 特殊な表レイアウトや重なり合ったフィールドは、精度を低下させる可能性があります
* **トレーニングデータとの一致度** — Skill のトレーニング時に学習したパターンによく一致する値ほど、高いスコアになります

**信頼度をプログラムで利用する方法:**

* **高信頼度 (90–100)** — 値を自動的に受け入れます
* **中信頼度 (70–89)** — 注意して受け入れるか、重要なフィールドは確認に回します
* **低信頼度 (70 未満)** — 人による確認のために[手動確認](/ja/vantage/documentation/skill-designer/process/manual-review)に回します

`NeedVerification: true` のfieldsは、Skill で設定された信頼度のしきい値とバリデーションルールに基づいて、Vantage によってすでにフラグ付けされています。

<div id="common-field-names-by-skill">
  ## Skill別の一般的なfield名
</div>

各Skillでは、それぞれ独自のfield名セットが定義されています。以下は、よく使われるSkillで一般的なfieldsです。

| Skill       | 主要項目                                                                                      |
| ----------- | ----------------------------------------------------------------------------------------- |
| **Invoice** | `InvoiceNumber`, `InvoiceDate`, `VendorName`, `TotalAmount`, `TaxAmount`, `LineItems`     |
| **Receipt** | `ReceiptNumber`, `Date`, `VendorName`, `Total`, `Tax`, `PaymentMethod`, `LineItems`       |
| **購買注文書**   | `PONumber`, `OrderDate`, `BuyerName`, `SupplierName`, `TotalAmount`, `LineItems`          |
| **ID文書**    | `FirstName`, `LastName`, `DateOfBirth`, `DocumentNumber`, `ExpirationDate`, `Nationality` |

<Callout type="info">
  これらは代表的なfieldsです。各Skillには、このほかのfieldが含まれる場合があります。任意のSkillの完全なfield一覧を確認するには、[Skill Catalog](/ja/vantage/documentation/skill-catalog/skill-catalog)をご覧ください。
</Callout>

<div id="next-steps">
  ## 次のステップ
</div>

<CardGroup cols={2}>
  <Card title="完全なJSONスキーマ" icon="braces" href="/ja/vantage/developer/output/json/json-schema">
    JSON 出力内のすべてのオブジェクトとプロパティの完全なリファレンスです。
  </Card>

  <Card title="XML出力" icon="file-code" href="/ja/vantage/developer/output/xml/xml-output">
    同じ抽出データを XML 構造で提供する別の出力形式です。
  </Card>

  <Card title="手動確認" icon="user-check" href="/ja/vantage/documentation/skill-designer/process/manual-review">
    抽出されたfieldsに対する人手による検証を設定します。
  </Card>

  <Card title="次に学ぶこと" icon="compass" href="/ja/vantage/getting-started/next-steps">
    目的に応じて、Vantage ドキュメントの読み進め方を選択します。
  </Card>
</CardGroup>