Files
doczyai-pipelines/fieldExtraction/src/investment/dynamic_funcs.py
T
Praneel Panchigar 85f2c8cecc Merged in bugfix/bill_type_code_fixes (pull request #819)
Bugfix/bill type code fixes

* Fix LOB_PROGRAM_RELATIONSHIP extraction and preserve debugging code

- Add format requirements to LOB_RELATIONSHIP_INSTRUCTION for proper caching
- Strengthen LOB_RELATIONSHIP prompt with explicit pipe delimiter requirements
- Preserve all DEBUG blocks and print statements in dynamic_funcs.py and file_processing.py
- Update crosswalk mappings and gitignore
- Ensure format instructions are cached at API level to prevent missing pipe delimiters

* Merge main into bugfix/dynamic_issuefixes

Resolved merge conflicts in:
- fieldExtraction/src/investment/dynamic_funcs.py (merged debug print statements)
- fieldExtraction/src/investment/file_processing.py (merged debug statements and exhibit inheritance code)

All conflicts resolved successfully.

* Update FILL_BILL_TYPE prompt with place-of-service priority and optional exhibit_text

- Add optional exhibit_text parameter to FILL_BILL_TYPE function
- Update instructions to prioritize place-of-service over service-only terminology
- Add new examples: 'home dialysis' and 'dialysis' while keeping original examples
- Add conditional exhibit context section when exhibit_text is provided
- Maintains backward compatibility (exhibit_text defaults to None)

Ref: PLAN_BILL_TYPE_CD_IMPROVEMENTS.md

* Implement two-step bill type CD determination with exhibit text fallback

- Add EXHIBIT_TEXT to answer_dict in combine_one_to_n() for contextual analysis
- Update fill_bill_type() to use two-step approach:
  1. First attempt: service term only (no exhibit text)
  2. Second attempt: service term + exhibit text (only if first fails)
- Update extract_codes_from_service() to pass exhibit_text to fill_bill_type()
- Add debug print when full exhibit text context is used
- More efficient: only makes second LLM call when service term alone fails

Ref: PLAN_BILL_TYPE_CD_IMPROVEMENTS.md

* Remove debug print statement and merge main into bill_type_code_fixes

- Remove debug print statement from fill_bill_type() in code_funcs.py
- Merge latest changes from main branch
- Includes updates to prompt_templates.py (payer_name parameter)
- Includes updates to file_processing.py (provider info ordering)
- Includes updates to aarete_derived.py, crosswalk mappings, and tin_npi_funcs

* Remove remaining debug print statements from dynamic_funcs.py and file_processing.py


Approved-by: Katon Minhas
2025-12-26 18:24:57 +00:00

250 lines
9.7 KiB
Python

import logging
import src.investment.prompt_calls as prompt_calls
import src.utils.llm_utils as llm_utils
import src.utils.string_utils as string_utils
from constants.constants import Constants
from src import config
from src.prompts import prompt_templates
from src.prompts.fieldset import Field, FieldSet
def dynamic_primary(
exhibit_text: str,
exhibit_level_answers: dict,
constants: Constants,
filename: str,
dynamic_primary_fields: FieldSet,
):
"""
Processes dynamic primary fields one-by-one from exhibit header and chunk text.
Args:
exhibit_chunk (str): The main text chunk of the exhibit
exhibit_header (str): The header text of the exhibit
filename (str): Name of the file being processed
dynamic_fields (FieldSet): FieldSet containing the dynamic fields to process
Returns:
tuple: (dict, FieldSet) containing:
- exhibit_level_answer_dict: Dictionary of exhibit-level answers
- reimbursement_level_fields: FieldSet of fields assigned to reimbursement level
"""
if not dynamic_primary_fields.contains_fields():
return {}, FieldSet()
dynamic_reimbursement_fields = FieldSet()
exhibit_level_answer_dict = {}
for field in dynamic_primary_fields.fields:
exhibit_text_answer = prompt_calls.prompt_dynamic_primary(
exhibit_text,
field,
constants,
filename,
prompt_templates.DYNAMIC_PRIMARY_TEXT,
)
# If there is at least ONE Non-N/A answers in the Exhibit
if not string_utils.is_empty(exhibit_text_answer):
field.update_valid_values(exhibit_text_answer + " | N/A")
dynamic_reimbursement_fields.add_field(field)
dynamic_primary_fields.remove_field(field.field_name)
# If the field is not found, add to Exhibit-Level answers (the answer will be N/A or similar)
else:
exhibit_level_answer_dict[field.field_name] = exhibit_text_answer
# Update
exhibit_level_answers.update(exhibit_level_answer_dict)
return exhibit_level_answers, dynamic_reimbursement_fields
def dynamic(
exhibit_text: str,
exhibit_header: str,
exhibit_level_answers: dict,
constants: Constants,
filename: str,
dynamic_fields: FieldSet,
dynamic_reimbursement_fields: FieldSet,
):
"""
Processes dynamic (code and provider info) fields from exhibit header and chunk text.
Args:
exhibit_chunk (str): The main text chunk of the exhibit
exhibit_header (str): The header text of the exhibit
filename (str): Name of the file being processed
dynamic_fields (FieldSet): FieldSet containing the dynamic fields to process
Returns:
tuple: (dict, FieldSet) containing:
- exhibit_level_answer_dict: Dictionary of exhibit-level answers
- reimbursement_level_fields: FieldSet of fields assigned to reimbursement level
"""
if not dynamic_fields.contains_fields():
return {}, FieldSet()
dynamic_to_reimbursement_level_fields = FieldSet()
exhibit_level_answer_dict = {}
if not string_utils.is_empty(exhibit_header):
# Check Exhibit Header
exhibit_header_results = prompt_calls.prompt_dynamic(
text=exhibit_header,
field_prompts=dynamic_fields.print_prompt_dict(constants),
filename=filename,
)
# Process Exhibit Header Results - update dynamic fields and add to reimbursement level fields
for field_name, answer in exhibit_header_results.items():
if (
not string_utils.is_empty(answer)
and field_name in dynamic_fields.list_fields()
):
field = dynamic_fields.get_field(field_name)
field.update_valid_values(answer)
field.prompt = (
field.prompt
+ ". Ensure ALL values that apply to the specific reimbursement term are included."
)
dynamic_reimbursement_fields.add_field(field)
dynamic_fields.remove_field(field_name)
# Check Exhibit Text
if dynamic_fields.contains_fields():
exhibit_chunk_results = prompt_calls.prompt_dynamic(
text=exhibit_text,
field_prompts=dynamic_fields.print_prompt_dict(constants),
filename=filename,
)
# Process Exhibit Chunk Results - update dynamic fields and add to reimbursement level fields
for field_name, answer in exhibit_chunk_results.items():
if (
not string_utils.is_empty(answer)
and field_name in dynamic_fields.list_fields()
):
field = dynamic_fields.get_field(field_name)
field.update_valid_values(answer)
dynamic_to_reimbursement_level_fields.add_field(field)
dynamic_fields.remove_field(field_name)
# If the field is not found, add to Exhibit-Level answers (the answer will be N/A or similar)
else:
exhibit_level_answer_dict[field_name] = answer
# Update
exhibit_level_answers.update(exhibit_level_answer_dict)
dynamic_reimbursement_fields.combine(
dynamic_to_reimbursement_level_fields, inplace=True
)
return exhibit_level_answers, dynamic_reimbursement_fields
def dynamic_assignment(reimbursement_primary_answers: list[dict[str, str]], dynamic_reimbursement_fields: FieldSet, exhibit_text_simplified: str, page_num: str, constants: Constants, filename: str) -> list[dict[str, str]]:
# Process each answer and field individually
answer_dicts = []
# TODO: Cache here
# instruction, prompt = prompt_templates.DYNAMIC_ASSIGNMENT
# TODO: Multithread this loop
for answer_dict in reimbursement_primary_answers:
service_term = answer_dict['SERVICE_TERM']
reimb_term = answer_dict['REIMB_TERM']
for dynamic_field in dynamic_reimbursement_fields.fields:
dynamic_field_answer = prompt_calls.prompt_dynamic_assignment(service_term, reimb_term, dynamic_field, exhibit_text_simplified, page_num, constants, filename)
answer_dict.update(dynamic_field_answer)
answer_dicts.append(answer_dict)
return answer_dicts
def add_one_to_one_field(one_to_one_fields, field_to_add, answer_dicts, constants: Constants):
field_to_add.field_type = "smart_chunked"
field_to_add.relationship = "one_to_one"
# Special Handling for Program, Product, and Network:
# If any LOB value has been found, skip PROGRAM, PRODUCT, and NETWORK
# Only search for these fields when NO LOB has been found
# NOTE: Check raw LOB field, not AARETE_DERIVED_LOB, because AARETE_DERIVED_LOB
# is populated later via crosswalk and may be derived from PROGRAM/PRODUCT
if field_to_add.field_name in ["PROGRAM", "PRODUCT", "NETWORK"]:
lob_values = [
answer_dict.get("LOB", "") for answer_dict in answer_dicts
]
unique_lobs = set([lob for lob in lob_values if not string_utils.is_empty(lob)])
if len(unique_lobs) > 0:
return one_to_one_fields
if field_to_add.field_name == "CLAIM_TYPE_CD":
field_to_add.prompt = (
field_to_add.prompt
+ prompt_templates.FULL_CONTEXT_CLAIM_TYPES_ADDITIONAL_INSTRUCTION()
)
field_to_add.prompt = (
field_to_add.prompt
+ prompt_templates.FULL_CONTEXT_ADDITIONAL_INSTRUCTIONS(field_to_add.allow_na)
)
if field_to_add.valid_values:
field_to_add.keywords = field_to_add.get_valid_values(constants)
one_to_one_fields.add_field(field_to_add)
return one_to_one_fields
def get_dynamic_one_to_one_fields(answer_dicts: list[dict[str, str]], constants: Constants):
"""
Returns a FieldSet object of dynamic fields that have are empty for at least one dict in answer_dicts
"""
# These fields get passed to 1:1 if ALL of the answers are empty
all_empty_fields = FieldSet(
config.FIELD_JSON_PATH, relationship="one_to_n", base_field=True
)
one_to_one_fields = FieldSet() # Empty FieldSet to populate if criteria are met
# Check if any LOB value has been found - if so, skip PROGRAM, PRODUCT, NETWORK
# Only search for PROGRAM, PRODUCT, NETWORK when NO LOB has been found
# NOTE: Check raw LOB field, not AARETE_DERIVED_LOB, because AARETE_DERIVED_LOB
# is populated later via crosswalk and may be derived from PROGRAM/PRODUCT
lob_values = [
answer_dict.get("LOB", "") for answer_dict in answer_dicts
]
unique_lobs = set([lob for lob in lob_values if not string_utils.is_empty(lob)])
has_lob = len(unique_lobs) > 0
# Handle ALL empty fields
for field in all_empty_fields.fields:
field_name = field.field_name
if "REIMB" in field_name: # Don't do this for the REIMB_ fields
continue
empty_count = sum(
1 for answer_dict in answer_dicts
if string_utils.is_empty(answer_dict.get(field_name))
)
total_count = len(answer_dicts)
if empty_count == total_count:
# Skip PROGRAM, PRODUCT, NETWORK if any LOB has been found
# Only search for these fields when NO LOB has been found
if has_lob and field_name in ["PROGRAM", "PRODUCT", "NETWORK"]:
continue
field_to_add = Field.load_from_file(
file_path=config.FIELD_JSON_PATH,
field_name=field.base_field if field.base_field else field.field_name
) # Try base_field first, fall back to field_name if base_field is None/empty
one_to_one_fields = add_one_to_one_field(
one_to_one_fields, field_to_add, answer_dicts, constants
)
return one_to_one_fields