vespper

Vespper-مطور AI Open Open AI

مستندات · العرض التوضيحي · الإبلاغ

ملاحظة: إذا كنت ترغب في استخدام Vespper لفريقك أو لمؤسستك ، فيرجى التواصل معنا. هذا المشروع مفتوح المصدر مناسب للاستخدام الفردي الفردي. ستكون أي ميزات تحقيق متقدمة تحت Vespper-EE.

يمكنك ترك بريدك الإلكتروني ليتم إخطاره عندما يتوفر عرض السحابة الخاص بنا: https://tally.so/r/3eba5l

ملخص ؟

Vespper هو مهندس عند الطلب من الذكاء الاصطناعى. يمكن أن تقفز تلقائيًا إلى الحوادث والتنبيهات معك ، وتوفر لك رؤى مفيدة وسياقية و RCA في الوقت الفعلي.

لماذا ❓

معظم الناس لا يحبون القيام بنوبات عند الطلب. يتطلب من المهندسين أن يكونوا سريعين ويحلون المشكلات بسرعة. علاوة على ذلك ، يستغرق الأمر وقتًا للوصول إلى السبب الجذري للمشكلة. لهذا السبب قمنا بتطوير Vespper. نعتقد أن Gen AI يمكن أن يساعد المطورين عند الاتصال في حل المشكلات بشكل أسرع.

جدول المحتويات

• ملخص
• لماذا
• الميزات الرئيسية
• العرض التوضيحي
• ابدء
  • المتطلبات الأساسية
  • تثبيت سريع
  • تحديث Vespper
  • النشر
  • تصور قاعدة المعرفة
• الدعم والتعليقات
• المساهمة في Vespper
• استكشاف الأخطاء وإصلاحها
• القياس عن بعد
• رخصة
• يتعلم أكثر
• المساهمين

الميزات الرئيسية

• RCA التلقائي : يستمع Vespper تلقائيًا إلى حوادث/تنبيهات الإنتاج وتتحقق منها تلقائيًا من أجلك.
• تكامل الركود : يعيش Vespper داخل الركود. ما عليك سوى توصيله واستمتع بمهندس عند الطلب لا ينام أبدًا.
• التكامل : يتكامل Vespper مع أدوات إدارة الحوادث الشائعة مثل DataDog و Coralogix و Opsgenie و PagerDuty. كما أنه يتكامل مع أدوات أخرى مثل Github و Idion و Jira والتقاء لاكتساب رؤى حول الحوادث.
• بديهية UX : يقدم Vespper تجربة مألوفة. يمكنك التحدث إليها وطرح أسئلة المتابعة.
• آمن : Vespper المضيف الذاتي وتملك بياناتك. دائماً.
• المصدر المفتوح : نحن نحب المصدر المفتوح. Vespper المضيف الذاتي واستخدامه مجانًا.

العرض التوضيحي؟

الخروج من الفيديو التجريبي الخاص بنا لرؤية Vespper في العمل.

ابدء

من أجل تشغيل Vespper ، تحتاج إلى استنساخ Repo وتشغيل التطبيق باستخدام Docker Compose.

المتطلبات الأساسية

تأكد من تثبيت ما يلي:

• Docker & Docker Compose - يعمل التطبيق مع حاويات Docker. لتشغيله ، تحتاج إلى الحصول على سطح مكتب Docker ، والذي يأتي مع Docker CLI و Docker Engine و Docker.

التثبيت السريع؟ ️

يمكنك العثور على فيديو التثبيت هنا.

1. استنساخ المستودع:

   git clone [email protected]:vespper/vespper.git && cd vespper

2. تكوين خادم Proxy Litellm:

   نستخدم خادم Proxy Litellm للتفاعل مع 100+ من LLMs في واجهة موحدة (واجهة Openai).

   1. انسخ ملفات المثال:

      cp config/litellm/.env.example config/litellm/.env
      cp config/litellm/config.example.yaml config/litellm/config.yaml

   2. حدد مفتاح Openai الخاص بك ووضعه داخل config/litellm/.env كـ OPENAI_API_KEY . يمكنك الحصول على مفتاح API الخاص بك هنا. كن مطمئنًا ، لن يتم تحصيل رسوم منك إلا إذا كنت تستخدم واجهة برمجة التطبيقات. لمزيد من التفاصيل حول التسعير ، تحقق هنا.

3. انسخ ملف .env.example :

   cp .env.example .env

4. افتح ملف .env في المحرر المفضل لديك (VIM ، vscode ، emacs ، إلخ):

   vim .env # or emacs or vscode or nano

5. تحديث هذه المتغيرات:

   • SLACK_BOT_TOKEN ، SLACK_APP_TOKEN و SLACK_SIGNING_SECRET - هناك حاجة إلى هذه المتغيرات من أجل التحدث إلى Vespper على Slack. يرجى اتباع هذا الدليل لإنشاء تطبيق Slack جديد في مؤسستك.

   • (اختياري) SMTP_CONNECTION_URL - هناك حاجة إلى هذا المتغير لدعوة أعضاء جدد إلى مؤسسة Vespper الخاصة بك عبر البريد الإلكتروني والسماح لهم باستخدام الروبوت. ليس إلزاميًا إذا كنت ترغب فقط في اختبار Vespper واللعب معه. إذا كنت ترغب في إرسال دعوات إلى أعضاء فريقك ، فيمكنك استخدام خدمة مثل SendGrid/MailGun. يجب اتباع هذا النمط: smtp://username:password@domain:port .

6. إطلاق المشروع:

   docker compose up -d

