---
title: 인텔리전스 (data.ndocs)
description: 인텔리전스는 Human Plugin이 모든 응답의 data.ndocs에 담아 각 인물에 대해 알려주는 정보입니다. 누구를 설명하는지, 무엇을 집계하는지, 언제 없는지, 어떻게 읽는지를 설명합니다.
canonical: https://developer.unico.io/ko/human-plugin/get-started/intelligence
locale: ko
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` | 문서 유형. [속성 카탈로그](/ko/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`가 없다고 해서 그 인물이 확인된 적이 없다고 해석하지 마세요.

## 다음

[사전 요건 및 접근](/ko/human-plugin/get-started/prerequisites)