{"record":{"id":"3c02ec184518c237","repo":"ankane/searchkick","slug":"use-searchkick-multi-search-for-hybrid-search","errorCode":null,"errorMessage":"Use Searchkick.multi_search for hybrid search","messagePattern":"Use Searchkick\\.multi_search for hybrid search","errorType":"exception","errorClass":"ArgumentError","httpStatus":null,"severity":"error","filePath":"lib/searchkick/query.rb","lineNumber":966,"sourceCode":"        case f\n        when :_and, :_or, :or, :_not, :_script\n          if result.key?(f)\n            # combine with _and if needed\n            result[:_and] ||= []\n            result[:_and] += [{f => v}]\n          else\n            result[f] = v\n          end\n        else\n          result[f] = v unless field_keys.include?(f.to_s)\n        end\n      end\n      result\n    end\n\n    def set_knn(payload, knn, per_page, offset)\n      if term != \"*\"\n        raise ArgumentError, \"Use Searchkick.multi_search for hybrid search\"\n      end\n\n      field = knn[:field]\n      field_options = searchkick_options.dig(:knn, field.to_sym) || searchkick_options.dig(:knn, field.to_s) || {}\n      vector = knn[:vector]\n      distance = knn[:distance] || field_options[:distance]\n      exact = knn[:exact]\n      exact = field_options[:distance].nil? || distance != field_options[:distance] if exact.nil?\n      k = per_page + offset\n      ef_search = knn[:ef_search]\n      filter = payload.delete(:query)\n\n      if distance.nil?\n        raise ArgumentError, \"distance required\"\n      elsif !exact && distance != field_options[:distance]\n        raise ArgumentError, \"distance must match searchkick options for approximate search\"\n      end\n","sourceCodeStart":948,"sourceCodeEnd":984,"githubUrl":"https://github.com/ankane/searchkick/blob/93e901a75b11a25101668a616e006b158251b16e/lib/searchkick/query.rb#L948-L984","documentation":"Error \"Use Searchkick.multi_search for hybrid search\" thrown in ankane/searchkick.","triggerScenarios":"Thrown at lib/searchkick/query.rb:966 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"93e901a75b11a25101668a616e006b158251b16e","analyzedAt":"2026-08-21T19:06:23.767Z","schemaVersion":2},"datasetVersion":"2026-08-21T23:17:16.201Z"}