Initial commit

2025-11-29 18:28:30 +08:00
commit 171acedaa4
220 changed files with 85967 additions and 0 deletions
--- a/skills/langchain4j/qdrant/references/references.md
+++ b/skills/langchain4j/qdrant/references/references.md
@@ -0,0 +1,141 @@
+# Qdrant for Java: References
+
+This file contains key technical details and code patterns for integrating Qdrant with Java applications.
+
+## Qdrant Java Client API Reference
+
+### Core Setup
+
+**Maven:**
+```xml
+<dependency>
+    <groupId>io.qdrant</groupId>
+    <artifactId>client</artifactId>
+    <version>1.15.0</version>
+</dependency>
+```
+
+**Gradle:**
+```gradle
+implementation 'io.qdrant:client:1.15.0'
+```
+
+### Client Initialization
+
+```java
+// Basic client
+QdrantClient client = new QdrantClient(
+    QdrantGrpcClient.newBuilder("localhost").build());
+
+// Advanced client with TLS and API key
+ManagedChannel channel = Grpc.newChannelBuilder(
+    "localhost:6334",
+    TlsChannelCredentials.newBuilder()
+        .trustManager(new File("ssl/ca.crt"))
+        .build()).build();
+
+QdrantClient client = new QdrantClient(
+    QdrantGrpcClient.newBuilder(channel)
+        .withApiKey("<apikey>")
+        .build());
+```
+
+### Collection Management
+
+```java
+// Create collection
+client.createCollectionAsync("my_collection",
+    VectorParams.newBuilder()
+        .setDistance(Distance.Cosine)
+        .setSize(4)
+        .build()).get();
+
+// Create collection with configuration
+client.createCollectionAsync("my_collection",
+    VectorParams.newBuilder()
+        .setDistance(Distance.Cosine)
+        .setSize(384)
+        .build())
+    .get();
+```
+
+### Point Operations
+
+```java
+// Insert points
+List<PointStruct> points = List.of(
+    PointStruct.newBuilder()
+        .setId(id(1))
+        .setVectors(vectors(0.32f, 0.52f, 0.21f, 0.52f))
+        .putAllPayload(Map.of("color", value("red")))
+        .build()
+);
+
+UpdateResult result = client.upsertAsync("my_collection", points).get();
+```
+
+### Search Operations
+
+```java
+// Simple search
+List<ScoredPoint> results = client.searchAsync(
+    SearchPoints.newBuilder()
+        .setCollectionName("my_collection")
+        .addAllVector(List.of(0.6235f, 0.123f, 0.532f, 0.123f))
+        .setLimit(5)
+        .build()).get();
+
+// Filtered search
+List<ScoredPoint> filteredResults = client.searchAsync(
+    SearchPoints.newBuilder()
+        .setCollectionName("my_collection")
+        .addAllVector(List.of(0.6235f, 0.123f, 0.532f, 0.123f))
+        .setFilter(Filter.newBuilder()
+            .addMust(range("rand_number",
+                Range.newBuilder().setGte(3).build()))
+            .build())
+        .setLimit(5)
+        .build()).get();
+```
+
+## LangChain4j Integration Patterns
+
+### QdrantEmbeddingStore Setup
+
+```xml
+<dependency>
+    <groupId>dev.langchain4j</groupId>
+    <artifactId>langchain4j-qdrant</artifactId>
+    <version>1.7.0</version>
+</dependency>
+```
+
+### Configuration
+
+```java
+EmbeddingStore<TextSegment> embeddingStore = QdrantEmbeddingStore.builder()
+    .collectionName("YOUR_COLLECTION_NAME")
+    .host("YOUR_HOST_URL")
+    .port(6334)
+    .apiKey("YOUR_API_KEY")
+    .build();
+
+// Or with HTTPS
+EmbeddingStore<TextSegment> embeddingStore = QdrantEmbeddingStore.builder()
+    .collectionName("YOUR_COLLECTION_NAME")
+    .host("YOUR_HOST_URL")
+    .port(443)
+    .useHttps(true)
+    .apiKey("YOUR_API_KEY")
+    .build();
+```
+
+## Official Documentation Resources
+
+- **[Qdrant Documentation](https://qdrant.tech/documentation/)**: Main documentation portal
+- **[Qdrant Java Client GitHub](https://github.com/qdrant/java-client)**: Source code and issues
+- **[Java Client Javadoc](https://qdrant.github.io/java-client/)**: Complete API documentation
+- **[API & SDKs](https://qdrant.tech/documentation/interfaces/)**: All supported clients
+- **[Quickstart Guide](https://qdrant.tech/documentation/quickstart/)**: Local setup guide
+- **[LangChain4j Official Site](https://langchain4j.dev/)**: Framework documentation
+- **[LangChain4j Examples](https://github.com/langchain4j/langchain4j-examples)**: Comprehensive examples