Agente de Investigação de Fraude de IA

🔍 Agente de Investigação de Fraude com IA

Um agente de investigação de fraude autónomo com IA que cruza registos de licenciamento de prestadores de cuidados infantis com dados de edifícios físicos para detetar anomalias. O agente utiliza dados públicos - registos de propriedades do Condado de Cook, licenciamento do DCFS de Illinois, Google Maps e o Secretário de Estado - para encontrar instalações onde as evidências físicas não correspondem à documentação.

Funcionalidades

• Pesquisa na base de dados de licenciamento do DCFS de Illinois por prestadores através do código postal
• Cruza a capacidade licenciada com a área real do edifício a partir dos registos GIS do Condado de Cook
• Aplica a matemática do código de construção de IL para calcular a ocupação máxima legal de cuidados infantis
• Analisa imagens do Google Street View para verificar se uma instalação parece um verdadeiro centro de cuidados infantis
• Verifica o Google Places para o estado do negócio, classificação e se o endereço apresenta um negócio completamente diferente
• Verifica o registo da entidade empresarial com o Secretário de Estado de Illinois
• Descobre padrões entre prestadores: proprietários partilhados, agrupamentos de endereços, entidades sem presença pública
• Narra toda a sua investigação em tempo real - o raciocínio é visível enquanto o agente trabalha

Como Começar?

1. Clona o repositório do GitHub

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent

Para instalar as dependências necessárias, executa o seguinte comando:

npm install

pip install -r requirements.txt

3. Obtém a tua Chave de API do OpenRouter

• Regista-te em openrouter.ai e cria uma chave de API
• O nível gratuito é suficiente para investigações de demonstração
• Modelo por defeito: anthropic/claude-sonnet-4.6

4. Obtém a tua Chave de API do Google Maps (opcional - salta a análise visual se omitido)

• Cria um projeto em console.cloud.google.com
• Ativa: Geocoding API, Places API, Street View Static API
• Cria uma chave de API e restringe-a a estas três APIs

5. Executa a Aplicação Streamlit

streamlit run fraud_investigation_agent.py

Como Funciona?

O Agente de Investigação de Fraude AI utiliza 7 ferramentas especializadas, todas alimentadas por fontes de dados públicas:

• Pesquisa de Fornecedores - Consulta o portal de licenciamento do Illinois DCFS para todos os fornecedores ativos num código postal, retornando capacidade, tipo de licença e estado da licença

• Análise de Propriedades - Obtém a área do edifício, tamanho do lote, classe da propriedade e ano de construção a partir dos dados abertos do Avaliador do Condado de Cook (API Socrata, sem autenticação necessária)

• Cálculo de Capacidade - Aplica a matemática do código de construção da Parte 407 do Illinois DCFS: (building_sqft × 0.65) ÷ 35 = max legal children. Um edifício de 900 pés quadrados não pode legalmente atender 50 crianças - isto é uma impossibilidade matemática, não uma opinião

• Street View - Captura imagens do Google Street View em quatro direções para verificar se o endereço parece uma verdadeira instalação de cuidados infantis ou algo completamente diferente

• Informações sobre Locais - Consulta o Google Places para o negócio atual listado no endereço, seu estado de funcionamento, classificação e avaliações recentes

• Registo de Negócios - Investiga o Secretário de Estado do Illinois para verificar se o fornecedor é uma entidade legal registada

• Geocodificação - Converte endereços em coordenadas para análise espacial

O agente investiga cada fornecedor no código postal, narrando o seu raciocínio enquanto trabalha. Quando nota algo suspeito - um edifício demasiado pequeno para a sua licença, uma loja fechada que afirma operar cuidados infantis, um nome que aparece em vários fornecedores - segue essa pista e explica por que é relevante.

O que o Agente Pode (e Não Pode) Detetar

Pode detetar:

• Capacidade licenciada fisicamente impossível para o tamanho do edifício
• Endereços onde o Google mostra um negócio diferente ou um edifício fechado/vago
• Fornecedores sem listagem no Google, sem avaliações, sem registo de negócios
• Nomes de proprietários ou agentes partilhados que aparecem em vários fornecedores

Não pode detetar:

• Fraude de presença (cobrança por crianças que não apareceram) - requer registos de faturação CCAP não públicos
• Qualquer fraude que exija acesso a dados de faturação internos do DHS ou do condado

Todas as descobertas são pistas de investigação, não conclusões legais. O agente utiliza linguagem como "requer investigação adicional" e "exibe anomalias" - nunca "fraude".

Âmbito Geográfico

Esta demonstração cobre apenas o Condado de Cook, Illinois. Os dados sobre propriedades são obtidos a partir dos dados abertos do Avaliador do Condado de Cook, pelo que o seletor de códigos postais está limitado a 10 bairros de alta densidade de Chicago conhecidos por concentrações de fornecedores de cuidados infantis subsidiados:

O sistema completo Surelock Homes suporta Minnesota e outros condados de Illinois com um backend FastAPI, painel de streaming e modo offline.