---
title: インテリジェンス (data.ndocs)
description: インテリジェンスとは、Human Plugin がすべての回答の data.ndocs で各人物について伝える情報です。誰に関するものか、何を数えるか、いつ存在しないか、どう読むかを説明します。
canonical: https://developer.unico.io/ja/human-plugin/get-started/intelligence
locale: ja
generated_by: markdown-export
---

# インテリジェンス

data.ndocs: 同じ人物があなたのもとで行ったことを、すべての回答で。

完了したすべてのプロセスは、Human Token で本人が誰であるかを伝え、`data.ndocs` のインテリジェンスで、その人物があなたのもとで行ったことを伝えます。何件のクライアントで確認されたか、何件のドキュメントを使ったか、いつ使ったかです。

```json
"ndocs": {
  "distinctClientsCount": 2,
  "transactionsCount": 3,
  "firstSeen": "2026-09-08",
  "lastSeen": "2026-11-03",
  "credentials": [
    { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
  ]
}
```

| フィールド | 意味 |
| --- | --- |
| `distinctClientsCount` | 本人のプロセス全体における、異なる `clientId` 値の数 |
| `transactionsCount` | 本人のプロセスの数 (このプロセスを含む) |
| `firstSeen`, `lastSeen` | 最初のプロセスと最新のプロセスの UTC 日付 (`YYYY-MM-DD`) |
| `credentials[].type` | ドキュメントの種類。[属性カタログ](/ja/human-plugin/additional-resources/attribute-catalog)のコードです |
| `credentials[].countryCode` | ドキュメントを発行する国の Alpha-3 コード。カタログにもう掲載されていない種類では存在しません |
| `credentials[].distinctCredentialCount` | その種類の異なるドキュメントの数 |

## 読み方

`distinctClientsCount` が 1 を超える場合、または `distinctCredentialCount` が 1 を超える場合は、同じ顔が異なるクライアントやドキュメントで使われたことを意味します。このシグナルをどう扱うかは、あなたの判断です。

## 何が数えられるか

人物は Human Token によって識別されます。そのトークンを持つ**完了した**プロセスだけが、すべてのクライアント id を横断して数えられます。ドキュメントなしで作成されたプロセスは、トランザクションとして、またクライアントとして数えられますが、ドキュメントの種類には含まれません。本人のどのプロセスにもドキュメントがない場合、`credentials` は `[]` です。

インテリジェンスの対象は、あなたの Human Plugin インストールのプロセスです。

## 誰のインテリジェンスか

- Human Token を伴って完了した**識別**: その人物。`data.liveness.value` が `not_live` の場合は対象外です。
- `data.humanTokenMatch` が `"true"` の**再検証**: `references` で送信したトークンの人物。このプロセスはその人物のものとして数えられます。
- **それ以外** (不一致、またはライブではない撮影): インテリジェンスはなく、`data.ndocs` もありません。

## 存在しない場合

既知の人物でも、`data.ndocs` が存在しないことがあります。

- プロセスがまだ完了していない。
- インテリジェンスを計算できなかった。作成または読み取り自体は成功し、後の `GET` で再度試行されます。

`data.ndocs` がないことを、その人物が一度も確認されていないという意味に読まないでください。

## 次へ

[前提条件とアクセス](/ja/human-plugin/get-started/prerequisites)