Vectara MCP: وصّل الوكلاء بـ Trusted RAG

لمن يناسب

إذا كنت تريد وصل تطبيق وكيل بـ Trusted RAG من Vectara—سريع ومستقر مع تعزيز استرجاع يقلل الهلوسة—فإن هذه الخدمة تناسب ذلك. يصفها النص الرسمي بأنها تقدّم هذه القدرة عبر بروتوكول MCP.

تناسب من يستطيع أصلًا تثبيت الحزمة بـ pip ويملك مفتاح Vectara API. التشغيل الافتراضي هو نقل HTTP بمصادقة. بلا مفتاح لا يمرّ أداة إعداد مستوى الجلسة في التحقق.

في المرة الأولى تحقّق من المفتاح فقط. لا تعامل أدوات الاستعلام غير المذكورة كدوال معروفة. الاسترجاع يخرج إلى الشبكة ويرسل سؤالك أيضًا إلى Vectara.

إكمال المحاولة الأولى في 3 دقائق

المسار الرسمي الموصى به هو التثبيت من PyPI والتشغيل بنقل HTTP الآمن الافتراضي. المتطلب: لديك مفتاح Vectara API أصلًا.

التثبيت:

pip install vectara-mcp

عيّن متغير البيئة VECTARA_API_KEY إلى المفتاح الحقيقي الصادر من وحدة التحكم. قيم الأمثلة الرسمية عناصر نائبة؛ لا تنسخها. ثم شغّل:

python -m vectara_mcp

يوضح النص الرسمي أن الخدمة تعمل افتراضيًا على:

http://127.0.0.1:8000

وأن المصادقة مفعّلة أصلًا. وجّه عميل MCP إلى خدمة HTTP هذه. النص الرسمي لا يكتب حقول الترويسة الكاملة التي تُملأ في العميل؛ لا تخترعها. اتصل كما يتصل العميل بـ HTTP MCP بمصادقة.

ثم نفّذ استدعاءً واحدًا: استدعِ setup_vectara_api_key. يوضح النص الرسمي أنه يهيئ ويتحقق من مفتاح Vectara API للجلسة؛ وهو إعداد لمرة واحدة. حقول المعاملات غير مكتوبة؛ املأ المفتاح الحقيقي وفق التعريف الذي يعرضه العميل ولا تكتب سلاسل الأمثلة.

إشارة النجاح: يمر التحقق وتستطيع الجلسة استخدام ذلك المفتاح. إن فشل فتحقق أولًا أن متغير البيئة ووسيط الأداة هما المفتاح الحقيقي.

لا تُضف --stdio. في المرة الأولى ابقَ على HTTP الافتراضي فقط.

حالات الاستخدام

الحالة الأولى: تحقق من المفتاح داخل الجلسة. استدعِ setup_vectara_api_key. الشرح الرسمي هو Configure and validate your Vectara API key for the session. لا يكتب صيغة المفتاح ولا إن كان يستبدل متغير البيئة. عند النجاح ينبغي أن ترى نجاح التحقق. لا تعامله كأداة تستطيع الاستعلام عن ذخيرة.

الحالة الثانية: بعد نجاح التحقق نفّذ استعلام Trusted RAG. يوضح النص الرسمي أن هذا الخادم يقدّم Trusted RAG لتطبيقات الوكلاء. هذه الصفحة تسمّي فقط أداة الإعداد أعلاه ولا تكتب اسم دالة استعلام؛ افتح الأدوات التي يعرضها هذا الخادم في العميل واختر البند الموصوف كاسترجاع أو سؤال وجواب. لا تخترع أسماء دوال لم تظهر. عند النجاح ينبغي أن ترى نتائج استرجاع من Vectara. الاستعلامات تخرج إلى الشبكة وقد تكشف نص سؤالك.

حدود الاستخدام

الافتراضي هو HTTP بمصادقة. يوجد أيضًا python -m vectara_mcp --stdio ويصفه النص الرسمي بأنه أقل أمانًا للتطوير المحلي أو Claude Desktop فقط، وليس مسار المرة الأولى.

يجب توفير VECTARA_API_KEY. النص الرسمي لا يكتب حد معدل ولا تراجع. هذه الصفحة لا تسمّي أدوات استعلام؛ لا تعامل كلمتي Trusted RAG كاسم دالة. عنوان الالتفاف المحلي يعني الاستماع الافتراضي فقط، لا أن البيانات لا تغادر جهازك—الاسترجاع يصل إلى Vectara مع ذلك.