radioflow / orchestrator /workflow.py
SamarpeetGarad's picture
Upload orchestrator/workflow.py with huggingface_hub
27b8fe0 verified
"""
RadioFlow Orchestrator
Coordinates the multi-agent workflow for radiology analysis
"""
import time
from dataclasses import dataclass, field
from typing import Any, Dict, List, Optional, Callable
from datetime import datetime
from PIL import Image
from agents import (
CXRAnalyzerAgent,
FindingInterpreterAgent,
ReportGeneratorAgent,
PriorityRouterAgent,
BaseAgent,
AgentResult
)
from utils.metrics import MetricsTracker
@dataclass
class WorkflowResult:
"""Complete result from the RadioFlow workflow"""
workflow_id: str
status: str # "success", "partial", "error"
start_time: str
end_time: str
total_duration_ms: float
# Agent results
cxr_analysis: Optional[AgentResult] = None
finding_interpretation: Optional[AgentResult] = None
report: Optional[AgentResult] = None
priority_routing: Optional[AgentResult] = None
# Aggregated outputs
final_report: str = ""
priority_level: str = "ROUTINE"
priority_score: float = 0.0
findings_count: int = 0
critical_findings: List[str] = field(default_factory=list)
# Errors
errors: List[str] = field(default_factory=list)
def to_dict(self) -> Dict:
return {
"workflow_id": self.workflow_id,
"status": self.status,
"start_time": self.start_time,
"end_time": self.end_time,
"total_duration_ms": self.total_duration_ms,
"final_report": self.final_report,
"priority_level": self.priority_level,
"priority_score": self.priority_score,
"findings_count": self.findings_count,
"critical_findings": self.critical_findings,
"agent_results": {
"cxr_analysis": self.cxr_analysis.to_dict() if self.cxr_analysis else None,
"finding_interpretation": self.finding_interpretation.to_dict() if self.finding_interpretation else None,
"report": self.report.to_dict() if self.report else None,
"priority_routing": self.priority_routing.to_dict() if self.priority_routing else None,
},
"errors": self.errors
}
class RadioFlowOrchestrator:
"""
Main orchestrator for the RadioFlow multi-agent system.
Coordinates the sequential execution of:
1. CXR Analyzer (Image Analysis)
2. Finding Interpreter (Clinical Interpretation)
3. Report Generator (Structured Report)
4. Priority Router (Urgency Assessment)
"""
def __init__(self, demo_mode: bool = True):
"""
Initialize the orchestrator.
Args:
demo_mode: If True, agents use simulated outputs for faster demos
"""
self.demo_mode = demo_mode
self.metrics = MetricsTracker()
# Initialize agents
self.agents: Dict[str, BaseAgent] = {
"cxr_analyzer": CXRAnalyzerAgent(demo_mode=demo_mode),
"finding_interpreter": FindingInterpreterAgent(demo_mode=demo_mode),
"report_generator": ReportGeneratorAgent(demo_mode=demo_mode),
"priority_router": PriorityRouterAgent(demo_mode=demo_mode)
}
# Workflow state
self._current_workflow_id: Optional[str] = None
self._workflow_callbacks: List[Callable] = []
# Agent order for pipeline
self._agent_order = [
"cxr_analyzer",
"finding_interpreter",
"report_generator",
"priority_router"
]
def load_all_models(self) -> Dict[str, bool]:
"""Load all agent models. Returns dict of agent_name -> success."""
results = {}
for name, agent in self.agents.items():
try:
results[name] = agent.load_model()
except Exception as e:
print(f"Failed to load {name}: {e}")
results[name] = False
return results
def add_callback(self, callback: Callable[[str, AgentResult], None]):
"""Add a callback to be called after each agent completes."""
self._workflow_callbacks.append(callback)
def _notify_callbacks(self, agent_name: str, result: AgentResult):
"""Notify all callbacks of agent completion."""
for callback in self._workflow_callbacks:
try:
callback(agent_name, result)
except Exception as e:
print(f"Callback error: {e}")
def process(
self,
image: Image.Image,
clinical_context: Optional[Dict] = None,
workflow_id: Optional[str] = None
) -> WorkflowResult:
"""
Run the complete RadioFlow workflow.
Args:
image: Chest X-ray image (PIL Image)
clinical_context: Optional clinical information
workflow_id: Optional ID for tracking
Returns:
WorkflowResult with complete analysis
"""
# Initialize workflow
start_time = time.time()
start_timestamp = datetime.now().isoformat()
if workflow_id is None:
workflow_id = f"rf_{datetime.now().strftime('%Y%m%d_%H%M%S_%f')}"
self._current_workflow_id = workflow_id
self.metrics.start_workflow(workflow_id)
# Prepare context
context = clinical_context or {}
# Initialize result
result = WorkflowResult(
workflow_id=workflow_id,
status="processing",
start_time=start_timestamp,
end_time="",
total_duration_ms=0
)
errors = []
try:
# ============================================
# STAGE 1: CXR Analysis
# ============================================
print(f"[{workflow_id}] Stage 1: CXR Analysis...")
cxr_result = self.agents["cxr_analyzer"](image, context)
result.cxr_analysis = cxr_result
self.metrics.record_agent("CXR Analyzer", cxr_result.processing_time_ms, cxr_result.status == "success")
self._notify_callbacks("cxr_analyzer", cxr_result)
if cxr_result.status == "error":
errors.append(f"CXR Analyzer: {cxr_result.error_message}")
# ============================================
# STAGE 2: Finding Interpretation
# ============================================
print(f"[{workflow_id}] Stage 2: Finding Interpretation...")
interpretation_input = cxr_result.data if cxr_result.status == "success" else {}
interpretation_result = self.agents["finding_interpreter"](interpretation_input, context)
result.finding_interpretation = interpretation_result
self.metrics.record_agent("Finding Interpreter", interpretation_result.processing_time_ms, interpretation_result.status == "success")
self._notify_callbacks("finding_interpreter", interpretation_result)
if interpretation_result.status == "error":
errors.append(f"Finding Interpreter: {interpretation_result.error_message}")
# ============================================
# STAGE 3: Report Generation
# ============================================
print(f"[{workflow_id}] Stage 3: Report Generation...")
report_input = interpretation_result.data if interpretation_result.status == "success" else {}
report_result = self.agents["report_generator"](report_input, context)
result.report = report_result
self.metrics.record_agent("Report Generator", report_result.processing_time_ms, report_result.status == "success")
self._notify_callbacks("report_generator", report_result)
if report_result.status == "error":
errors.append(f"Report Generator: {report_result.error_message}")
# ============================================
# STAGE 4: Priority Routing
# ============================================
print(f"[{workflow_id}] Stage 4: Priority Routing...")
# Pass original findings through context for priority assessment
priority_context = {
**context,
"original_findings": cxr_result.data.get("findings", []) if cxr_result.data else []
}
priority_input = report_result.data if report_result.status == "success" else {}
priority_result = self.agents["priority_router"](priority_input, priority_context)
result.priority_routing = priority_result
self.metrics.record_agent("Priority Router", priority_result.processing_time_ms, priority_result.status == "success")
self._notify_callbacks("priority_router", priority_result)
if priority_result.status == "error":
errors.append(f"Priority Router: {priority_result.error_message}")
# ============================================
# Aggregate Results
# ============================================
result.final_report = report_result.data.get("full_report", "") if report_result.data else ""
result.priority_level = priority_result.data.get("priority_level", "ROUTINE") if priority_result.data else "ROUTINE"
result.priority_score = priority_result.data.get("priority_score", 0.0) if priority_result.data else 0.0
result.findings_count = len(cxr_result.data.get("findings", [])) if cxr_result.data else 0
result.critical_findings = priority_result.data.get("critical_findings_detected", []) if priority_result.data else []
# Determine overall status
if not errors:
result.status = "success"
elif len(errors) < 4:
result.status = "partial"
else:
result.status = "error"
result.errors = errors
except Exception as e:
result.status = "error"
result.errors = [str(e)]
print(f"[{workflow_id}] Workflow error: {e}")
finally:
# Finalize timing
end_time = time.time()
result.end_time = datetime.now().isoformat()
result.total_duration_ms = (end_time - start_time) * 1000
# Record metrics
self.metrics.end_workflow(
findings_count=result.findings_count,
priority_score=result.priority_score,
status=result.status
)
print(f"[{workflow_id}] Workflow complete in {result.total_duration_ms:.0f}ms")
return result
def get_agent_statuses(self) -> Dict[str, Dict]:
"""Get status of all agents."""
return {
name: {
"name": agent.name,
"model": agent.model_name,
"loaded": agent.is_loaded,
"metrics": agent.get_metrics()
}
for name, agent in self.agents.items()
}
def get_workflow_metrics(self) -> str:
"""Get formatted workflow metrics."""
return self.metrics.format_for_display()
def reset(self):
"""Reset orchestrator state."""
self._current_workflow_id = None
for agent in self.agents.values():
agent.reset_metrics()
self.metrics = MetricsTracker()
def create_orchestrator(demo_mode: bool = True) -> RadioFlowOrchestrator:
"""Factory function to create an orchestrator instance."""
orchestrator = RadioFlowOrchestrator(demo_mode=demo_mode)
orchestrator.load_all_models()
return orchestrator