سرویس Qdrant
Qdrant یک پایگاه دادهٔ برداری برای ذخیره و جست‌وجوی Embedding است. کاربردهای رایج آن جست‌وجوی معنایی، بازیابی سند برای RAG و پیشنهاد محتوای مشابه هستند. Qdrant داده‌ها را در Collection نگه می‌دارد؛ هر Point می‌تواند شناسه، بردار و اطلاعات تکمیلی (Payload) داشته باشد.
راه‌اندازی در چابکان
- در پنل چابکان محصول Qdrant را ایجاد کنید.
- پس از آماده‌شدن، نشانی سرویس و در صورت ارائه، کلید یا سایر مشخصات دسترسی را از پنل بردارید.
- در برنامه یا کلاینت Qdrant، همین نشانی و مشخصات دسترسی را تنظیم کنید. مقدار پورت و شیوهٔ اتصال را از پنل همان سرویس بگیرید.
- یک Collection آزمایشی بسازید. اندازهٔ بردار را برابر خروجی مدل Embedding خود و معیار فاصله را متناسب با همان مدل انتخاب کنید.
- یک Point آزمایشی وارد کنید و یک جست‌وجوی شباهت انجام دهید. نتیجه را با برداری که فرستاده‌اید مقایسه کنید.
یادداشت
در این مسیر، تولید Embedding را در برنامه یا سرویس مدل انجام دهید و بردار حاصل را همراه شناسه و Payload به Qdrant بفرستید. اگر نسخهٔ سروی س شما قابلیت تولید بردار در خود Qdrant دارد، پشتیبانی و تنظیم آن را جداگانه بررسی کنید.
نکات کاربردی
- بردارهای یک فیلد در Collection باید اندازهٔ سازگار داشته باشند. اگر مدل Embedding را عوض می‌کنید، پیش از واردکردن دادهٔ جدید ساختار Collection را بررسی کنید.
- اطلاعاتی مثل شناسهٔ سند، عنوان یا دسته‌بندی را در Payload نگه دارید تا نتیجهٔ جست‌وجو به منبع اصلی وصل شود.
- برای دادهٔ مهم، پیش از تغییر ساختار یا حذف Collection، روش پشتیبان‌گیری سرویس را بررسی کنید.
- دسترسی API را به برنامه‌های مجاز محدود کنید و کلید احتمالی را در کد یا مخزن Git قرار ندهید.
عیب‌یابی
| نشانه | بررسی |
|---|---|
| اتصال API برقرار نمی‌شود | نشانی، پورت، TLS و مشخصات دسترسی پنل را بررسی کنید. |
| درج Point رد می‌شود | اندازهٔ بردار و ساختار Collection را با خروجی مدل مقایسه کنید. |
| نتایج نامرتبط‌اند | مدل Embedding، معیار فاصله و شیوهٔ آماده‌سازی متن را بررسی کنید. |
منبع: مستندات رسمی Qdrant