> ## 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 и кейсов

> Investigator от Didit готовит отчёт с источниками по каждой верификации, оповещению и кейсу; вы решаете, какие решения он принимает сам.

> [!WARNING]
>
> Расследователь новый и пока включён не для всех организаций. Попросите Didit включить его. Для работы нужен тариф Growth или выше, и он никогда не запускается в приложениях в песочнице.

Расследователь проверяет элементы, которые ждут решения человека. Для каждого он читает запись, пишет отчёт с рекомендацией и доказательствами, на которых она основана, и либо ждёт вашего проверяющего, либо, если вы разрешили, принимает решение самостоятельно.

## Что он проверяет

| Очередь | Элемент | Запускается, когда |
| - | - | - |
| KYC | Сессия верификации | Сессия переходит в статус **На проверке**. |
| KYB | Верификация бизнеса | Сессия переходит в статус **На проверке**. |
| AML | Сессия с совпадением при постоянном AML-мониторинге | Поступает новое совпадение. |
| Транзакции | Оповещение о транзакции | Транзакция переходит в статус **На проверке**. |
| Кейсы | Кейс | Кейс открывается или повторно открывается. |

Если ваша команда сначала примет решение по элементу, запуск Расследователя закрывается без решения.

## Отчёт

Каждый отчёт содержит:

* **рекомендацию**: одобрить, отклонить, запросить дополнительную информацию (повторная отправка для верификации, ожидание пользователя для транзакции) или эскалировать,
* **уверенность**: высокая, умеренная или низкая,
* краткое изложение и обоснование,
* **доказательства**: каждый пункт помечен как в порядке, риск, стоит проверить, пояснено или контекст, и содержит ссылки на источники,
* для совпадений при скрининге: является ли каждое совпадение тем же человеком, не тем же человеком или неясно,
* предлагаемые следующие шаги, например открытие связанной записи или кейса.

### Какие источники он цитирует

Расследователь читает те же данные, что видят ваши проверяющие в консоли и через API: решение по верификации, решение по верификации бизнеса, детали транзакции или детали кейса. Он также может открывать связанные сессии, транзакции и кейсы. Каждый пункт доказательств ссылается на раздел записи, который он прочитал, или на связанную запись, которую он открыл. В отчёте также показан раздел **Что было проверено**: обзор, разделы и записи, которые он прочитал, в порядке их просмотра.

Он работает только с этой записью. Прежде чем запись попадает в модель, Didit удаляет медиафайлы, ссылки и внутренние идентификаторы и маскирует защищённые характеристики. Расследователь не может изменять данные. Он только пишет отчёт.

## Этапы

| Этап | Что происходит | Оплачивается |
| - | - | - |
| **Не настроено** | Расследователь не запускается. | Нет |
| **Режим наблюдения** | Он пишет отчёты и оценивает себя на основе решений вашей команды. Проверяющие решают как обычно. | Нет |
| **Автоматизация включена** | Отчёты появляются у проверяющих, а очереди могут принимать решения самостоятельно на выбранном вами уровне автономности. | Да |

Перед включением автоматизации запустите режим наблюдения на 7, 14 (по умолчанию) или 30 дней. Настройка, режим наблюдения и бэктесты никогда не оплачиваются.

## Уровни автономности

Задайте уровень автономности для каждой очереди:

| Уровень | Что он делает |
| - | - |
| **Выключено** | Элементы попадают к проверяющим без отчёта. |
| **Предлагать** (по умолчанию) | Он готовит отчёт. Решение по каждому элементу принимает человек. |
| **Авто** | Он решает элементы, которые покрывает ваша политика, при **высокой** уверенности, если его степень совпадения с прошлыми решениями вашей команды достигает порога очереди. |
| **Полностью авто** | Он также решает элементы с **умеренной** уверенностью. Контрольная выборка всё равно передаётся человеку для проверки качества. |

Расследователь принимает решение самостоятельно, только если выполнены все условия:

* приложение работает в продакшн-среде, очередь находится на уровне **Авто** или **Полностью авто** и не приостановлена,
* ваша политика команды покрывает элемент и требует выполнить рекомендованное действие,
* ни одно защитное ограничение не блокирует обработку элемента,
* его совпадение с прошлыми решениями вашей команды достигает порога, при этом учтено не менее 20 решений за последние 90 дней,
* элемент не выбран для контрольной выборки, входит в долю раскатки, и дневной лимит не достигнут.

| Настройка очереди | Значения |
| - | - |
| Порог | 80, 85, 90 (по умолчанию) или 95% совпадения |
| Контрольная выборка | 2, 5 (по умолчанию) или 10% решённых элементов передаются человеку |
| Дневной лимит | По умолчанию 200 элементов в день |
| Раскатка | Постепенная (25% элементов в течение 14 дней) или все элементы |
| Лимит суммы | Транзакции выше этого лимита всегда передаются человеку. По умолчанию 25 000 в валюте вашего приложения. |
| Автоматический переход на следующий уровень | Переход на уровень выше, когда совпадение достигает 98% |

