Environment Setup

User Prompt

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

Tool Call Sequence

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.

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.

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:
Simulator Type Endpoint
Primary Care EHR FHIR https://fhir.verial.dev/sbx_fhir_01/fhir/R4
BlueCross Portal Payer https://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.

Simulator	Type	Endpoint
Primary Care EHR	FHIR	`https://fhir.verial.dev/sbx_fhir_01/fhir/R4`
BlueCross Portal	Payer	`https://portal.verial.dev/sbx_payer_01`

Summary

Metric	Value
Tool calls	6
Tools used	`simulators`, `environments`, `playgrounds`
Key technique	Create simulators first, then compose them into an environment. A single `playgrounds` create call provisions all linked simulators at once.

​User Prompt

​Tool Call Sequence

​Agent Response

​Summary

User Prompt

Tool Call Sequence

Agent Response

Summary