JSON Schema: Describing Data Structures

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name"
    },
    "units": {
      "type": "string",
      "enum": ["celsius", "fahrenheit"],
      "description": "Measurement units"
    }
  },
  "required": ["city"]
}

# string
{"type": "string", "description": "Text"}

# number (int or float)
{"type": "number", "description": "Number"}

# integer (whole numbers only)
{"type": "integer", "description": "Integer"}

# boolean
{"type": "boolean", "description": "true or false"}

# array
{
    "type": "array",
    "items": {"type": "string"},
    "description": "List of strings"
}

# object (nested)
{
    "type": "object",
    "properties": {
        "x": {"type": "number"},
        "y": {"type": "number"}
    },
    "required": ["x", "y"]
}

TOOLS = [
    {
        "name": "search_web",
        "description": "Searches the web. Use it for current information.",
        "input_schema": {
            "type": "object",
            "properties": {
                "query": {
                    "type": "string",
                    "description": "Search query"
                },
                "max_results": {
                    "type": "integer",
                    "description": "Maximum number of results (1-10)",
                    "default": 3
                }
            },
            "required": ["query"]
        }
    },
    {
        "name": "read_file",
        "description": "Reads the contents of a local file",
        "input_schema": {
            "type": "object",
            "properties": {
                "path": {
                    "type": "string",
                    "description": "File path (absolute or starting with ~)"
                }
            },
            "required": ["path"]
        }
    }
]

# Bad
{"name": "weather", "description": "Weather"}

# Good
{"name": "get_weather", "description": "Gets current weather and a city forecast. Use it for questions about weather, temperature, or precipitation."}