> ## 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 Investigador: revisão com IA para KYC, AML e casos > Deixe o Investigador da Didit preparar um relatório citado para cada verificação, alerta de transação e caso em análise, e escolha o que pode decidir. > [!WARNING] > > O Investigador é novo e ainda não está ativo em todas as organizações. Peça à Didit para o ativar. Requer o plano Growth ou superior e nunca é executado em aplicações sandbox. O Investigador analisa itens que aguardam a intervenção de uma pessoa. Para cada um, lê o registo, escreve um relatório com uma recomendação e a evidência que a sustenta, e ou aguarda pelo seu revisor ou, se o permitir, decide por conta própria. ## O que analisa | Fila | Item | Começa quando | | - | - | - | | KYC | Uma sessão de verificação | A sessão passa para **em análise**. | | KYB | Uma Verificação de empresas (KYB) | A sessão passa para **em análise**. | | AML | Uma sessão com uma correspondência de monitorização AML contínua | Chega uma nova correspondência. | | Transações | Um alerta de transação | A transação passa para **em análise**. | | Casos | Um caso | O caso é aberto ou reaberto. | Se a sua equipa decidir primeiro o item, a execução do Investigador termina sem decisão. ## O relatório Cada relatório contém: * uma **recomendação**: aprovar, recusar, pedir mais informação (reenvio de uma verificação, a aguardar pelo utilizador numa transação) ou escalar, * um **nível de confiança**: alto, moderado ou baixo, * um resumo e o raciocínio, * **evidência**: cada ponto é marcado como sem problemas, um risco, digno de atenção, explicado ou contexto, e cita as suas fontes, * para as correspondências de triagem, se cada correspondência é a mesma pessoa, não é a mesma pessoa ou não é clara, * os próximos passos sugeridos, como abrir um registo associado ou um caso. ### Fontes que cita O Investigador lê os mesmos dados que os seus revisores veem na consola e na API: a decisão de verificação, a decisão de Verificação de empresas (KYB), o detalhe da transação ou o detalhe do caso. Também pode abrir sessões, transações e casos associados. Cada ponto de evidência cita a secção do registo que leu ou o registo associado que abriu. O relatório mostra também **O que verifiquei**: a visão geral, as secções e os registos que leu, por ordem. Funciona apenas com base nesse registo. Antes de o registo chegar ao modelo, a Didit remove conteúdos multimédia, ligações e identificadores internos, e mascara características protegidas. O Investigador não pode alterar dados. Limita-se a escrever o seu relatório. ## Fases | Fase | O que acontece | Cobrança | | - | - | - | | **Não configurado** | O Investigador não é executado. | Não | | **Modo de observação** | Escreve relatórios e avalia o seu desempenho com base nas decisões da sua equipa. Os revisores decidem como habitualmente. | Não | | **A automatizaçã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 escolher. | Sim | Execute o modo de observação durante 7, 14 (predefinido) ou 30 dias antes de ir para produção. A configuração, o modo de observação e os testes retrospetivos 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** (predefinido) | Prepara o relatório. Uma pessoa decide cada item. | | **Automático** | Decide os itens abrangidos pela sua política, com confiança **alta**, quando a sua concordância passada com a equipa atinge o limiar da fila. | | **Totalmente automático** | Decide também os itens de confiança **moderada**. Uma amostra continua a ir para uma pessoa para controlos de qualidade. | O Investigador só decide por conta própria quando se verificam todas estas condições: * a aplicação está em produção e a fila está em **Automático** ou **Totalmente automático**, e não está em pausa, * a política da sua equipa abrange o item e indica que se deve tomar a ação recomendada, * nenhuma salvaguarda retém o item, * a concordância com as decisões passadas da sua equipa atinge o limiar, em pelo menos 20 decisões nos últimos 90 dias, * o item não foi selecionado para a amostra de qualidade, está dentro da percentagem de implementação e o limite diário não foi atingido. | Definição da fila | Valores | | - | - | | Limiar | 80, 85, 90 (predefinido) ou 95% de concordância | | Amostra de qualidade | 2, 5 (predefinido) ou 10% dos itens decididos vão para uma pessoa | | Limite diário | O valor predefinido é de 200 itens por dia | | Implementação | Gradual (25% dos itens durante 14 dias) ou todos os itens | | Limite de montante | As transações acima deste valor vão sempre para uma pessoa. Predefinido 25 000 na moeda da sua aplicação. | | Avançar automaticamente | Sobe um nível quando a concordância atinge 98% | Para passar uma fila para **Automático** ou **Totalmente automático**, execute primeiro um teste retrospetivo sobre decisões passadas e confirme o resultado. As filas **Casos** e **AML** nunca são aceites em lote, e os casos escalados ou os casos a aguardar um segundo revisor nunca são decididos automaticamente. ## Salvaguardas Estas regras estão sempre ativas e não podem ser alteradas: * As correspondências com sanções vão sempre para uma pessoa. * Os motivos de fraude e de AML nunca chegam aos utilizadores finais. * Nenhuma decisão se baseia em características protegidas. * O Investigador nunca apresenta um relatório regulamentar. * Cada decisão é registada e pode ser substituída. ## Rever um relatório Em **Sugerir**, um revisor pode: * **Aceitar** a recomendação, * **Editar e aceitar** a recomendação, * **Substituir** a recomendação, indicando uma categoria (contexto em falta, necessidade de mais informação, política diferente, evidência mal interpretada, outra) e um motivo com 10 a 500 caracteres, * **Aceitar em lote** até 50 itens marcados como **Prontos a aceitar**. Aceitar uma recomendação aplica a decisão pelo caminho normal do item, pelo que disparam os webhooks e as notificações habituais. Uma escalada abre um caso associado. Uma decisão tomada pelo Investigador aparece no item com a indicação **Decidido pelo Investigador**. ## Política da equipa Cada fila tem uma política da equipa: as suas regras sobre o que aprovar, recusar ou escalar. O Investigador segue-a e só decide por conta própria quando a política abrange o item. As políticas são versionadas. O separador **Perguntas** reúne os pontos que o Investigador precisa que a sua equipa esclareça. ## Registo de auditoria O separador **Atividade** regista cada relatório, aceitação, edição, substituição, decisão automatizada, bloqueio por salvaguarda e alteração de definições, indicando quem a realizou: o Investigator, uma pessoa, uma chave de API ou o sistema. As entradas não podem ser editadas. Exporte até 10 000 entradas em CSV. Cada decisão que o Investigator toma por iniciativa própria é também registada no [registo de auditoria](https://docs.didit.me/pt/console/audit-logs.md) da sua organização, em **The Investigator** e associada ao respetivo relatório, juntamente com as ações dos seus membros e chaves de API. ## Preços O Investigator tem um único preço: **\$0.20 por verificação analisada (KYC, KYB ou ocorrência AML), alerta de transação ou caso**. Por este preço, lê o registo, escreve um relatório com citações e a sua recomendação, e ou o entrega ao seu revisor ou decide por si próprio, dentro da sua política. | Item analisado | Preço | | - | - | | Verificação (KYC, KYB ou ocorrência AML), alerta de transação ou caso | \$0.20 | Cobra-se uma vez por item, apenas quando a aplicação está em produção e o relatório é aceite, ou editado e depois aceite, ou quando o Investigator decide por si próprio. Substituições, itens que a sua equipa decidiu noutro local, execuções falhadas, modo sombra, configuração e testes retrospetivos são gratuitos. Aplicam-se descontos do plano. Pode definir um limite mensal de gastos opcional em **Definições**. Ao atingir o limite, os novos itens chegam aos revisores sem relatório. ## API e webhooks A API do Investigator encontra-se em `https://verification.didit.me/v3/investigator/` e utiliza 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/` | Atuar sobre relatórios. | | `GET transactions/{id}/` | O relatório de uma transação. | | `GET dashboard/`, `GET performance/`, `GET activity/`, `GET activity/export/` | Resultados e registo de auditoria. | | `GET guardrails/` | As salvaguardas fixas. | | `GET` / `PATCH settings/` | Fase e limite mensal de gastos. | Uma chave de API restrita precisa do âmbito `decisions` para ler e atuar sobre relatórios, e do âmbito `applications` para ler ou alterar definições. Os relatórios de transações exigem também o âmbito `transactions`. As chaves limitadas a alguns fluxos ou a sessões aprovadas são recusadas, porque a fila abrange todos os fluxos. Os esquemas completos de pedidos e respostas estão em [`openapi-25.json`](https://docs.didit.me/openapi-25.json), na etiqueta **Investigator**. Não existe um webhook separado para o Investigator. A `decision` num [webhook `status.updated`](https://docs.didit.me/pt/integration/webhooks#bloco-do-investigator) e em `GET /v3/session/{id}/decision/` inclui um bloco `investigator` com o `status`, a `recommendation`, a `confidence`, o `summary`, o `ready_to_accept`, o `automated` e o `decided_by` (`investigator` ou `member`) da execução. ## Relacionados > [card] [Revisão manual](https://docs.didit.me/pt/console/manual-review.md) > > Como a sua equipa revê as sessões de verificação. > [card] [Casos](https://docs.didit.me/pt/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.