> ## 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.

# AIレビューエージェント Investigator：KYC・AML・ケース調査

> DiditのInvestigatorは、レビュー中の各認証、取引アラート、ケースについて出典付きのレポートを作成します。どこまで自律的に判定させるかも選択できます。

> [!WARNING]
>
> Investigatorは新しい機能で、まだすべての組織で有効になっているわけではありません。有効化はDiditにご依頼ください。Growthプラン以上が必要で、サンドボックスのアプリケーションでは一切実行されません。

Investigatorは、担当者の対応を待っている項目をレビューします。項目ごとに記録を読み取り、推奨とその根拠を記したレポートを作成します。その後はレビュアーの判断を待つか、許可されている場合は自ら判定します。

## レビュー対象

| キュー | 項目 | 開始条件 |
| - | - | - |
| KYC | 認証セッション | セッションが**レビュー中**に移行したとき。 |
| KYB | 法人確認 | セッションが**レビュー中**に移行したとき。 |
| AML | 継続的なAMLモニタリングでヒットしたセッション | 新しいヒットが発生したとき。 |
| 取引 | 取引アラート | 取引が**レビュー中**に移行したとき。 |
| ケース | ケース | ケースがオープンまたは再オープンされたとき。 |

チームが先に項目を判定した場合、Investigatorの実行は判定なしで終了します。

## レポート

各レポートには以下が含まれます。

* **推奨**: 承認、却下、追加情報の要求（認証の場合は再提出、取引の場合はユーザーの対応待ち）、またはエスカレーション
* **信頼度**: 高、中、低のいずれか
* 概要と判断の理由
* **根拠**: 各項目は「問題なし」「リスク」「要確認」「説明済み」「参考情報」のいずれかでマークされ、出典が示されます
* スクリーニングのヒットについては、各ヒットが同一人物か、別人か、不明か
* リンクされた記録やケースを開くなど、推奨される次のステップ

### 引用する情報源

Investigatorは、レビュアーがコンソールやAPIで確認するのと同じデータを読み取ります。対象は認証の判定、企業認証の判定、取引の詳細、またはケースの詳細です。リンクされたセッション、取引、ケースを開くこともできます。各根拠には、読み取った記録のセクション、または開いたリンク先の記録が出典として示されます。レポートには**確認した内容**も表示され、読み取った概要、セクション、記録が順番に一覧になります。

Investigatorはその記録のみに基づいて作業します。記録がモデルに渡される前に、Diditはメディア、リンク、内部識別子を削除し、保護対象の特性をマスクします。Investigatorはデータを変更できません。行うのはレポートの作成のみです。

## ステージ

| ステージ | 内容 | 課金 |
| - | - | - |
| **未設定** | Investigatorは実行されません。 | なし |
| **観察モード** | レポートを作成し、チームの判定と照らし合わせて自己評価します。判定はレビュアーが通常どおり行います。 | なし |
| **自動化が稼働中** | レビュアーにレポートが表示され、各キューは選択した自律レベルに従って自ら判定できます。 | あり |

本番運用の前に、観察モードを7日間、14日間（デフォルト）、または30日間実行してください。セットアップ、観察モード、バックテストは一切課金されません。

## 自律レベル

キューごとに自律レベルを設定します。

| レベル | 動作 |
| - | - |
| **オフ** | 項目はレポートなしでレビュアーに届きます。 |
| **提案**（デフォルト） | Investigatorがレポートを準備します。すべての項目は担当者が判定します。 |
| **自動** | チームポリシーの対象となる項目のうち、信頼度が**高**で、かつチームの過去の判定との一致率がキューのしきい値を満たす場合に判定します。 |
| **完全自動** | 信頼度が**中**の項目も判定します。品質確認のため、一部のサンプルは引き続き担当者に回されます。 |

Investigatorが自ら判定するのは、以下の条件をすべて満たす場合のみです。

* アプリケーションが本番環境にあり、キューが**自動**または**完全自動**に設定され、一時停止されていない
* チームポリシーがその項目を対象としており、推奨されたアクションを実行するよう定めている
* ガードレールによって項目が保留されていない
* 直近90日間の20件以上の判定において、チームの過去の判定との一致率がしきい値を満たしている
* 項目が品質サンプルに選ばれておらず、ロールアウトの対象範囲内にあり、1日の上限に達していない

