Vascue Public Knowledge Search

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for, as a natural-language question or keywords, e.g. \"how does claims pre-authorisation work\" or \"Cliniko integration\". 3-15 words works best; one topic per call."
    },
    "ai_search_options": {
      "type": "object",
      "properties": {
        "retrieval": {
          "type": "object",
          "properties": {
            "retrieval_type": {
              "enum": [
                "hybrid",
                "vector",
                "keyword"
              ],
              "type": "string",
              "description": "hybrid (default) fuses keyword and vector ranking; keyword for exact phrases or product names; vector for paraphrased questions."
            },
            "match_threshold": {
              "type": "number",
              "maximum": 1,
              "minimum": 0,
              "description": "Minimum relevance score for a chunk to be included (default 0.35); raise for precision, lower for recall."
            },
            "max_num_results": {
              "type": "integer",
              "maximum": 50,
              "minimum": 1,
              "description": "Maximum chunks to return (default 8)."
            },
            "context_expansion": {
              "type": "integer",
              "maximum": 3,
              "minimum": 0,
              "description": "Neighbouring chunks from the same page to include around each hit (default 0)."
            }
          }
        }
      },
      "description": "Optional retrieval tuning. Omit for the defaults: hybrid search, 8 results, score threshold 0.35."
    }
  }
}