هذا كل شيء. يجب أن تكون قادرًا على زيارة لوحة معلومات Vespper في http: // localhost: 5173. ما عليك سوى إنشاء مستخدم (مع نفس البريد الإلكتروني مثل البريد في مستخدم Slack الخاص بك) وابدأ في تكوين مؤسستك. إذا كان هناك شيء لا يعمل من أجلك ، فيرجى الخروج من استكشاف الأخطاء وإصلاحها أو التواصل معنا عبر قنوات الدعم الخاصة بنا.

تتمثل الخطوات التالية في تكوين مؤسستك أكثر قليلاً (توصيل أدوات إدارة الحوادث ، وبناء قاعدة للمعرفة ، إلخ). توجه إلى قسم الاتصال والتكوين في مستنداتنا لمزيد من المعلومات؟

باستخدام صور DockerHub

إذا كنت تريد ، يمكنك سحب صور Docker الخاصة بنا من DockerHub بدلاً من استنساخ الريبو والمبنى من الصفر.

من أجل القيام بذلك ، اتبع هذه الخطوات:

1. تنزيل ملفات التكوين:

   curl https://raw.githubusercontent.com/vespper/vespper/main/tools/scripts/download_env_files.sh | sh

2. اتبع الخطوتين 2 و 5 أعلاه لتكوين وكيل Litellm وملف .env الخاص بك على التوالي. وهي ، ستحتاج إلى تكوين مفتاح Openai الخاص بك في config/litellm/.env وتكوين بيانات اعتماد الركود الخاصة بك في الجذر .env .

3. قم بتدوير البيئة باستخدام Docker Compose:

   curl https://raw.githubusercontent.com/vespper/vespper/main/tools/scripts/start.sh | sh

هذا كل شيء ؟ يجب أن تكون قادرًا على زيارة لوحة معلومات Vespper في http: // localhost: 5173.

تحديث Vespper؟ ‍

1. اسحب أحدث التغييرات:

   git pull

2. إعادة بناء الصور:

   docker-compose up --build -d

النشر ☁

قم بزيارة أدلة مثالنا من أجل نشر Vespper على السحابة الخاصة بك.

تصور قاعدة المعرفة؟ ️

نحن نستخدم chromadb كما ناقلنا db. نستخدم أيضًا مسؤول المتجه من أجل رؤية المستندات التي تم تناولها. لاستخدام مسؤول المتجه ، ما عليك سوى تشغيل هذا الأمر:

docker compose up vector-admin -d

يبدأ هذا الأمر المتجه في المنفذ 3001. توجه إلى http: // localhost: 3001 وتكوين chromadb المحلي. ملاحظة: نظرًا لأن المتجهات تعمل داخل حاوية Docker ، تأكد من إدراج http://host.docker.internal:8000 بدلاً من http://localhost:8000 . وذلك لأن "المضيف المحلي" لا يشير إلى المضيف داخل الحاوية نفسها.

علاوة على ذلك ، في "API Header & Key" ، ستحتاج إلى وضع "X-Chroma-Token" كرئيس والقيمة التي لديك داخل .env CHROMA_SERVER_AUTHN_CREDENTIALS كقيمة.

لمعرفة كيفية استخدام VectorAdmin ، تفضل بزيارة المستندات.

الدعم والتعليقات؟ ‍♀

حسب ترتيب أفضل طريقة للتواصل معنا:

• مناقشات GitHub : المساهمة في الأفكار وطلبات الدعم والتقرير الأخطاء (المفضلة لأن هناك ثابتًا ودائمًا لأعضاء المجتمع الآخرين).
• الركود : دعم المجتمع. انقر هنا للانضمام.
• خاص : اتصل على [email protected]

المساهمة في Vespper ⛑

إذا كنت مهتمًا بالمساهمة في Vespper ، CONTRIBUTING.md الخروج ؟ ‍

استكشاف الأخطاء وإصلاحها ⚒

إذا واجهت أي مشاكل/أخطاء/مشكلات مع Vespper ، فقم بالخروج من دليل استكشاف الأخطاء وإصلاحها. نحاول تحديثه بانتظام ، وإصلاح بعض المشكلات العاجلة هناك في أقرب وقت ممكن.

علاوة على ذلك ، لا تتردد في التواصل معنا في قنوات الدعم لدينا.

القياس عن بعد؟

بشكل افتراضي ، يرسل Vespper تلقائيًا إحصائيات الاستخدام الأساسية من مثيلات مستضافة ذاتيًا إلى خادمنا عبر Posthog.

هذا يتيح لنا:

• فهم كيف يتم استخدام Vespper حتى نتمكن من تحسينه.
• تتبع الاستخدام العام للأغراض الداخلية والتقارير الخارجية ، مثل لجمع التبرعات.

كن مطمئنًا ، لا تتم مشاركة البيانات التي تم جمعها مع أطراف ثالثة ولا تتضمن أي معلومات حساسة. نهدف إلى أن نكون شفافين ، ويمكنك مراجعة البيانات المحددة التي نجمعها هنا.

إذا كنت تفضل عدم المشاركة ، فيمكنك إلغاء الاشتراك بسهولة عن طريق تعيين TELEMETRY_ENABLED=false داخل .env الخاص بك.

رخصة ؟

تم ترخيص هذا المشروع بموجب ترخيص Apache 2.0 - راجع ملف الترخيص للحصول على التفاصيل

يتعلم أكثر ؟

تحقق من الموقع الرسمي على https://vespper.com لمزيد من المعلومات.

المساهمين

بنيت مع ❤ بواسطة Dudu & Topaz

دودو: جيثب ، تويتر

توباز: جيثب ، تويتر