Custom Tool Definitions — Function Call Schemas for AI Agents

{
  "type": "function",
  "function": {
    "name": "search_products",
    "description": "Search the product catalog by query, category, or price range. Returns up to 10 matching products sorted by relevance.",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Natural language search query (e.g. 'red running shoes under $100')"
        },
        "category": {
          "type": "string",
          "enum": ["shoes", "clothing", "accessories", "electronics"],
          "description": "Filter by product category"
        },
        "price_max": {
          "type": "number",
          "description": "Maximum price in USD"
        },
        "in_stock_only": {
          "type": "boolean",
          "default": true,
          "description": "Only return products currently in stock"
        }
      },
      "required": ["query"]
    }
  }
}