本文へ移動
cccskills
無料GitHub で公開

qdrant-search

Semantic search over Qdrant Cloud collections using the Python client. Covers vector search, filtered search, prefetch+RRF fusion, group API, recommend API, discovery API, batch queries, scroll, and payload indexing. Use when building search features, adding new query types, or working with qdrant-client.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Qdrant Search Patterns

All projects use qdrant-client with 768-dim vectors from nomic-embed-text.

Client Setup

import os
from qdrant_client import QdrantClient, models

client = QdrantClient(
    url=os.getenv("QDRANT_URL"),
    api_key=os.getenv("QDRANT_API_KEY"),
)

Vector Search (Query API)

results = client.query_points(
    collection_name="DocumentChunk_text",
    query=embedding_vector,  # list[float], 768-dim
    limit=10,
    with_payload=True,
)
for point in results.points:
    print(point.id, point.score, point.payload)

Filtered Search

results = client.query_points(
    collection_name="DocumentChunk_text",
    query=embedding_vector,
    query_filter=models.Filter(
        must=[
            models.FieldCondition(
                key="vendor",
                match=models.MatchValue(value="Acme"),
            )
        ]
    ),
    limit=10,
)

Prefetch + RRF Fusion

Multi-stage retrieval combining multiple query vectors:

results = client.query_points(
    collection_name="DocumentChunk_text",
    prefetch=[
        models.Prefetch(query=vector_a, limit=20),
        models.Prefetch(query=vector_b, limit=20),
    ],
    query=models.FusionQuery(fusion=models.Fusion.RRF),
    limit=10,
)

Group API

Group results by a payload field:

results = client.query_points_groups(
    collection_name="DocumentChunk_text",
    query=embedding_vector,
    group_by="vendor",
    limit=5,
    group_size=3,
)

Recommend API

Find similar items by point IDs:

results = client.recommend(
    collection_name="DocumentChunk_text",
    positive=[point_id_1, point_id_2],
    negative=[point_id_3],
    limit=10,
    strategy=models.RecommendStrategy.BEST_SCORE,
)

Discovery API

Guided exploration with context pairs:

results = client.discover(
    collection_name="DocumentChunk_text",
    target=point_id,
    context=[
        models.ContextPair(positive=pos_id, negative=neg_id),
    ],
    limit=10,
)

Batch Query API

Multiple queries in a single request:

results = client.query_batch_points(
    collection_name="DocumentChunk_text",
    requests=[
        models.QueryRequest(query=vector_1, limit=5),
        models.QueryRequest(query=vector_2, limit=5),
    ],
)

Scroll API

Bulk retrieval without ranking:

records, next_offset = client.scroll(
    collection_name="DocumentChunk_text",
    limit=100,
    with_payload=True,
    with_vectors=True,
)
# Paginate with offset=next_offset

Payload Indexing

Create indexes for fast filtering:

client.create_payload_index(
    collection_name="DocumentChunk_text",
    field_name="vendor",
    field_schema=models.PayloadSchemaType.KEYWORD,
)

# Full-text index
client.create_payload_index(
    collection_name="DocumentChunk_text",
    field_name="text",
    field_schema=models.TextIndexParams(
        type="text",
        tokenizer=models.TokenizerType.WORD,
        min_token_len=2,
        max_token_len=15,
        lowercase=True,
    ),
)

Cloud Inference (server-side embeddings)

No local model needed — Qdrant embeds on the server:

from qdrant_client.http.models import Document

client = QdrantClient(url=QDRANT_URL, api_key=QDRANT_API_KEY, cloud_inference=True)

results = client.query_points(
    collection_name="my_collection",
    query=Document(text="search query", model="Qdrant/Qwen/Qwen3-Embedding-0.6B"),
    limit=10,
)

Warning: Cloud inference uses a different embedding model. Existing collections use 768-dim nomic-embed-text vectors — you cannot mix models in the same collection without re-embedding all data.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use at a cognee hackathon. Watches the participant's experience with cognee throughout the session — errors, slowness, confusion, workarounds, and signs of frustration in how they work with you — and keeps one private feedback file they send to the cognee team at the end.

日本語の概要は準備中です。原文の説明を表示しています。

topoteretes/cognee-hackathons112026年10月8日 更新

PR Rescue

無料

Use when reviewing, fixing, or verifying a pull request. Focus on correctness regressions, missing tests, permission mistakes, unsafe behavior, and minimal fixes.

日本語の概要は準備中です。原文の説明を表示しています。

topoteretes/cognee-hackathons112026年10月8日 更新

Build spend analytics and dashboards from Qdrant vector data. Covers bulk scroll extraction, aggregation patterns, vendor grouping, and Chart.js visualization. Use when building analytics features, aggregating procurement data, or creating dashboards.

日本語の概要は準備中です。原文の説明を表示しています。

topoteretes/cognee-hackathons112026年10月8日 更新

Detect anomalies in procurement data using Qdrant vector operations. Covers centroid-based outlier detection, near-duplicate finding via batch recommend, amount z-score analysis, and vendor variance scoring. Use when building anomaly detection, fraud detection, or data quality features.

日本語の概要は準備中です。原文の説明を表示しています。

topoteretes/cognee-hackathons112026年10月8日 更新

topoteretes のスキルをすべて見る

このスキルの問題を報告する