Function Schemas

Understanding parameter types and constraints

Parameter Types Guide

JSON Schema supports six core types. Each type defines what kind of data agents can pass to your functions.

🎨Interactive Type Explorer

Click each type to see examples and use cases

📝 string

Text values

{
  "type": "string",
  "description": "User name"
}
📝 Examples:
"John Doe""hello@example.com""New York"
💡 Use Cases:
Names
Addresses
Messages
IDs

🔗 Combining Types

Complex schemas often combine multiple types:

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "Username"
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "description": "User tags"
    },
    "age": {
      "type": "number",
      "description": "User age"
    },
    "verified": {
      "type": "boolean",
      "description": "Verification status"
    }
  }
}

🎯 Choosing the Right Type

Use string for: Text, IDs, dates (ISO format), URLs
Use number for: Quantities, prices, scores, measurements
Use boolean for: Yes/no questions, flags, toggles
Use array for: Multiple items of the same type
Use object for: Structured data with multiple properties
Use enum for: Limited set of predefined options