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 |
1---2name: clinical-delegation3description: How to delegate clinical tasks to specialist agents. Always use sub-agent runtime with explicit agentId — never ACP. Never call FHIR via web_fetch.4---56# Clinical delegation (sessions_spawn)78When you delegate work to specialist agents, you **must** use the **sub-agent** runtime, not ACP.910## Do not call FHIR yourself1112**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.1314- For "find patient", "first patient", "list conditions", "demographics" → **sessions_spawn** with **agentId: "patient-data"**15- For labs, vitals, BP, observations → **agentId: "labs-vitals"**16- For medications → **agentId: "medications"**17- For analysis, care gaps, charts → **agentId: "analyst"**1819The only FHIR server in use is **https://r4.smarthealthit.org**. Never use placeholder domains like fhir.example.com.2021## Rule2223Use `sessions_spawn` with:2425- **agentId** — set to the specialist agent id: `patient-data`, `labs-vitals`, `medications`, `analyst`, or `molecular`26- **task** — clear description of the task27- **Do not set** `runtime: "acp"`. Omit `runtime` or use `runtime: "subagent"` so the request goes to the correct clinical agent.2829## Correct examples3031```json32{ "agentId": "patient-data", "task": "Find the first patient and return demographics and active conditions.", "mode": "run" }33```3435```json36{ "agentId": "labs-vitals", "task": "Get latest HbA1c and eGFR for patient abc123", "mode": "run" }37```3839```json40{ "agentId": "analyst", "task": "Run care gap analysis for diabetic patients with A1c > 9%", "mode": "run" }41```4243## Wrong4445- 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.46- `"runtime": "acp"` without agentId — causes "ACP target agent is not configured"47- Omitting agentId when delegating — the system will not know which specialist to run4849## Specialist agents5051| agentId | Use for |52|----------------|---------|53| patient-data | Find patients, get demographics, list conditions |54| labs-vitals | Labs, vitals, BP, observations |55| medications | Active medications, drug classes |56| analyst | Python analysis, care gaps, charts |57| molecular | Drug molecular structure, OpenFold3 NIM 3D visualization |
NVIDIA