Чтобы перевести очередь на уровень **Авто** или **Полностью авто**, сначала запустите бэктест на прошлых решениях и подтвердите результат. Элементы из очередей **Кейсы** и **AML** никогда не принимаются пакетно, а эскалированные кейсы и кейсы, ожидающие второго проверяющего, никогда не решаются автоматически.

## Защитные ограничения

Эти правила всегда включены и не могут быть изменены:

* Совпадения с санкционными списками всегда передаются человеку.
* Причины, связанные с мошенничеством и AML, никогда не попадают к конечным пользователям.
* Ни одно решение не основано на защищённых характеристиках.
* Расследователь никогда не подаёт регуляторные отчёты.
* Каждое решение записывается в журнал и может быть переопределено.

## Проверка отчёта

На уровне **Предлагать** проверяющий может:

* **Принять** рекомендацию,
* **Изменить и принять** её,
* **Переопределить** её, указав категорию (недостаточно контекста, нужна информация, политика отличается, доказательства поняты неверно, другое) и причину длиной от 10 до 500 символов,
* **Принять пакетно** до 50 элементов, отмеченных как **Готовы к принятию**.

Принятие рекомендации применяет решение обычным способом обработки элемента, поэтому ваши обычные webhook и уведомления срабатывают. Эскалация открывает связанный кейс. Решение, принятое Расследователем, помечается на элементе как **Решено расследователем**.

## Политика команды

У каждой очереди есть политика команды: ваши правила, что одобрять, отклонять или эскалировать. Расследователь следует ей, и он решает самостоятельно только там, где политика распространяется на элемент. Политики версионируются. Вкладка **Вопросы** собирает пункты, которые вашей команде нужно уточнить для Расследователя.

## Журнал аудита

Вкладка **Активность** фиксирует каждый отчёт, принятие, правку, переопределение, автоматическое решение, блокировку защитного ограничения и изменение настроек. Для каждой записи указано, кто её совершил: Расследователь, человек, API-ключ или система. Записи нельзя редактировать. Можно экспортировать до 10,000 записей в CSV.

Каждое решение, которое Расследователь принимает самостоятельно, также записывается в [журнал аудита](https://docs.didit.me/ru/console/audit-logs.md) вашей организации в разделе **Расследователь** и привязывается к своему отчёту. Там же видны действия ваших участников и API-ключей.

## Цены

Расследователь имеет одну цену: **\$0.20 за проверенную верификацию (KYC, KYB или срабатывание AML), оповещение о транзакции или кейс**. За эту цену он изучает запись, пишет отчёт с указанием источников и рекомендацией и либо передаёт его вашему проверяющему, либо принимает решение самостоятельно в рамках вашей политики.

| Проверяемый элемент | Цена |
| - | - |
| Верификация (KYC, KYB или срабатывание AML), оповещение о транзакции или кейс | \$0.20 |

Плата взимается однократно за каждый элемент, и только когда приложение работает в продакшн-среде и отчёт принят, или отредактирован и принят, или Расследователь принимает решение самостоятельно. Переопределения, элементы, по которым ваша команда решила вопрос в другом месте, неудачные запуски, теневой режим, настройка и бэктесты бесплатны. Скидки по тарифу применяются.

Задайте необязательный лимит ежемесячных расходов в **Настройки**. При достижении лимита новые элементы поступают проверяющим без отчёта.

## API и webhooks

API Расследователя доступен по адресу `https://verification.didit.me/v3/investigator/` и использует API-ключ вашего приложения (`x-api-key`).

| Endpoint | Назначение |
| - | - |
| `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`. Ключи, ограниченные отдельными сценариями или одобренными сессиями, отклоняются, поскольку очередь охватывает все сценарии. Полные схемы запросов и ответов находятся в [`openapi-25.json`](https://docs.didit.me/openapi-25.json) под тегом **Investigator**.

Отдельного webhook для Расследователя нет. В поле `decision` [webhook `status.updated`](https://docs.didit.me/ru/integration/webhooks#блок-investigator) и в ответе `GET /v3/session/{id}/decision/` есть блок `investigator` с полями `status`, `recommendation`, `confidence`, `summary`, `ready_to_accept`, `automated` и `decided_by` (`investigator` или `member`).

## Связанные материалы

> [card] [Ручная проверка](https://docs.didit.me/ru/console/manual-review.md)
>
> Как ваша команда проверяет сессии верификации.

> [card] [Кейсы](https://docs.didit.me/ru/console/case-management/cases.md)
>
> Управление кейсами для оповещений и расследований.


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