MongoDBVectorSearchTool
الوصف
تُمكّنMongoDBVectorSearchTool من إجراء استعلامات التشابه المتجهي على مجموعات MongoDB Atlas. يدعم
MongoDB Atlas البحث المتجهي الأصلي. كما تدعم الأداة أدوات مساعدة لإنشاء الفهارس وإدراج النصوص المضمنة بكميات كبيرة.
يُعد البحث المتجهي في MongoDB مفيدًا للتطبيقات التي تريد استخدام قاعدة بيانات بحث متجهي للاستعلام عن البيانات
باستخدام البحث الدلالي، أو تصفية الاستعلامات حسب حقول أخرى في مجموعتك، أو تشغيل تطبيقات الذكاء الاصطناعي
وأنظمة الوكلاء الخاصة بك من خلال تنفيذ التوليد المعزز بالاسترجاع (RAG).
اعرف المزيد: https://www.mongodb.com/docs/atlas/atlas-vector-search/vector-search-overview/
التثبيت
قم بالتثبيت مع إضافة MongoDB:معاملات التهيئة
connection_string(str): مطلوب. بيانات اعتماد سلسلة الاتصال بـ MongoDB Atlas للاتصال بمجموعتك (cluster).database_name(str): مطلوب. اسم قاعدة بيانات MongoDB المراد استخدامها.collection_name(str): مطلوب. المجموعة ضمن قاعدة البيانات حيث تُخزَّن المستندات والتضمينات (embeddings).vector_index_name(str، الافتراضي:vector_index): اختياري. اسم فهرس البحث المتجهي في MongoDB المراد الاستعلام عنه (يجب أن يطابق الفهرس الذي تم إنشاؤه في Atlas).text_key(str، الافتراضي:text): اختياري. اسم حقل المستند الذي يُخزَّن فيه النص الخام.embedding_key(str، الافتراضي:embedding): اختياري. اسم حقل المستند الذي يُخزَّن فيه التضمين المتجهي.dimensions(int، الافتراضي:1536): اختياري. عدد أبعاد نموذج التضمين (يجب أن يطابق نموذجك).query_config(MongoDBVectorSearchConfig): اختياري. كائنMongoDBVectorSearchConfigلإعدادات الاستعلام المتقدمة، مثلlimitوoversampling_factor.
طرق MongoDBVectorSearchTool
run(query=...): يُضمّن استعلامًا وينفّذ بحث تشابه متجهي، ويُعيد المستندات المطابقة. يأخذ معاملquery(str) بلغة طبيعية لتضمينه والبحث عنه.add_texts(list of strings): يأخذ قائمة من النصوص لتضمينها وإدراجها كمستندات في قاعدة بيانات MongoDB Atlas الخاصة بك.create_vector_search_index(dimensions=...): يُنشئ فهرس بحث متجهي في MongoDB بالأبعاد والتشابه الصحيحين. يأخذ معاملdimensions(int).
بداية سريعة
يوضح المثال التالي كيفية تهيئة الأداة وتنفيذ بحث تشابه متجهي على مجموعة MongoDB Atlas المحددة:Code
المشكلات الشائعة
- فشل المصادقة: تأكد من أن قائمة الوصول إلى عناوين IP في Atlas تسمح بخادمك وأن سلسلة الاتصال تتضمن بيانات الاعتماد.
- الفهرس غير موجود: أنشئ الفهرس المتجهي أولاً؛ يجب أن يتطابق الاسم مع
vector_index_name. - عدم تطابق الأبعاد: قم بمحاذاة أبعاد نموذج التضمين مع
dimensions.
أمثلة
تحميل قاعدة البيانات مسبقًا وإنشاء الفهرس
يوضح المثال التالي كيفية تحميل قاعدة بيانات MongoDB Atlas الخاصة بك مسبقًا بالمستندات وإنشاء فهرس بحث متجهي في MongoDB للاستعلام عن مجموعتك:Code
تكوين استعلام مخصص وتكامل مع الوكيل
يوضح المثال التالي كيفية توفير تكوين استعلام مخصص لـMongoDBVectorSearchTool
ودمجها مع وكيل CrewAI:
Code
تشغيل سير عمل CrewAI
يوضح المثال التالي كيفية دمجMongoDBVectorSearchTool مع Agent و Task و Crew
لإنشاء وتشغيل سير عمل RAG قائم على الوكلاء في CrewAI:
Code
