Web Research Agent (Prompt to Structured Data)

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 50,
      "description": "Constrain the agent to these URLs."
    },
    "prompt": {
      "type": "string",
      "examples": [
        "Find the pricing tiers and per-seat cost on acme.com"
      ],
      "maxLength": 10000,
      "minLength": 1,
      "description": "What data to find and extract."
    },
    "schema": {
      "type": "object",
      "description": "JSON Schema to shape the extracted data.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "maxCredits": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum provider credits the agent may spend on this task."
    },
    "strictConstrainToURLs": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "plans": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The plan's own name, e.g. 'Standard' -- not a person's name."
              },
              "description": {
                "type": "string"
              },
              "monthly_cost": {
                "type": "string",
                "description": "A free-text cost description, e.g. 'No monthly fee' or 'Custom pricing' -- not always a plain number."
              },
              "transaction_rate": {
                "type": "string",
                "description": "Present on only some plans (e.g. one of two) -- not guaranteed present on every plan entry."
              }
            },
            "additionalProperties": true
          },
          "description": "Present only when the agent's default (no `schema` supplied) extraction returns pricing-plan-shaped data."
        }
      },
      "description": "The extracted data. Its shape follows the input `schema` when one is supplied; without `schema`, the agent returns its own default shape (e.g. a `plans` array) -- a caller supplying `schema` should expect a differently-shaped `data` object entirely.",
      "additionalProperties": true
    },
    "model": {
      "type": "string",
      "description": "The underlying extraction model the agent used, e.g. 'spark-2'."
    },
    "status": {
      "type": "string",
      "description": "'completed' on the calls observed; other values are undocumented here."
    },
    "message": {
      "type": "string",
      "description": "A plain-language summary of what the agent found and how it answered the prompt."
    },
    "success": {
      "type": "boolean",
      "description": "Whether the agent completed its task; true on the calls observed."
    }
  },
  "description": "The agent's result. A genuinely not-found run returns `{}` -- no field below is guaranteed present.",
  "additionalProperties": true
}