Pulse Agents

Pulse Agents

14 AI agents deployed on the REST gateway (/linc/{agent}) delivering FHIR R4 clinical decision support — plus HuggingFace model bridge and conversational chat.

Agent Overview

#	Agent	Endpoint	FHIR Resources	Clinical Domain
1	Summary	/linc/summary	DocumentReference, Composition	Patient summary tailored to role (doctor, patient, care-manager)
2	Prior Auth	/linc/prior-auth	Claim, ClaimResponse	Prior authorization copilot with coverage checks
3	Gaps in Care	/linc/gaps-in-care	CarePlan, Observation	Preventive screening gap finder
4	Medication Safety	/linc/medication-safety	MedicationRequest, AllergyIntolerance	Drug-drug interaction and allergy checks
5	Care Plan	/linc/care-plan	CarePlan, Goal	AI-powered care plan navigator
6	Clinical Trials	/linc/clinical-trials	ResearchStudy, Group	FHIR clinical trial matcher
7	Readmission Risk	/linc/readmission-risk	RiskAssessment	Hospital readmission risk workbench
8	Triage	/linc/triage	Encounter, Observation	Conversational triage assistant
9	Imaging Followup	/linc/imaging-followup	ImagingStudy, DiagnosticReport	Imaging results follow-up tracker
10	Lab Explainer	/linc/lab-explainer	Observation, DiagnosticReport	Patient-friendly lab result explanations
11	NL Query	/linc/nl-query	Parameters	Natural language to FHIR query explorer
12	SDOH Referral	/linc/sdoh-referral	ServiceRequest, Task	Social determinants and community referral matcher
13	Chat	/hf/chat	Parameters	Conversational AI with clinical reasoning
14	HF Models	/hf/models	Parameters	HuggingFace model bridge status

Usage

# List all agents
curl http://localhost:58080/linc/ | jq .

# Patient summary (doctor role)
curl "http://localhost:58080/linc/summary?patient=P-5842&role=doctor" | jq .

# Readmission risk assessment
curl "http://localhost:58080/linc/readmission-risk?patient=P-5842" | jq .

# Medication safety check
curl "http://localhost:58080/linc/medication-safety?patient=P-5842" | jq .

# Natural language query
curl "http://localhost:58080/linc/nl-query?patient=P-5842&query=show%20medications" | jq .

# Chat with AI
curl "http://localhost:58080/hf/chat?q=what%20is%20normal%20blood%20sugar" | jq .

# Check HF models status
curl http://localhost:58080/hf/models | jq .

Agent Architecture

Each agent:

1. Receives a FHIR R4-style request with patient ID and optional parameters
2. Attempts to fetch live data from https://hnh.brainsait.org/api endpoints
3. Falls back to clinically-accurate synthetic data when live data is unavailable
4. Returns a standard FHIR resource response with live_data: true|false indicator
5. All responses include resourceType and FHIR-compliant structure

HuggingFace Integration

Three HuggingFace model repositories are integrated:

Model	Repository	Task
Meditron	Fadil369/meditron-clinical-guidelines-bucket	Clinical guidelines for Saudi healthcare
LLaVA-Med	Fadil369/llava-med-v1.5-mistral-7b-bucket	Medical imaging visual QA
Medical QA	Fadil369/medical-question-answering-datasets	Patient inquiry resolution

Access: http://localhost:58080/hf/models (requires HF_TOKEN for private repos)

Chat AI Capabilities

The chat agent (/hf/chat) understands:

• Clinical triage — Chest pain, cardiac symptoms, emergency protocols
• Lab interpretation — CBC, BMP, LFT, Lipid panel, cardiac biomarkers
• Medication safety — Drug interactions, dose adjustments, Saudi FDA alternatives
• Appointments — Scheduling and availability checks
• Claims — NPHIES claim lifecycle and status tracking
• General health queries — Education and guidance

Response Format

All agents return FHIR R4 Parameters or domain-specific resources:

{
  "resourceType": "Parameters",
  "parameter": [
    { "name": "response", "valueString": "..." },
    { "name": "patient", "valueString": "P-5842" },
    { "name": "live_data", "valueBoolean": false }
  ]
}