> ## 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. # Agente Investigator: revisão com IA para KYC, AML e casos > O Investigator da Didit prepara relatórios com fontes para verificações, alertas de transação e casos em revisão, e decide até onde você permitir. > [!WARNING] > > O Investigador é novo e ainda não está habilitado para todas as organizações. Peça à Didit para ativá-lo. Ele exige o plano Growth ou superior e nunca é executado em aplicações de sandbox. O Investigador analisa os itens que estão aguardando uma pessoa. Para cada um, ele lê o registro, escreve um relatório com uma recomendação e as evidências que a sustentam e, então, aguarda o seu revisor ou, quando você permite, decide por conta própria. ## O que ele analisa | Fila | Item | Começa quando | | - | - | - | | KYC | Uma sessão de verificação | A sessão passa para **In Review**. | | KYB | Uma verificação de empresa | A sessão passa para **In Review**. | | AML | Uma sessão com um alerta de monitoramento AML contínuo | Chega um novo alerta. | | Transações | Um alerta de transação | A transação passa para **In Review**. | | Casos | Um caso | O caso é aberto ou reaberto. | Se a sua equipe decidir o item primeiro, a execução do Investigador é encerrada sem uma decisão. ## O relatório Cada relatório contém: * uma **recomendação**: aprovar, recusar, solicitar mais informações (reenvio, no caso de uma verificação; aguardar o usuário, no caso de uma transação) ou escalar, * uma **confiança**: alta, moderada ou baixa, * um resumo e a fundamentação, * **evidências**: cada ponto é marcado como ok, risco, merece atenção, explicado ou contexto, e cita suas fontes, * para alertas de triagem, se cada alerta corresponde à mesma pessoa, não corresponde à mesma pessoa ou é inconclusivo, * próximos passos sugeridos, como abrir um registro vinculado ou um caso. ### Fontes que ele cita O Investigador lê os mesmos dados que os seus revisores veem no console e na API: a decisão da verificação, a decisão da verificação de empresa, os detalhes da transação ou os detalhes do caso. Ele também pode abrir sessões, transações e casos vinculados. Cada ponto de evidência cita a seção do registro que ele leu ou o registro vinculado que ele abriu. O relatório também mostra **O que verifiquei**: a visão geral, as seções e os registros que ele leu, em ordem. Ele trabalha apenas a partir desse registro. Antes que o registro chegue ao modelo, a Didit remove conteúdo de mídia, links e identificadores internos e mascara características protegidas. O Investigador não pode alterar dados. Ele apenas escreve o seu relatório. ## Estágios | Estágio | O que acontece | Cobrado | | - | - | - | | **Não configurado** | O Investigator não é executado. | Não | | **Modo de observação** | Ele gera relatórios e calcula sua pontuação com base nas decisões da sua equipe. Os revisores decidem normalmente. | Não | | **A automação está ativa** | Os relatórios aparecem para os revisores, e as filas podem decidir por conta própria no nível de autonomia que você escolher. | Sim | Execute o modo de observação por 7, 14 (o padrão) ou 30 dias antes de entrar em produção. Configuração, modo de observação e backtests nunca são cobrados. ## Níveis de autonomia Defina um nível de autonomia para cada fila: | Nível | O que faz | | - | - | | **Desativado** | Os itens chegam aos revisores sem relatório. | | **Sugerir** (padrão) | Ele prepara o relatório. Uma pessoa decide cada item. | | **Automático** | Ele decide os itens que a sua política cobre, com confiança **alta**, quando a concordância passada dele com a sua equipe atinge o limiar da fila. | | **Totalmente automático** | Ele também decide itens com confiança **moderada**. Uma amostra ainda vai para uma pessoa para controle de qualidade. | O Investigador decide por conta própria somente quando todas estas condições são atendidas: * a aplicação está em produção e a fila está em **Automático** ou **Totalmente automático**, e não está pausada, * a política da sua equipe cobre o item e determina tomar a ação recomendada, * nenhuma salvaguarda bloqueia o item, * a concordância dele com as decisões passadas da sua equipe atinge o limiar, considerando pelo menos 20 decisões nos últimos 90 dias, * o item não foi selecionado para a amostra de qualidade, está dentro do percentual de implantação e o limite diário não foi atingido. | Configuração da fila | Valores | | - | - | | Limiar | 80, 85, 90 (padrão) ou 95% de concordância | | Amostra de qualidade | 2, 5 (padrão) ou 10% dos itens decididos vão para uma pessoa | | Limite diário | Padrão de 200 itens por dia | | Implantação | Gradual (25% dos itens por 14 dias) ou todos os itens | | Teto de valor | Transações acima dele sempre vão para uma pessoa. Padrão de 25.000 na moeda da sua aplicação. | | Avançar automaticamente | Subir um nível quando a concordância atingir 98% | Para subir uma fila para **Automático** ou **Totalmente automático**, você primeiro executa um backtest com decisões passadas e confirma o resultado. As filas **Casos** e **AML** nunca são aceitas em lote, e casos escalados ou casos aguardando um segundo revisor nunca são decididos automaticamente. ## Salvaguardas Estas regras estão sempre ativas e não podem ser alteradas: * Correspondências com sanções são sempre encaminhadas a uma pessoa. * Motivos de fraude e AML nunca são comunicados aos usuários finais. * Nenhuma decisão se baseia em características protegidas. * O Investigador nunca apresenta um relatório regulatório. * Toda decisão é registrada e pode ser anulada. ## Analisando um relatório No nível **Sugerir**, um revisor pode: * **Aceitar** a recomendação, * **Editar e aceitar** a recomendação, * **Substituir** a recomendação, com uma categoria (falta de contexto, precisa de informações, política diferente, evidência mal interpretada, outro) e um motivo de 10 a 500 caracteres, * **Aceitar em lote** até 50 itens marcados como **Prontos para aceitar**. Aceitar uma recomendação aplica a decisão pelo caminho normal do item, então os seus webhooks e notificações habituais são disparados. Um escalonamento abre um caso vinculado. Uma decisão tomada pelo Investigador é identificada como **Decidido pelo Investigador** no item. ## Política da equipe Cada fila tem uma política de equipe: as suas regras sobre o que aprovar, recusar ou escalar. O Investigador a segue e só decide por conta própria quando a política cobre o item. As políticas são versionadas. A aba **Perguntas** reúne os pontos que o Investigador precisa que a sua equipe esclareça. ## Trilha de auditoria A aba **Atividade** registra cada relatório, aceitação, edição, substituição, decisão automatizada, retenção por barreira de proteção e alteração de configurações, junto com quem fez cada ação: o Investigador, uma pessoa, uma chave de API ou o sistema. Os registros não podem ser editados. Você pode exportar até 10.000 registros em CSV. Cada decisão que o Investigador toma por conta própria também é gravada no [registro de auditoria](https://docs.didit.me/pt-br/console/audit-logs.md) da sua organização, em **O Investigador** e vinculada ao relatório correspondente, ao lado das ações dos seus membros e das suas chaves de API. ## Preços O Investigador tem um único preço: **\$0.20 por verificação revisada (KYC, KYB ou ocorrência de AML), alerta de transação ou caso**. Por esse preço, ele lê o registro, escreve um relatório com citações e sua própria recomendação e, em seguida, encaminha o relatório ao seu revisor ou decide por conta própria dentro da sua política. | Item revisado | Preço | | - | - | | Verificação (KYC, KYB ou ocorrência de AML), alerta de transação ou caso | \$0.20 | A cobrança é feita uma vez por item, somente quando a aplicação está em produção e o relatório é aceito, editado e aceito, ou quando o Investigador decide por conta própria. Sobrescritas, itens que a sua equipe decidiu em outro lugar, execuções com falha, modo sombra, configuração e backtests são gratuitos. Os descontos do plano se aplicam. Defina um limite opcional de gasto mensal em **Configurações**. Ao atingir o limite, os novos itens chegam aos revisores sem relatório. ## API e webhooks A API do Investigador fica em `https://verification.didit.me/v3/investigator/` e usa a chave de API da sua aplicação (`x-api-key`). | Endpoint | Finalidade | | - | - | | `GET summary/`, `GET queue/` | Contagens da fila e os itens em espera. | | `GET runs/{id}/` | Um relatório. | | `POST runs/{id}/accept/`, `POST runs/{id}/override/`, `POST runs/batch-accept/` | Tomar medidas em relação aos relatórios. | | `GET transactions/{id}/` | O relatório de uma transação. | | `GET dashboard/`, `GET performance/`, `GET activity/`, `GET activity/export/` | Resultados e a trilha de auditoria. | | `GET guardrails/` | As restrições bloqueadas. | | `GET` / `PATCH settings/` | Estágio e limite de gasto mensal. | Uma chave de API restrita precisa do escopo `decisions` para ler relatórios e agir sobre eles, e do escopo `applications` para ler ou alterar as configurações. Os relatórios de transações também exigem o escopo `transactions`. Chaves limitadas a alguns fluxos ou a sessões aprovadas são recusadas, porque a fila abrange todos os fluxos. Os esquemas completos de requisição e resposta estão em [`openapi-25.json`](https://docs.didit.me/openapi-25.json), na tag **Investigator**. Não existe um webhook separado para o Investigador. O `decision` em um [webhook `status.updated`](https://docs.didit.me/pt-br/integration/webhooks#bloco-do-investigator) e em `GET /v3/session/{id}/decision/` inclui um bloco `investigator` com `status`, `recommendation`, `confidence`, `summary`, `ready_to_accept`, `automated` e `decided_by` (`investigator` ou `member`) da execução. ## Relacionados > [card] [Revisão manual](https://docs.didit.me/pt-br/console/manual-review.md) > > Como a sua equipe revisa as sessões de verificação. > [card] [Casos](https://docs.didit.me/pt-br/console/case-management/cases.md) > > Gestão de casos para alertas e investigações. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.