ArvoAgentHub

Painel Geral

Validação de Conselho do Profissional Solicitante

Overview

Flags claims where the requesting professional's council number is missing, invalid, or inactive. Uses a direct lookup against council reference tables loaded at init (no enricher dependency). v0: CRM only. Multi-council architecture via _COUNCIL_ARTIFACT_MAP.

Architecture

Field Value
Name Validação de Conselho do Profissional Solicitante
Agent ID T007
Version 0.0.0
Nature adm
Layer —

Inheritance

CouncilValidationRule → BaseAgent → BaseAgent

Core Functionality

  1. load_artifacts
  2. prepare_data
  3. rule_assessment

Business Rules

Validação de informações

Constantes:

  • NUMERO_NAO_INFORMADO = "numero_nao_informado"
  • NUMERO_INVALIDO = "numero_invalido"
  • REGISTRO_SUSPENSO_CASSADO = "registro_suspenso_cassado"

Usage

from agents.councilvalidationrule import CouncilValidationRule

rule = CouncilValidationRule()
violations_df = rule.rule_assessment(claims_df)

Configuration

rule = CouncilValidationRule(
    score=0.85,
    artifact_loader=ArtifactLoader(self.logger),
    score=score,
)

Input Requirements

Column Type Description
EVENT_COLUMNS.id - -
EVENT_COLUMNS.id_evento - -
EVENT_COLUMNS.vl_pago - -
EVENT_COLUMNS.qt_paga - -
PROVIDER_COLUMNS.conselho_profissional_solicitante - -
PROVIDER_COLUMNS.numero_conselho_solicitante - -
PROVIDER_COLUMNS.uf_conselho_regional_solicitante - -

Output Format

Glosa DataFrame Columns

Column Description
agent_id T007
version 0.0.0
id_arvo Original record ID
vl_glosa_arvo Glosa value
qt_glosa_arvo Glosa quantity
score_arvo Confidence score
motivo_glosa_arvo Detailed reason in Portuguese
motivo_glosa_ANS ANS standard code
data_dict JSON metadata with calculation details

Error Handling

  • DataFrames vazios retornam estrutura vazia com colunas obrigatórias.
  • Colunas ausentes geram warning mas não causam crash.
  • Conversões numéricas usam errors="coerce" para evitar falhas.