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

# Investigator 에이전트: KYC, AML, 케이스 AI 검토

> Didit Investigator는 검토 중인 모든 인증, 거래 알림, 케이스에 대해 출처가 명시된 보고서를 작성하며, AI가 독자적으로 결정할 수 있는 범위를 직접 정할 수 있습니다.

> [!WARNING]
>
> 조사자는 새로운 기능이며 아직 모든 조직에서 사용할 수 있는 것은 아닙니다. Didit에 요청하여 활성화하십시오. Growth 요금제 이상이 필요하며, 샌드박스 애플리케이션에서는 절대 실행되지 않습니다.

조사자는 사람의 확인을 기다리는 항목을 검토합니다. 항목마다 기록을 읽고, 권고 사항과 그 근거가 담긴 보고서를 작성한 뒤, 검토자가 처리할 때까지 기다리거나 허용된 경우 스스로 결정합니다.

## 검토 대상

| 대기열 | 항목 | 시작 시점 |
| - | - | - |
| KYC | 신원 확인 세션 | 세션이 **검토 중** 상태로 바뀔 때 |
| KYB | 기업 확인(KYB) | 세션이 **검토 중** 상태로 바뀔 때 |
| AML | 지속적인 AML 모니터링 적중 건이 있는 세션 | 새로운 적중 건이 도착할 때 |
| 거래 | 거래 알림 | 거래가 **검토 중** 상태로 바뀔 때 |
| 케이스 | 케이스 | 케이스가 열리거나 다시 열릴 때 |

팀이 먼저 항목을 결정하면 조사자의 실행은 결정 없이 종료됩니다.

## 보고서

각 보고서에는 다음이 포함됩니다.

* **권고**: 승인, 거부, 추가 정보 요청(인증의 경우 재제출, 거래의 경우 사용자 응답 대기) 또는 에스컬레이션,
* **신뢰도**: 높음, 보통 또는 낮음,
* 요약과 추론 과정,
* **근거**: 각 항목은 양호, 위험, 확인 필요, 설명됨 또는 맥락으로 표시되며, 출처를 인용합니다,
* 선별 적중 건의 경우, 각 적중 건이 동일인인지, 동일인이 아닌지, 불분명한지 여부,
* 연결된 기록이나 케이스 열기 같은 다음 단계 제안.

### 인용하는 출처

조사자는 검토자가 콘솔과 API에서 보는 것과 같은 데이터를 읽습니다. 신원 확인 결정, 기업 확인(KYB) 결정, 거래 상세 정보 또는 케이스 상세 정보가 여기에 해당합니다. 연결된 세션, 거래, 케이스도 열 수 있습니다. 모든 근거 항목은 읽은 기록의 섹션 또는 열어 본 연결 기록을 인용합니다. 보고서에는 **확인한 내용**도 표시되며, 읽은 개요, 섹션 및 기록을 읽은 순서대로 보여 줍니다.

조사자는 이 기록에서 제공된 정보만 사용합니다. 기록이 모델에 전달되기 전에 Didit은 미디어, 링크, 내부 식별자를 제거하고 보호 대상 특성을 마스킹합니다. 조사자는 데이터를 변경할 수 없으며, 보고서를 작성하기만 합니다.

## 단계

| 단계 | 진행 내용 | 과금 여부 |
| - | - | - |
| **설정되지 않음** | 조사자가 실행되지 않습니다. | 아니요 |
| **관찰 모드** | 보고서를 작성하고, 자체 점수를 팀의 결정과 비교합니다. 검토자는 평소처럼 결정합니다. | 아니요 |
| **자동화가 실행 중입니다** | 보고서가 검토자에게 표시되며, 대기열은 선택한 자율성 수준에 따라 스스로 결정할 수 있습니다. | 예 |

실제 운영 전에 관찰 모드를 7일, 14일(기본값) 또는 30일 동안 실행합니다. 설정, 관찰 모드, 백테스트는 절대 과금되지 않습니다.

## 자율성 수준

대기열마다 자율성 수준을 설정합니다.

