How willlzl/topify-hackathon-healthcare-agent works
Hivemind automates healthcare claim follow-up: it ingests claim spreadsheets, processes claims through a worker pipeline, checks payer portals or calls payers, records outcomes, and routes human escalations through the organization graph and Teams. The graph preserves the documented workflow and major integrations, plus the persistence and control-plane layers. Some subsystem links rely on README descriptions or SOURCE INDEX references; unsampled implementation details and uncertain call paths are not expanded.
Main entry points: agent_worker.py Agent worker · step_handlers.py Claim step handlers · sheets_reader.py Claim ingestion · playwright_forta.py Portal agents
Components 21
Claim workflow
- Claim ingestion
ingestion/sheets_reader.py - Agent worker
worker/agent_worker.py - Claim step handlers
worker/step_handlers.py - LLM reasoning
worker/claude_brain.py - Agent tools
worker/tools.py
Payer operations
- Browser automation
agents/browser_agent.py - Portal agents
agents/playwright_forta.py - Payer checkers
agents/availity_checker.py - Calling service
services/calling_service.py - Voice caller
calling/elevenlabs_caller.py - Call parsing
calling/transcript_parser.py - Payer portals
Human handoffs
- Organization graph
integrations/org_graph.py - Teams integration
integrations/teams.py
Control and state
- FastAPI control plane
api/main.py - Claim state
hivemind/db/models.py - Database sessions
hivemind/db/engine.py
Shared runtime
- Runtime settings
config/settings.py - Structured logging
utils/logging.py
Other components
- Clinic operator
- Clinic teammate
Connections 26
- Clinic operator → Claim ingestion: provides claims
- Claim ingestion → Claim step handlers: supplies claim data
worker/step_handlers.py - Clinic operator → Agent worker: starts claim run
- FastAPI control plane → Agent worker: dispatches test run
api/main.py - Agent worker → Claim step handlers: dispatches steps
worker/agent_worker.py - Agent worker → LLM reasoning: uses reasoning
worker/agent_worker.py - Agent worker → Agent tools: provides tools
worker/agent_worker.py - Claim step handlers → Agent tools: invokes tools
worker/step_handlers.py - Claim step handlers → Payer checkers: checks payer portals
worker/step_handlers.py - Agent tools → Portal agents: invokes portal agent
worker/tools.py - Portal agents → Browser automation: uses browser engine
agents/playwright_forta.py - Portal agents → Payer portals: automates portal
- Claim step handlers → Calling service: requests payer call
worker/step_handlers.py - Calling service → Voice caller: places call
services/calling_service.py - Calling service → Call parsing: parses transcript
services/calling_service.py - Voice caller → Payer portals: calls payer
- Agent worker → Organization graph: routes handoff
worker/agent_worker.py - Agent worker → Teams integration: sends escalation
worker/agent_worker.py - Organization graph → Teams integration: selects teammate
- Teams integration → Clinic teammate: messages teammate
- FastAPI control plane → Claim state: serves voice lookups
api/main.py - Claim state → Database sessions: uses sessions
hivemind/db/models.py - Claim step handlers → Claim state: reads claim state
worker/step_handlers.py - Claim ingestion → Runtime settings: reads sheet config
ingestion/sheets_reader.py - Agent worker → Runtime settings: reads runtime config
worker/agent_worker.py - Agent worker → Structured logging: logs operations
worker/agent_worker.py