create_agent

{
  "type": "object",
  "description": "Two modes: pass workflowId to deploy a workflow (everything else about the run is copied from it), or omit workflowId and provide name + prompt for a standalone agent. schedule is required in both.",
  "properties": {
    "workflowId": {
      "type": "string",
      "description": "WORKFLOW MODE: 24-hex id of the workflow to deploy (from list_workflows). The prompt, starting URL, output contract, model, proxy, policy, and files are all copied from it."
    },
    "schedule": {
      "type": "object",
      "description": "When the agent fires. Required.",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "at",
            "every",
            "cron"
          ],
          "description": "'at' = once at a specific time; 'every' = fixed interval; 'cron' = cron expression."
        },
        "at": {
          "type": "string",
          "description": "ISO 8601 date-time (type \"at\")."
        },
        "interval": {
          "type": "number",
          "description": "Repeat interval in ms, min 60000 (type \"every\")."
        },
        "cron": {
          "type": "string",
          "description": "5-field cron expression (type \"cron\")."
        },
        "timezone": {
          "type": "string",
          "description": "IANA timezone for the schedule (drives fire times AND the browser session). Default UTC."
        }
      },
      "required": [
        "type"
      ]
    },
    "expiresAt": {
      "type": "string",
      "description": "ISO 8601 date-time after which the agent auto-pauses (recurring schedules)."
    },
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "Agent name. Required standalone; defaults to the workflow title in workflow mode."
    },
    "variables": {
      "type": "object",
      "description": "WORKFLOW MODE, and only when the workflow's prompt actually contains {{variables}}: values for them, BAKED IN at deploy and reused every run (stored variableValues defaults fill gaps). Every template variable must be covered — an unattended agent cannot ask later. Workflows with concrete prompts need nothing here.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "prompt": {
      "type": "string",
      "maxLength": 5000,
      "description": "STANDALONE MODE (required there): The task the browser agent runs, written as a BROWSING RUNBOOK. Structure it as: `Goal:` — one sentence naming the outcome. `Ground rules (every stage, every turn):` — bullet invariants when the task needs them, e.g. work one item at a time — never batch; only record a figure you can read on screen this turn — if it is not shown record it as \"not stated\", never estimate; keep a running tally and restate it every turn (\"captured C items · written R rows\"). Then `Stage N — <Site name> (<https://url>)` — one section per website or phase, listing the concrete steps to take in the browser (open/navigate, click, read, capture, compare, flag) in the order a person would do them, each stage ending with `Done when: <verifiable completion condition>`. Finish with `Output —` stating exactly what to produce or deliver once the final tally is met, including what to say when there is no data (never fabricate a row). When a stage delivers per-recipient (message/email each customer), state the MATCHING RULE in that stage — the identifier shared by the source record and the destination recipient (e.g. the customer name exactly as written in the source, matched against the contact name) — and the no-match branch: skip it and report it, never deliver to a similarly-named near-match. Write the user's CONCRETE values (group names, URLs, numbers) directly into the text; use {{variables}} ONLY when the user explicitly wants a reusable template whose inputs change per run. A short single-site task can be just a Goal plus its steps. PURE TASK ONLY — never write memory bookkeeping into the prompt (no \"check memory\", \"record in memory\", \"store in memory\" steps): tracking is authored in memoryContract and WebRun applies it to every run automatically."
    },
    "startingUrl": {
      "type": "string",
      "description": "STANDALONE MODE: page Chrome opens at the start of each run."
    },
    "proxy": {
      "type": "object",
      "description": "STANDALONE MODE (workflow mode inherits the workflow proxy instead): Proxy for runs. {source:\"WebRun\", country?} or {source:\"custom\", type:\"http\"|\"socks\", host, port, username?, password?}. Custom passwords are encrypted at rest and never returned. Social/messaging workflows (WhatsApp, Telegram, Instagram, Facebook, X, LinkedIn, TikTok): set country to the country the user is in right now — recommend it and confirm the country with them first; a mismatch is the usual cause of refused logins and sessions that log out repeatedly, and a scheduled workflow re-hits it every run, so keep the country stable once set.",
      "properties": {
        "source": {
          "type": "string",
          "enum": [
            "WebRun",
            "custom"
          ]
        },
        "level": {
          "type": "string",
          "enum": [
            "system",
            "chrome"
          ]
        },
        "country": {
          "type": "string",
          "description": "2-letter ISO code or \"random\" (WebRun)."
        },
        "type": {
          "type": "string",
          "enum": [
            "http",
            "socks"
          ]
        },
        "host": {
          "type": "string"
        },
        "port": {
          "type": "number"
        },
        "username": {
          "type": "string"
        },
        "password": {
          "type": "string"
        }
      }
    },
    "outputType": {
      "type": "string",
      "enum": [
        "text",
        "structured",
        "structured_csv"
      ],
      "description": "STANDALONE MODE: output contract (same rules as create_workflow)."
    },
    "outputSchema": {
      "type": [
        "object",
        "array"
      ],
      "description": "STANDALONE MODE: JSON Schema object (structured) or column-name array (structured_csv)."
    },
    "memory": {
      "type": "string",
      "maxLength": 10000,
      "description": "STANDALONE MODE: the agent's private notebook, shown to it every run and updated automatically after each run. Seed ONLY durable facts the next run must know (target descriptions, preferences, known state) — one short line each. Task steps belong in prompt, not here. Usually best left empty."
    },
    "environmentId": {
      "type": "string",
      "description": "STANDALONE MODE, rarely needed — OMIT it: the connection-bound environment (or your only one) is applied automatically; never ask the user to choose. Workflow mode always uses the workflow's deployed environment."
    }
  },
  "required": [
    "schedule"
  ]
}