ArvoAgentHub

Pertinencia de materiais

Overview

The PertinentMatRule class is responsible for evaluating the pertinence of materials in healthcare billing data. It includes methods for loading artifacts, preparing data, and performing rule assessments with optional machine learning integration. The rule identifies non-pertinent materials based on predefined criteria, taxonomy, and virtual procedures, and generates glosas (billing discrepancies) for further review.

Este agente é usado com os seguintes IDs:

  • C021: Pertinência de materiais
  • C043: Pertinência de materiais

Architecture

Field Value
Name Pertinencia de materiais
Agent ID C021, C043
Version 2.0
Nature tech
Layer

Inheritance

PertinentMatRule → BaseRule → BaseAgent

Core Functionality

  1. load_item_block_list
  2. load_item_conditioned_block_list
  3. load_tax_5_conditioned_block_list
  4. load_artifacts
  5. prepare_data
  6. rule_assessment

Business Rules

Pertinência da cobrança

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

Usage

from agents.pertinentmatrule import PertinentMatRule

rule = PertinentMatRule()
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 C021, C043
version 2.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.