ArvoAgentHub

Pertinência de materiais

Overview

Agent to evaluate thermal blanket use pertinence based on the surgical procedures charged in the claim. It considers both material and fee charges. It is associated two agent IDs: - C051 for materials: Material Pertinence - C052 for fees: Fee Pertinence List of procedures where use of this material is pertinente is stored in the artifact ARTIFACTS.thermal_blanket_pert.

Este agente é usado com os seguintes IDs:

  • C051: Pertinência de materiais
  • C052: Pertinência de taxas

Architecture

Field Value
Name Pertinência de materiais
Agent ID C051, C052
Version 1
Nature tech
Layer

Inheritance

ThermalBlanketRule → BaseRule → BaseAgent

Core Functionality

  1. load_artifacts
  2. prepare_data
  3. rule_assessment

Business Rules

Pertinência da cobrança

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

Usage

from agents.thermalblanketrule import ThermalBlanketRule

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

Configuration

Sem parâmetros configuráveis identificados.

Input Requirements

Column Type Description
ARVO_COLUMNS.code_type - -
EVENT_COLUMNS.id_evento - -
ARVO_COLUMNS.code_type_predicted - -
ARVO_COLUMNS.id_evento_predicted - -
EVENT_COLUMNS.evento - -
EVENT_COLUMNS.vl_pago - -
EVENT_COLUMNS.id_fatura - -
EVENT_COLUMNS.id - -
EVENT_COLUMNS.qt_paga - -
EVENT_COLUMNS.dt_atendimento - -
EVENT_COLUMNS.categoria - -
BENEFICIARY_COLUMNS.dt_nascimento - -
ARVO_COLUMNS.proced_cir_inv_agg - -

Output Format

Glosa DataFrame Columns

Column Description
agent_id C051, C052
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.