Merge pull request #77 from qdrant/1-15-0

v1.15.0

Author: timvisee

CONTRIBUTING.md

@@ -115,6 +115,7 @@ Once the new Qdrant version is live:
 
 - `qdrantVersion` - Set it to the released Docker image version for testing.
 - `qdrantProtosVersion` - Set it to the released version of the Qdrant source for fetching the proto files.
+- Update the package version references in the README.md.
 
 2. Merge the pull request.
 

README.md

@@ -38,20 +38,20 @@ To install the library, add the following lines to your build config file.
 <dependency>
   <groupId>io.qdrant</groupId>
   <artifactId>client</artifactId>
-  <version>1.14.0</version>
+  <version>1.15.0</version>
 </dependency>
 ```
 
 #### SBT
 
 ```sbt
-libraryDependencies += "io.qdrant" % "client" % "1.14.0"
+libraryDependencies += "io.qdrant" % "client" % "1.15.0"
 ```
 
 #### Gradle
 
 ```gradle
-implementation 'io.qdrant:client:1.14.0'
+implementation 'io.qdrant:client:1.15.0'
 ```
 
 > [!NOTE]  

gradle.properties

@@ -1,8 +1,8 @@
 # The version of qdrant to use to download protos
-qdrantProtosVersion=v1.14.0
+qdrantProtosVersion=v1.15.0
 
 # The version of qdrant docker image to run integration tests against
-qdrantVersion=v1.14.1
+qdrantVersion=v1.15.0
 
 # The version of the client to generate
-packageVersion=1.14.1
+packageVersion=1.15.0

src/main/java/io/qdrant/client/ConditionFactory.java

@@ -108,6 +108,23 @@ public static Condition matchText(String field, String text) {
         .build();
   }
 
+  /**
+   * Match records where the given field matches the given phrase.
+   *
+   * @param field The name of the field
+   * @param phrase The phrase to match
+   * @return a new instance of {@link Condition}
+   */
+  public static Condition matchPhrase(String field, String phrase) {
+    return Condition.newBuilder()
+        .setField(
+            FieldCondition.newBuilder()
+                .setKey(field)
+                .setMatch(Match.newBuilder().setPhrase(phrase).build())
+                .build())
+        .build();
+  }
+
   /**
    * Match records where the given field matches the given boolean value.
    *

src/main/java/io/qdrant/client/QueryFactory.java

@@ -8,7 +8,10 @@
 import io.qdrant.client.grpc.Points.Document;
 import io.qdrant.client.grpc.Points.Formula;
 import io.qdrant.client.grpc.Points.Fusion;
+import io.qdrant.client.grpc.Points.Image;
 import io.qdrant.client.grpc.Points.InferenceObject;
+import io.qdrant.client.grpc.Points.Mmr;
+import io.qdrant.client.grpc.Points.NearestInputWithMmr;
 import io.qdrant.client.grpc.Points.OrderBy;
 import io.qdrant.client.grpc.Points.PointId;
 import io.qdrant.client.grpc.Points.Query;
@@ -192,7 +195,7 @@ public static Query nearest(Document document) {
    * @param image The image to vectorize and query against.
    * @return a new instance of {@link Query}
    */
-  public static Query nearest(io.qdrant.client.grpc.Points.Image image) {
+  public static Query nearest(Image image) {
     return Query.newBuilder().setNearest(vectorInput(image)).build();
   }
 
@@ -206,6 +209,19 @@ public static Query nearest(InferenceObject object) {
     return Query.newBuilder().setNearest(vectorInput(object)).build();
   }
 
+  /**
+   * Creates a {@link Query} for re-ranking points with MMR (Maximum Marginal Relevance).
+   *
+   * @param nearest The vector input for nearest search.
+   * @param mmr The MMR configuration.
+   * @return a new instance of {@link Query}
+   */
+  public static Query nearest(VectorInput nearest, Mmr mmr) {
+    return Query.newBuilder()
+        .setNearestWithMmr(NearestInputWithMmr.newBuilder().setNearest(nearest).setMmr(mmr).build())
+        .build();
+  }
+
   /**
    * Creates a {@link Query} from a nested list of floats representing a multi vector
    *