| キューの設定 | 値 |
| - | - |
| しきい値 | 一致率80、85、90（デフォルト）または95% |
| 品質サンプル | 判定済み項目の2、5（デフォルト）または10%を担当者に回す |
| 1日の上限 | デフォルトは1日200件 |
| ロールアウト | 段階的（14日間は項目の25%）またはすべての項目 |
| 金額上限 | 上限を超える取引は常に担当者に回されます。デフォルトはアプリケーションの通貨で25,000です。 |
| 自動昇格 | 一致率が98%に達するとレベルが1段階上がる |

キューを**自動**または**完全自動**に引き上げるには、まず過去の判定でバックテストを実行し、その結果を確認する必要があります。**ケース**と**AML**のキューは一括承認の対象にならず、エスカレーションされたケースや2人目のレビュアーを待っているケースが自動で判定されることはありません。

## ガードレール

以下のルールは常に有効で、変更できません。

* 制裁リストとの一致は必ず担当者に回されます。
* 不正やAMLに関する理由がエンドユーザーに伝わることはありません。
* 保護される属性に基づく判定は行いません。
* Investigatorが規制当局への報告を提出することはありません。
* すべての判定は記録され、上書きできます。

## レポートのレビュー

**Suggest**では、レビュアーは以下の操作を行えます。

* 推奨を**Accept**する
* 推奨を**Edit and accept**する
* カテゴリ（背景情報の不足、追加情報が必要、ポリシーとの相違、根拠の誤読、その他）と10〜500文字の理由を添えて推奨を**Override**する
* **Ready to accept**とマークされた項目を最大50件まで**Batch accept**する

推奨を承認すると、その項目の通常の処理経路で判定が適用されるため、通常のWebhookや通知が送信されます。エスカレーションを行うと、リンクされたケースが作成されます。Investigatorが下した判定には、項目に**Decided by the Investigator**というラベルが付きます。

## チームポリシー

各キューにはチームポリシーがあります。これは、何を承認、却下、エスカレーションするかを定めたチーム独自のルールです。Investigatorはこのポリシーに従い、ポリシーの対象となる項目に限って自ら判定します。ポリシーはバージョン管理されます。**質問**タブには、Investigatorがチームに確認を求める事項が集約されます。

## 監査証跡

**アクティビティ**タブには、すべてのレポート、承認、編集、オーバーライド、自動判定、ガードレールによる保留、設定変更が、実行者(Investigator、人物、APIキー、システム)とともに記録されます。記録は編集できません。最大10,000件の記録をCSVでエクスポートできます。

Investigatorが単独で下した判定は、組織の[監査ログ](https://docs.didit.me/ja/console/audit-logs.md)にも**The Investigator**の項目に記録され、該当するレポートにリンクされます。メンバーやAPIキーによる操作と並べて確認できます。

## 料金

Investigatorの料金は1種類のみで、**レビュー対象の認証(KYC、KYB、AMLヒット)、取引アラート、ケース1件あたり\$0.20**です。この料金で、Investigatorは記録を読み取り、推奨を含む出典付きのレポートを作成し、レビュアーに引き渡すか、ポリシーの範囲内で単独で判定します。

| レビュー対象 | 料金 |
| - | - |
| 認証(KYC、KYB、AMLヒット)、取引アラート、ケース | \$0.20 |

課金は1件につき1回で、アプリケーションが本番環境にあり、かつレポートが承認された場合、編集後に承認された場合、またはInvestigatorが単独で判定した場合に限られます。オーバーライド、チームが別途判定した項目、失敗した実行、シャドーモード、セットアップ、バックテストは無料です。プランの割引が適用されます。

**設定**で、任意の月間利用上限額を設定できます。上限に達すると、新しい項目はレポートなしでレビュアーに届きます。

## APIとWebhook

Investigator APIは`https://verification.didit.me/v3/investigator/`以下にあり、アプリケーションのAPIキー(`x-api-key`)を使用します。

| エンドポイント | 用途 |
| - | - |
| `GET summary/`、`GET queue/` | キューの件数と待機中の項目。 |
| `GET runs/{id}/` | 1件のレポート。 |
| `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`スコープも必要です。キューはすべてのワークフローにまたがるため、一部のワークフローまたは承認済みセッションに限定されたキーは拒否されます。リクエストとレスポンスの完全なスキーマは、[`openapi-25.json`](https://docs.didit.me/openapi-25.json)の**Investigator**タグにあります。

Investigator専用のWebhookはありません。[`status.updated` webhook](https://docs.didit.me/ja/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/ja/console/manual-review.md)
>
> チームが認証セッションをレビューする方法。

> [card] [ケース](https://docs.didit.me/ja/console/case-management/cases.md)
>
> アラートと調査のためのケース管理。


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