rasa
3.6.20
نحن نقوم بترحيل القضايا إلى جيرا
بدءًا من يناير 2023، توجد إصدارات Rasa Open Source في لوحة Jira هذه. يمكنك تصفح القضايا دون تسجيل الدخول؛ إذا كنت تريد إنشاء مشكلات، فستحتاج إلى إنشاء حساب Jira.
Rasa هو إطار عمل مفتوح المصدر للتعلم الآلي لأتمتة المحادثات النصية والصوتية. باستخدام Rasa، يمكنك إنشاء مساعدين سياقيين على:
أو المساعدين الصوتيين مثل:
يساعدك Rasa على بناء مساعدين سياقيين قادرين على إجراء محادثات متعددة الطبقات مع الكثير من المحادثات المتبادلة. لكي يتمكن الإنسان من إجراء تبادل مفيد مع مساعد سياقي، يجب أن يكون المساعد قادرًا على استخدام السياق للبناء على الأشياء التي تمت مناقشتها مسبقًا - يمكّنك Rasa من بناء مساعدين يمكنهم القيام بذلك بطريقة قابلة للتطوير.
هناك الكثير من المعلومات الأساسية في منشور المدونة هذا.
؟ اعرف المزيد عن Rasa
؟ قراءة المستندات
؟ تثبيت راسا
الغوص بشكل أعمق في مركز التعلم
؟ يساهم
❓ احصل على دعم على مستوى المؤسسة
؟ اكتشف مميزات منصتنا التجارية
تعرف على المزيد حول الأوراق البحثية التي تستفيد من Rasa
هناك وثائق واسعة النطاق في مستندات Rasa. تأكد من تحديد الإصدار الصحيح حتى تتمكن من الاطلاع على المستندات الخاصة بالإصدار الذي قمت بتثبيته.
يرجى استخدام منتدى مجتمع Rasa للحصول على إجابات سريعة للأسئلة.
يسعدنا جدًا تلقي مساهماتك ودمجها في هذا المستودع!
للمساهمة عبر طلب السحب، اتبع الخطوات التالية:
للحصول على تعليمات أكثر تفصيلاً حول كيفية المساهمة بالكود، راجع إرشادات المساهمين بالكود هذه.
يمكنك العثور على مزيد من المعلومات حول كيفية المساهمة في Rasa (بعدة طرق مختلفة!) على موقعنا الإلكتروني..
ستتم مراجعة طلب السحب الخاص بك بواسطة أحد المشرفين، والذي سيعود إليك بشأن أي تغييرات أو أسئلة ضرورية. سيُطلب منك أيضًا التوقيع على اتفاقية ترخيص المساهم.
تستخدم راسا الشعر للتغليف وإدارة التبعية. إذا كنت ترغب في بنائه من المصدر، فيجب عليك تثبيت Poetry أولاً. يرجى اتباع الدليل الرسمي لرؤية جميع الخيارات الممكنة.
لتحديث نسخة شعرية موجودة إلى النسخة المستخدمة حاليًا في rasa، قم بتشغيل:
poetry self update < version >يقترح دليل الشعر الرسمي استخدام pyenv أو أي أداة أخرى مشابهة للتبديل بسهولة بين إصدارات Python. هذه هي الطريقة التي يمكن القيام بها:
pyenv install 3.10.10
pyenv local 3.10.10 # Activate Python 3.10.10 for the current projectملاحظة : إذا كنت تواجه مشكلة في تثبيت إصدار معين من لغة python على نظامك، فقد يكون من المفيد تجربة إصدارات أخرى مدعومة.
افتراضيًا، سيحاول Poetry استخدام إصدار Python المنشط حاليًا لإنشاء البيئة الافتراضية للمشروع الحالي تلقائيًا. يمكنك أيضًا إنشاء بيئة افتراضية وتنشيطها يدويًا — في هذه الحالة، يجب على Poetry التقاطها واستخدامها لتثبيت التبعيات. على سبيل المثال:
python -m venv .venv
source .venv/bin/activateيمكنك التأكد من التقاط البيئة عن طريق التنفيذ
poetry env info لتثبيت التبعيات وتنفيذ rasa نفسه في الوضع القابل للتحرير
make install ملاحظة لمستخدمي macOS : في نظام macOS Big Sur، رأينا بعض مشكلات المترجم الخاصة بالتبعيات. استخدام export SYSTEM_VERSION_COMPAT=1 قبل التثبيت ساعد.
لتثبيت تبعيات rasa الاختيارية، تحتاج إلى تشغيل:
make install-full ملاحظة لمستخدمي macOS : قد يؤدي الأمر make install-full إلى فشل أثناء تثبيت tokenizers (المشكلة موضحة بالتفصيل هنا).
لحل هذه المشكلة، يجب عليك اتباع الخطوات التالية لتثبيت مترجم Rust:
brew install rustup
rustup-initبعد تهيئة مترجم Rust، يجب عليك إعادة تشغيل وحدة التحكم والتحقق من تثبيتها:
rustc --versionفي حالة عدم إعداد متغير PATH تلقائيًا، قم بتشغيل:
export PATH= " $HOME /.cargo/bin: $PATH "أولاً، قم بتثبيت كافة التبعيات المطلوبة:
make install install-docsبعد انتهاء التثبيت، يمكنك تشغيل الوثائق وعرضها محليًا باستخدام:
make livedocsيجب أن يفتح علامة تبويب جديدة بالإصدار المحلي من المستندات في متصفحك؛ إذا لم يكن الأمر كذلك، قم بزيارة http://localhost:3000 في متصفحك. يمكنك الآن تغيير المستندات محليًا وسيتم إعادة تحميل صفحة الويب وتطبيق التغييرات تلقائيًا.
لإجراء الاختبارات، تأكد من تثبيت متطلبات التطوير:
make prepare-tests-ubuntu # Only on Ubuntu and Debian based systems
make prepare-tests-macos # Only on macOSثم قم بإجراء الاختبارات:
make testويمكن أيضًا تشغيلها في وظائف متعددة لتوفير بعض الوقت:
JOBS=[n] make test حيث [n] هو عدد الوظائف المطلوبة. إذا تم حذفه، فسيتم اختيار [n] تلقائيًا بواسطة pytest.
من أجل تشغيل اختبارات التكامل، تأكد من تثبيت متطلبات التطوير:
make prepare-tests-ubuntu # Only on Ubuntu and Debian based systems
make prepare-tests-macos # Only on macOSستحتاج بعد ذلك إلى بدء الخدمات باستخدام الأمر التالي الذي يستخدم Docker Compose:
make run-integration-containersوأخيرًا، يمكنك إجراء اختبارات التكامل مثل هذا:
make test-integration لا يتضمن الشعر أي حل يمكن أن يساعد في حل تعارضات الدمج في ملف القفل poetry.lock بشكل افتراضي. ومع ذلك، هناك أداة عظيمة تسمى قفل دمج الشعر. إليك كيفية تثبيته:
pip install poetry-merge-lock ما عليك سوى تنفيذ هذا الأمر لحل تعارضات الدمج في poetry.lock تلقائيًا:
poetry-merge-lockمن أجل إنشاء صورة Docker على جهازك المحلي، قم بتنفيذ الأمر التالي:
make build-docker تتوفر صورة Docker على جهازك المحلي باسم rasa:localdev .
لضمان نمط رمز موحد نستخدم المنسق الأسود. للتأكد من صحة التعليقات التوضيحية للنوع، نستخدم pytype لمدقق النوع. إذا لم يتم تنسيق الكود الخاص بك بشكل صحيح أو لم يكتب التحقق، فسوف يفشل إنشاء GitHub.
إذا كنت تريد تنسيق التعليمات البرمجية الخاصة بك تلقائيًا في كل التزام، فيمكنك استخدام الالتزام المسبق. ما عليك سوى تثبيته عبر pip install pre-commit وتنفيذ pre-commit install في المجلد الجذر. سيؤدي هذا إلى إضافة رابط إلى المستودع، والذي يعيد تنسيق الملفات في كل التزام.
إذا كنت ترغب في إعداده يدويًا، فقم بتثبيت اللون الأسود عبر poetry install . لإعادة تنسيق الملفات تنفيذ
make formatter
إذا كنت تريد التحقق من الأنواع الموجودة في قاعدة التعليمات البرمجية، فقم بتثبيت mypy باستخدام poetry install . للتحقق من تنفيذ الأنواع
make types
نحن نستخدم Docusaurus v2 لإنشاء مستندات للإصدارات الموسومة وللفرع main . لتشغيل Docusaurus، قم بتثبيت Node.js 12.x . يتم دفع الموقع الثابت الذي تم إنشاؤه إلى فرع documentation في هذا الريبو.
نحن نستضيف الموقع على netlify. في إصدارات الفرع main (راجع .github/workflows/documentation.yml )، ندفع المستندات المضمنة إلى فرع documentation . يقوم Netlify بإعادة نشر صفحات المستندات تلقائيًا عندما يكون هناك تغيير في هذا الفرع.
نفذت Rasa سياسات قوية تحكم تسمية الإصدارات، بالإضافة إلى سرعة إصدار الإصدارات الرئيسية والثانوية وإصدارات التصحيح.
تتم زيادة قيم رقم الإصدار المحدد (MAJOR.MINOR.PATCH) كما يلي:
يصف الجدول التالي أنواع الإصدارات وإيقاع إصدارها المتوقع:
| نوع الإصدار | وصف | الإيقاع المستهدف |
|---|---|---|
| رئيسي | لإجراء تغييرات مهمة، أو عند إدخال أي تغييرات غير متوافقة مع الإصدارات السابقة على واجهة برمجة التطبيقات أو نموذج البيانات. | كل 1 - 2 سنة |
| صغير | لأنه عند تقديم وظيفة جديدة متوافقة مع الإصدارات السابقة، يتم تقديم ميزة ثانوية، أو عند طرح مجموعة من الميزات الأصغر. | +/- ربع سنوي |
| رقعة | للحصول على إصلاحات الأخطاء المتوافقة مع الإصدارات السابقة والتي تعمل على إصلاح السلوك غير الصحيح. | حسب الحاجة |
في حين أن هذا الجدول يمثل وتيرة الإصدار المستهدفة لدينا، إلا أننا نحتفظ بالحق في تعديله بناءً على ظروف السوق المتغيرة والمتطلبات الفنية.
تحدد سياسة نهاية الحياة لدينا المدة التي يعتبر فيها إصدار معين مدعومًا، بالإضافة إلى المدة التي يعتبر فيها الإصدار لا يزال قيد التطوير أو الصيانة النشطة.
يتم عرض مدة الصيانة ونهاية العمر الافتراضي لكل إصدار على موقعنا الإلكتروني كجزء من سياسة إصدار المنتج وصيانته.
بعد اكتمال الإصدار الرئيسي، يرجى اتباع هذه التعليمات لإكمال تحديث الوثائق.
يعد إصدار إصدار جديد أمرًا بسيطًا للغاية، حيث يتم إنشاء الحزم وتوزيعها بواسطة GitHub Actions.
خطوات الإصدار :
git checkout -b 1.2.x
git push origin 1.2.xmain في حالة وجود فرع رئيسي، فرع <major>.<minor>.x للإصدارات الثانوية والتصحيحات)rasa-sdk في pyproject.toml بإصدار الإصدار الجديد وقم بتشغيل poetry update . يؤدي هذا إلى إنشاء ملف poetry.lock جديد مع حل جميع التبعيات.git commit -am "bump rasa-sdk dependency" ولكن لا تدفعها. سيتم التقاطهم تلقائيًا من خلال الخطوة التالية.make release1.2.x )git checkout 1.2.x
git pull origin 1.2.x
git tag 1.2.0 -m " next release "
git push origin 1.2.0 --tagsproduct Slack الخاصة بالشركة مثل هذه.event: push والتفرع branch: <version number> (مثال على الإصدار 2.4 يمكنك رؤيته هنا)product ، تحقق أيضًا من قناة product-engineering-alerts إذا كان هناك أي تنبيهات تتعلق بإصدار Rasa Open Source مثل هذا الإصدارتعد إصدارات التصحيح أسهل في القطع، نظرًا لأنها تهدف إلى احتواء إصلاحات الأخطاء فقط.
الأشياء الوحيدة التي عليك القيام بها لقص إصدار التصحيح هي:
2.0.4 ، فسوف تحتاج إلى أن تكون إصلاحاتك في فرع الإصدار 2.0.x ). يجب أن تأتي كافة إصدارات التصحيح من فرع .x !make release واتبع الخطوات + قم بدمج العلاقات العامة..x مرة أخرى وادفع العلامة!ملاحظة: هذا مطلوب فقط إذا كان الإصدار الذي تم إصداره هو أعلى إصدار متوفر. على سبيل المثال، قم بتنفيذ الخطوات التالية عندما يكون الإصدار > الإصدار موجودًا على الملف الرئيسي.
من أجل التحقق من التوافق بين إصدار Rasa الجديد مع الإصدار الأحدث من Rasa X/Enterprise، نقوم بالخطوات التالية:
برجاء الرجوع إلى صفحة سياسة إصدار منتج Rasa وصيانته.
مرخص بموجب ترخيص أباتشي، الإصدار 2.0. حقوق الطبع والنشر لعام 2022 محفوظة لشركة Rasa Technologies GmbH. نسخة من الرخصة.
يمكن العثور على قائمة تراخيص تبعيات المشروع في أسفل ملخص المكتبات.