| 수준 | 동작 |
| - | - |
| **꺼짐** | 항목이 보고서 없이 검토자에게 전달됩니다. |
| **제안** (기본값) | 조사자가 보고서를 준비합니다. 모든 항목은 사람이 결정합니다. |
| **자동** | 정책이 다루는 항목 중 **높음** 신뢰도이고, 팀의 과거 결정과의 일치도가 대기열 임계값에 도달한 항목을 결정합니다. |
| **완전 자동** | **보통** 신뢰도 항목도 결정합니다. 품질 확인을 위해 일부 항목은 여전히 사람에게 전달됩니다. |

조사자는 다음 조건이 모두 충족될 때만 스스로 결정합니다.

* 애플리케이션이 실제 운영 중이고, 대기열이 **자동** 또는 **완전 자동**으로 설정되어 있으며, 일시 중지되지 않았습니다.
* 팀 정책이 해당 항목을 다루고, 권고된 조치를 취하도록 규정합니다.
* 가드레일이 항목을 보류하지 않습니다.
* 지난 90일 동안 최소 20건 이상의 결정에 대해 팀의 과거 결정과의 일치도가 임계값을 충족합니다.
* 항목이 품질 샘플로 선택되지 않았고, 점진적 적용 비율 안에 있으며, 일일 한도에 도달하지 않았습니다.

| 대기열 설정 | 값 |
| - | - |
| 임계값 | 80, 85, 90(기본값) 또는 95% 일치도 |
| 품질 샘플 | 결정된 항목 중 2, 5(기본값) 또는 10%가 사람에게 전달됩니다 |
| 일일 한도 | 기본값은 하루 200건 |
| 적용 범위 | 점진적(14일 동안 항목의 25%) 또는 모든 항목 |
| 금액 상한 | 이 금액을 초과하는 거래는 항상 사람에게 전달됩니다. 기본값은 애플리케이션 통화 기준 25,000입니다. |
| 자동 상향 | 일치도가 98%에 도달하면 한 단계 위 수준으로 올라갑니다 |

대기열을 **자동** 또는 **완전 자동**으로 올리려면 먼저 과거 결정을 대상으로 백테스트를 실행하고 결과를 확인해야 합니다. **케이스**와 **AML** 대기열은 일괄 수락되지 않으며, 에스컬레이션된 케이스나 두 번째 검토자를 기다리는 케이스는 자동으로 결정되지 않습니다.

## 가드레일

다음 규칙은 항상 적용되며 변경할 수 없습니다.

* 제재 적중은 항상 사람에게 전달됩니다.
* 사기 및 AML 사유는 최종 사용자에게 절대 전달되지 않습니다.
* 어떤 결정도 보호 대상 특성을 근거로 하지 않습니다.
* 조사자는 규제 보고서를 절대 제출하지 않습니다.
* 모든 결정은 기록되며 재정의할 수 있습니다.

## 보고서 검토

**제안** 수준에서 검토자는 다음을 할 수 있습니다.

* 권고를 **수락**합니다,
* 권고를 **수정 후 수락**합니다,
* 권고를 **재정의**합니다. 이때 범주(맥락 누락, 정보 필요, 정책 차이, 근거 오독, 기타)와 10자에서 500자 사이의 사유를 입력해야 합니다,
* **수락 가능**으로 표시된 항목을 최대 50건까지 **일괄 수락**합니다.

권고를 수락하면 항목의 일반 경로를 통해 결정이 적용되므로, 평소 사용하던 webhook과 알림도 그대로 발송됩니다. 에스컬레이션하면 연결된 케이스가 열립니다. 조사자가 내린 결정은 항목에 **조사자가 결정함**으로 표시됩니다.

## 팀 정책

대기열마다 팀 정책이 있습니다. 이는 무엇을 승인, 거부 또는 에스컬레이션할지에 대한 팀의 규칙입니다. 조사자는 이 정책을 따르며, 정책이 항목을 다루는 경우에만 스스로 결정합니다. 정책은 버전으로 관리됩니다. **질문** 탭에는 조사자가 팀에 확인이 필요하다고 판단한 사항이 모입니다.

## 감사 추적

