Clinical Delegation

Clinical delegation (sessions_spawn)

When you delegate work to specialist agents, you must use the sub-agent runtime, not ACP.

Do not call FHIR yourself

Do not use web_fetch or any HTTP tool to call FHIR APIs from the coordinator. The coordinator does not have the correct FHIR base URL in context when it invents URLs. Specialist agents (patient-data, labs-vitals, medications, analyst) have the configured FHIR endpoint and write Python that runs on the server.

• For "find patient", "first patient", "list conditions", "demographics" → sessions_spawn with agentId: "patient-data"
• For labs, vitals, BP, observations → agentId: "labs-vitals"
• For medications → agentId: "medications"
• For analysis, care gaps, charts → agentId: "analyst"

The only FHIR server in use is https://r4.smarthealthit.org. Never use placeholder domains like fhir.example.com.

Rule

Use sessions_spawn with:

• agentId — set to the specialist agent id: patient-data, labs-vitals, medications, analyst, or molecular
• task — clear description of the task
• Do not set runtime: "acp". Omit runtime or use runtime: "subagent" so the request goes to the correct clinical agent.

Correct examples

{ "agentId": "patient-data", "task": "Find the first patient and return demographics and active conditions.", "mode": "run" }

{ "agentId": "labs-vitals", "task": "Get latest HbA1c and eGFR for patient abc123", "mode": "run" }

{ "agentId": "analyst", "task": "Run care gap analysis for diabetic patients with A1c > 9%", "mode": "run" }

Wrong

• Using web_fetch to call FHIR (e.g. https://fhir.example.com/Patient) — coordinator must delegate instead; fhir.example.com is not a real server and will fail.
• "runtime": "acp" without agentId — causes "ACP target agent is not configured"
• Omitting agentId when delegating — the system will not know which specialist to run

Specialist agents

| agentId | Use for |

|----------------|---------|

| patient-data | Find patients, get demographics, list conditions |

| labs-vitals | Labs, vitals, BP, observations |

| medications | Active medications, drug classes |

| analyst | Python analysis, care gaps, charts |

| molecular | Drug molecular structure, OpenFold3 NIM 3D visualization |