Skip to main content

​
User Prompt

“Set up a primary care clinic with a FHIR EHR and a payer portal for testing prior auth workflows.”

​
Tool Call Sequence

1

Create simulators

The agent creates two simulators: a FHIR EHR and a payer portal.Call 1: simulators
{
  "action": "create",
  "type": "FHIR",
  "name": "Primary Care EHR",
  "config": {
    "authType": "bearer",
    "fhirVersion": "R4"
  }
}
Response:
{
  "id": "sim_fhir_01",
  "type": "FHIR",
  "name": "Primary Care EHR",
  "config": {
    "authType": "bearer",
    "fhirVersion": "R4"
  },
  "createdAt": "2026-04-06T10:00:00Z"
}
Call 2: simulators
{
  "action": "create",
  "type": "Payer",
  "name": "BlueCross Portal"
}
Response:
{
  "id": "sim_payer_02",
  "type": "Payer",
  "name": "BlueCross Portal",
  "config": null,
  "createdAt": "2026-04-06T10:00:01Z"
}
What the agent learns: Both simulators are created and have IDs. The agent uses these IDs to link the simulators to an environment in the next step.
2

Create environment and link simulators

The agent creates the environment, then attaches both simulators.Call 3: environments
{
  "action": "create",
  "name": "Primary Care Clinic",
  "description": "Simulated primary care setting with FHIR EHR and BlueCross payer portal for prior auth testing"
}
Response:
{
  "id": "env_clinic_01",
  "name": "Primary Care Clinic",
  "description": "Simulated primary care setting with FHIR EHR and BlueCross payer portal for prior auth testing",
  "simulators": [],
  "createdAt": "2026-04-06T10:00:02Z"
}
Call 4: environments
{
  "action": "addSimulator",
  "id": "env_clinic_01",
  "simulatorId": "sim_fhir_01"
}
Response:
{
  "id": "env_clinic_01",
  "name": "Primary Care Clinic",
  "simulators": [
    { "id": "sim_fhir_01", "type": "FHIR", "name": "Primary Care EHR" }
  ]
}
Call 5: environments
{
  "action": "addSimulator",
  "id": "env_clinic_01",
  "simulatorId": "sim_payer_02"
}
Response:
{
  "id": "env_clinic_01",
  "name": "Primary Care Clinic",
  "simulators": [
    { "id": "sim_fhir_01", "type": "FHIR", "name": "Primary Care EHR" },
    { "id": "sim_payer_02", "type": "Payer", "name": "BlueCross Portal" }
  ]
}
What the agent learns: The environment now has both simulators attached. The simulators array in the response confirms the links.
3

Create playground to provision live endpoints

The agent creates a playground to spin up live instances of all simulators in the environment.Call 6: playgrounds
{
  "action": "create",
  "environmentId": "env_clinic_01"
}
Response:
{
  "id": "pg_01",
  "environmentId": "env_clinic_01",
  "status": "Active",
  "sandboxes": [
    {
      "id": "sbx_fhir_01",
      "simulatorId": "sim_fhir_01",
      "type": "FHIR",
      "status": "Active",
      "endpoint": "https://fhir.verial.dev/sbx_fhir_01/fhir/R4"
    },
    {
      "id": "sbx_payer_01",
      "simulatorId": "sim_payer_02",
      "type": "Payer",
      "status": "Active",
      "endpoint": "https://portal.verial.dev/sbx_payer_01"
    }
  ],
  "createdAt": "2026-04-06T10:00:05Z"
}
What the agent learns: The playground is active with live endpoints for both simulators. The FHIR EHR is available at a REST endpoint and the payer portal has its own URL. These endpoints are ready for the agent-under-test to connect to.

​
Agent Response

Your primary care clinic environment is ready. Here is what was provisioned:
SimulatorTypeEndpoint
Primary Care EHRFHIRhttps://fhir.verial.dev/sbx_fhir_01/fhir/R4
BlueCross PortalPayerhttps://portal.verial.dev/sbx_payer_01
The environment env_clinic_01 is active with playground pg_01. You can now point your agent at these endpoints to test prior auth workflows.

​
Summary

MetricValue
Tool calls6
Tools usedsimulators, environments, playgrounds
Key techniqueCreate simulators first, then compose them into an environment. A single playgrounds create call provisions all linked simulators at once.