**활동** 탭에는 보고서, 수락, 편집, 덮어쓰기, 자동 결정, 가드레일 보류, 설정 변경 등 모든 기록이 남으며, 누가 수행했는지도 표시됩니다. 수행자는 조사관, 사람, API 키 또는 시스템일 수 있습니다. 항목은 수정할 수 없습니다. 최대 10,000개 항목을 CSV로 내보낼 수 있습니다.

조사관이 독립적으로 내린 각 결정은 조직의 [감사 로그](https://docs.didit.me/ko/console/audit-logs.md)에도 **조사관** 아래에 기록되며, 해당 보고서에 연결됩니다. 구성원과 API 키가 수행한 작업과 함께 확인할 수 있습니다.

## 요금

조사관의 요금은 하나입니다. **검토한 인증 건(KYC, KYB 또는 AML 적중), 거래 알림 또는 케이스당 \$0.20**입니다. 이 요금에는 기록 검토, 근거를 인용한 보고서 작성, 권장 사항 제시가 포함되며, 조사관은 보고서를 검토자에게 전달하거나 정책 범위 내에서 자체적으로 결정합니다.

| 검토 항목 | 가격 |
| - | - |
| 인증(KYC, KYB 또는 AML 적중), 거래 알림 또는 케이스 | \$0.20 |

항목당 한 번만 청구되며, 애플리케이션이 프로덕션 환경에서 실행 중이고 보고서가 수락되었거나 편집 후 수락되었거나 조사관이 자체적으로 결정한 경우에만 청구됩니다. 덮어쓰기, 팀이 다른 곳에서 결정한 항목, 실패한 실행, 섀도 모드, 설정 및 백테스트는 무료입니다. 요금제 할인이 적용됩니다.

**설정**에서 선택 사항인 월간 지출 한도를 설정할 수 있습니다. 한도에 도달하면 새 항목은 보고서 없이 검토자에게 전달됩니다.

## API 및 webhook

조사관 API는 `https://verification.didit.me/v3/investigator/` 아래에 있으며, 애플리케이션의 API 키(`x-api-key`)를 사용합니다.

| 엔드포인트 | 용도 |
| - | - |
| `GET summary/`, `GET queue/` | 대기열 개수와 대기 중인 항목입니다. |
| `GET runs/{id}/` | 보고서 하나를 조회합니다. |
| `POST runs/{id}/accept/`, `POST runs/{id}/override/`, `POST runs/batch-accept/` | 보고서에 대해 조치합니다. |
| `GET transactions/{id}/` | 거래의 보고서를 조회합니다. |
| `GET dashboard/`, `GET performance/`, `GET activity/`, `GET activity/export/` | 결과와 감사 추적을 조회합니다. |
| `GET guardrails/` | 잠긴 가드레일을 조회합니다. |
| `GET` / `PATCH settings/` | 단계와 월간 지출 한도를 조회하고 변경합니다. |

제한된 API 키로 보고서를 읽고 조치하려면 `decisions` 범위가 필요하며, 설정을 읽거나 변경하려면 `applications` 범위가 필요합니다. 거래 보고서에는 `transactions` 범위도 필요합니다. 일부 워크플로 또는 승인된 세션으로 제한된 키는 대기열이 모든 워크플로에 걸쳐 있으므로 거부됩니다. 전체 요청 및 응답 스키마는 **Investigator** 태그 아래의 [`openapi-25.json`](https://docs.didit.me/openapi-25.json)에 있습니다.

조사관 전용 webhook은 없습니다. [`status.updated` webhook](https://docs.didit.me/ko/integration/webhooks#investigator-블록)과 `GET /v3/session/{id}/decision/`의 `decision`에는 `investigator` 블록이 포함되며, 이 블록에는 실행의 `status`, `recommendation`, `confidence`, `summary`, `ready_to_accept`, `automated`, `decided_by`(`investigator` 또는 `member`)가 들어 있습니다.

## 관련 문서

> [card] [수동 검토](https://docs.didit.me/ko/console/manual-review.md)
>
> 팀이 인증 세션을 검토하는 방법입니다.

> [card] [케이스](https://docs.didit.me/ko/console/case-management/cases.md)
>
> 알림과 조사를 위한 케이스 관리입니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.