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

​
متى تستخدم ذلك

يكون النشر من monorepo مفيداً عندما يحتوي مستودع واحد على عدة أتمتات أو حزم مشتركة أو كود تطبيقات آخر: 
company-ai/
|-- uv.lock
|-- packages/
|   `-- shared_tools/
`-- crews/
    |-- support_agent/
    |   |-- pyproject.toml
    |   `-- src/
    |       `-- support_agent/
    |           |-- main.py
    |           `-- crew.py
    `-- research_flow/
        |-- pyproject.toml
        `-- src/
            `-- research_flow/
                `-- main.py
لنشر support_agent، اضبط دليل العمل على: 
crews/support_agent
لا يزال AMP يجلب المستودع كاملاً أو يرفعه، لكنه يتعامل مع المجلد المحدد كجذر مشروع الأتمتة.

​
ما الذي يتحكم به دليل العمل

عند تعيين دليل عمل، يستخدم AMP ذلك المجلد من أجل:
  • التحقق من المشروع، بما في ذلك pyproject.toml وsrc/ ونقطة دخول Crew أو Flow
  • تثبيت الاعتماديات باستخدام uv
  • دليل العمل للعملية قيد التشغيل
  • متغير البيئة CREW_ROOT_DIR
ترك الحقل فارغاً يحافظ على السلوك الحالي ويستخدم جذر المستودع.

​
المصادر المدعومة

يمكنك تعيين دليل عمل عند إنشاء نشر من:
  • مستودع GitHub متصل
  • مستودع Git مكوّن في AMP
  • رفع ملف ZIP
اضبط أدلة العمل من واجهة AMP على الويب. لا يطلب تدفق CLI crewai deploy create هذا الحقل.
يمكنك أيضاً إضافة دليل العمل أو تغييره في نشر موجود من صفحة Settings الخاصة بالنشر. يسري التغيير في النشر التالي.
لا يمكن استخدام أدلة العمل وauto-deploy معاً. إذا كان للنشر دليل عمل، يتم تعطيل auto-deploy لذلك النشر. أوقف auto-deploy قبل تعيين دليل عمل.

​
إعداد نشر جديد

1

افتح Deploy from Code

في CrewAI AMP، أنشئ نشراً جديداً واختر المصدر: GitHub أو Git Repository أو رفع ZIP.
2

اختر المستودع أو الفرع أو ملف ZIP

اختر المستودع والفرع اللذين يحتويان على monorepo، أو ارفع ملف ZIP يحتوي جذره على محتويات monorepo.
3

افتح الإعدادات المتقدمة

وسّع قسم Advanced في نموذج النشر.
4

أدخل دليل العمل

أدخل المسار من جذر المستودع إلى مشروع Crew أو Flow:
crews/support_agent
لا تضف شرطة مائلة في البداية.
5

انشر

أضف أي متغيرات بيئة مطلوبة، ثم ابدأ النشر.

​
إعداد نشر موجود

1

افتح إعدادات النشر

انتقل إلى الأتمتة في AMP وافتح Settings.
2

أوقف auto-deploy إذا لزم الأمر

إذا كان auto-deploy مفعلاً، أوقفه أولاً. لا يكون حقل دليل العمل متاحاً أثناء تشغيل auto-deploy.
3

عيّن دليل العمل

في Basic settings، أدخل مسار المجلد الفرعي، مثل:
crews/support_agent
4

أعد النشر

احفظ الإعداد وأعد نشر الأتمتة. سيتم استخدام دليل العمل الجديد في النشر التالي.

​
قواعد المسار

يجب أن يكون دليل العمل مساراً نسبياً داخل جذر المستودع أو ZIP.
القاعدةالمثال
استخدم مساراً نسبياًcrews/support_agent
لا تبدأ بـ //crews/support_agent غير صالح
لا تستخدم مقاطع المسار . أو ..crews/../support_agent غير صالح
استخدم الأحرف والأرقام والشرطات والشرطات السفلية والنقاط والشرطات المائلة فقطcrews/support agent غير صالح
اجعل المسار 255 حرفاً أو أقليتم رفض المسارات الأطول
يزيل AMP المسافات البيضاء في البداية والنهاية، ويضغط الشرطات المائلة المتكررة، ويزيل الشرطة المائلة النهائية. تستخدم القيمة الفارغة جذر المستودع.

​
ملفات القفل وUV Workspaces

يجب أن يحتوي المجلد المحدد على pyproject.toml ودليل src/ الخاصين بالأتمتة. يمكن أن يوجد ملف uv.lock أو poetry.lock إما في المجلد المحدد أو في جذر المستودع. يدعم هذا التخطيطين الشائعين في monorepo: 
company-ai/
`-- crews/
    `-- support_agent/
        |-- pyproject.toml
        |-- uv.lock
        `-- src/
            `-- support_agent/
                `-- main.py
إذا كانت الأتمتة تستورد حزماً مشتركة من مكان آخر في monorepo، فصرّح بهذه الحزم في pyproject.toml باستخدام إعدادات UV workspace أو path أو source. يشغل AMP الأتمتة من المجلد المحدد، لذلك يجب تثبيت الكود المشترك كاعتمادية بدلاً من الاعتماد على وجود جذر المستودع في Python path.

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

​
لم يتم العثور على دليل العمل

تحقق من أن المسار نسبي إلى جذر المستودع أو ZIP. بالنسبة لرفع ZIP، يجب أن تتضمن محتويات ZIP مسار دليل العمل تماماً كما أدخلته.

​
pyproject.toml مفقود

يجب أن يشير دليل العمل إلى مجلد مشروع Crew أو Flow، وليس فقط إلى مجلد أب يحتوي على عدة مشاريع.

​
uv.lock أو poetry.lock مفقود

اعمل commit لملف قفل إما في مجلد المشروع المحدد أو في جذر المستودع. بالنسبة إلى UV workspaces، يتم دعم إبقاء uv.lock في جذر workspace.

​
Auto-Deploy غير متاح

يتم تعطيل auto-deploy أثناء تعيين دليل عمل. استخدم إعادة النشر اليدوية أو شغّل إعادة النشر من CI/CD باستخدام AMP API.

النشر على AMP

تابع دليل النشر بعد اختيار دليل عمل monorepo.