tool_schema.json

{
  "name": "gcas_search",
  "description": "Search the Gujarat College Admissions System (GCAS) database using natural language. Returns matching colleges, programs, cutoffs, fees, and infrastructure data. Use this tool when the user asks about: colleges, admission cutoffs, program fees, hostel availability, NAAC grades, course intake, or any college-related query.",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Natural language search query. Examples: 'engineering colleges in Ahmedabad with hostel', 'NAAC A grade colleges under GTU', 'B.Com fees in Surat', 'SC category cutoff for computer science'"
      },
      "top_k": {
        "type": "integer",
        "description": "Number of results to return. Default: 10. Max: 100.",
        "default": 10,
        "minimum": 1,
        "maximum": 100
      },
      "tables": {
        "type": "array",
        "items": { "type": "string" },
        "description": "Optional: restrict search to specific tables. Available tables: 'CollegeMaster_FORBOT_06042026' (college info, location, contact, NAAC), 'CollegeIntakeMaster_FORBOT_06042026' (programs, fees, intake), 'CollegeInfrastructure_FORBOT_06042026' (hostel, labs, facilities), 'CutOff_2025-26_06042026' (admission cutoffs by category). Omit to search all tables."
      },
      "use_llm_rerank": {
        "type": "boolean",
        "description": "Whether to use LLM semantic reranking for better accuracy. Default: true. Set false for faster responses.",
        "default": true
      },
      "llm_provider": {
        "type": "string",
        "enum": ["openai", "anthropic"],
        "description": "LLM provider for reranking. Optional – uses server default if omitted."
      },
      "llm_model": {
        "type": "string",
        "description": "LLM model name override. Optional."
      },
      "api_key": {
        "type": "string",
        "description": "API key override for the LLM provider. Optional – uses server-configured key if omitted."
      }
    },
    "required": ["query"]
  }
}