Skip to main content

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

لمعرفة المزيد

لمعرفة المزيد حول تكاملات CrewAI مع MongoDB، راجع أدلة MongoDB التالية: