How the pieces fit together

It helps to see Phenoml as three layers, because it changes which endpoint you should reach for.

Primitives

Construe turns text into codes, Lang2FHIR turns text into FHIR, and Code Search looks up codes. They are stateless transformers: they take text and return structured data.

Tools

Tools compose a primitive with a live FHIR provider. For example, /tools/lang2fhir-and-create generates a resource and writes it, while /tools/cohort converts a description into searches and runs them.

Orchestration

Agents reason over a conversation and call tools as needed. Workflows compile a fixed multi-step process into a graph you can run repeatably.

Rule of thumb. Need a transform? Use a primitive. Need the result persisted or executed against an EHR? Use a tool. Need open-ended reasoning or a repeatable pipeline? Use an agent or workflow.