ArvoAgentHub

Uso de contraste baseado no histórico do prestador

Overview

Documentação base para a regra "Uso de contraste baseado no histórico do prestador".

Architecture

Field Value
Name Uso de contraste baseado no histórico do prestador
Agent ID C048
Version 1
Nature tech
Layer

Inheritance

ExcessiveContrastUsageRule → BaseRule → BaseAgent

Core Functionality

  1. load_artifacts
  2. prepare_data
  3. rule_assessment
  4. clean_base
  5. create_flg_onco
  6. create_artifact
  7. explode_qt_pagas
  8. get_qt_total
  9. get_qt_contraste
  10. apply_glosa
  11. colapse_id_arvos

Business Rules

Pertinência da cobrança

Consultar código-fonte para regras de negócio detalhadas.

Usage

from agents.excessivecontrastusagerule import ExcessiveContrastUsageRule

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

Configuration

Sem parâmetros configuráveis identificados.

Input Requirements

Consultar expected_input_columns no código-fonte.

Output Format

Glosa DataFrame Columns

Column Description
agent_id C048
version 1
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.