النشر على AMP

​

المتطلبات المسبقة

​

الخيار 1: النشر باستخدام CrewAI CLI

pip install crewai[tools]

# إذا كان لديك حساب CrewAI AMP بالفعل، أو تريد إنشاء واحد:
crewai login

crewai deploy create

Deployment created successfully!
Name: your_project_name
Deployment ID: 01234567-89ab-cdef-0123-456789abcdef
Current Status: Deploy Enqueued

crewai deploy status

crewai deploy logs

​

أوامر CLI إضافية

# عرض جميع عمليات النشر
crewai deploy list

# الحصول على حالة النشر
crewai deploy status

# عرض سجلات النشر
crewai deploy logs

# دفع التحديثات بعد تغييرات الكود
crewai deploy push

# إزالة عملية نشر
crewai deploy remove <deployment_id>

​

الخيار 2: النشر مباشرة عبر واجهة الويب

1

الدفع إلى GitHub

تحتاج لدفع طاقمك إلى مستودع GitHub. إذا لم تكن قد أنشأت طاقماً بعد، يمكنك اتباع هذا الدليل.

2

ربط GitHub بـ CrewAI AMP

1. سجّل الدخول إلى CrewAI AMP
2. انقر على زر “Connect GitHub”

3

اختيار المستودع

بعد ربط حساب GitHub، ستتمكن من اختيار المستودع للنشر:

4

تعيين متغيرات البيئة

قبل النشر، ستحتاج لإعداد متغيرات البيئة للاتصال بمزود LLM أو خدمات أخرى:

1. يمكنك إضافة المتغيرات فردياً أو بشكل جماعي
2. أدخل متغيرات البيئة بتنسيق KEY=VALUE (واحد لكل سطر)

تستخدم حزم Python خاصة؟ ستحتاج لإضافة بيانات اعتماد السجل هنا أيضاً. راجع سجلات الحزم الخاصة للمتغيرات المطلوبة.

5

نشر طاقمك

1. انقر على زر “Deploy” لبدء عملية النشر
2. يمكنك مراقبة التقدم عبر شريط التقدم
3. يستغرق النشر الأول عادة حوالي 10-15 دقيقة؛ عمليات النشر اللاحقة ستكون أسرع

بمجرد اكتمال النشر، سترى:

• رابط طاقمك الفريد
• رمز Bearer لحماية API طاقمك
• زر “Delete” إذا كنت تحتاج لإزالة النشر

​

الخيار 3: إعادة النشر باستخدام API (تكامل CI/CD)

curl -i -X POST \
     -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
     https://app.crewai.com/crewai_plus/api/v1/crews/YOUR-AUTOMATION-UUID/deploy

# HTTP/2 200
# content-type: application/json
#
# {
#   "uuid": "your-automation-uuid",
#   "status": "Deploy Enqueued",
#   "public_url": "https://your-crew-deployment.crewai.com",
#   "token": "your-bearer-token"
# }

name: Deploy CrewAI Automation

on:
  push:
    branches: [ main ]
  pull_request:
    types: [ labeled ]
  release:
    types: [ published ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    if: |
      (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
      (github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'deploy')) ||
      (github.event_name == 'release')
    steps:
      - name: Trigger CrewAI Redeployment
        run: |
          curl -X POST \
               -H "Authorization: Bearer ${{ secrets.CREWAI_PAT }}" \
               https://app.crewai.com/crewai_plus/api/v1/crews/${{ secrets.CREWAI_AUTOMATION_UUID }}/deploy

​

التفاعل مع أتمتتك المنشورة

1. REST API: تنشئ المنصة نقطة نهاية HTTPS فريدة بهذه المسارات الرئيسية:
   • /inputs: يعرض معاملات الإدخال المطلوبة
   • /kickoff: يبدأ التنفيذ بالمدخلات المقدمة
   • /status/{kickoff_id}: يتحقق من حالة التنفيذ
2. واجهة الويب: زر app.crewai.com للوصول إلى:
   • علامة تبويب Status: عرض معلومات النشر وتفاصيل نقطة نهاية API ورمز المصادقة
   • علامة تبويب Run: تمثيل مرئي لبنية طاقمك
   • علامة تبويب Executions: سجل جميع عمليات التنفيذ
   • علامة تبويب Metrics: تحليلات الأداء
   • علامة تبويب Traces: رؤى التنفيذ المفصلة

​

تشغيل عملية تنفيذ

1. النقر على اسم طاقمك لفتح تفاصيله
2. اختيار “Trigger Crew” من واجهة الإدارة
3. إدخال المدخلات المطلوبة في النافذة المنبثقة
4. مراقبة التقدم أثناء مرور التنفيذ عبر خط الأنابيب

​

المراقبة والتحليلات

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

​

ميزات متقدمة

• إدارة متغيرات البيئة: تخزين وإدارة مفاتيح API بأمان
• اتصالات LLM: تهيئة التكاملات مع مزودي LLM المختلفين
• مستودع الأدوات المخصصة: إنشاء ومشاركة وتثبيت الأدوات
• Crew Studio: بناء الطواقم عبر واجهة محادثة دون كتابة كود

​

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

​

فشل البناء

​

ملف uv.lock مفقود

uv lock
git add uv.lock
git commit -m "Add uv.lock for deployment"
git push

​

بنية المشروع الخاطئة

• كل من الطواقم والتدفقات: يجب أن تكون نقطة الدخول في src/project_name/main.py
• الطواقم: تستخدم دالة run() كنقطة دخول
• التدفقات: تستخدم دالة kickoff() كنقطة دخول

​

مُزخرف CrewBase مفقود

from crewai.project import CrewBase, agent, crew, task

@CrewBase  # This decorator is REQUIRED
class YourCrew():
    """Your crew description"""

    @agent
    def my_agent(self) -> Agent:
        return Agent(
            config=self.agents_config['my_agent'],  # type: ignore[index]
            verbose=True
        )

    # ... rest of crew definition

​

نوع pyproject.toml غير صحيح

# For Crew projects:
[tool.crewai]
type = "crew"

# For Flow projects:
[tool.crewai]
type = "flow"

​

فشل وقت التشغيل

​

فشل اتصال LLM

1. تحقق من صحة تعيين مفتاح API لمزود LLM في متغيرات البيئة
2. تأكد من تطابق أسماء متغيرات البيئة مع ما يتوقعه الكود
3. اختبر محلياً بنفس متغيرات البيئة بالضبط قبل النشر

​

أخطاء تنفيذ الطاقم

1. تحقق من سجلات التنفيذ في لوحة تحكم AMP (علامة تبويب Traces)
2. تحقق من أن جميع الأدوات لديها مفاتيح API المطلوبة مُهيأة
3. تأكد من صحة تهيئات الوكلاء في agents.yaml
4. تحقق من تهيئات المهام في tasks.yaml بحثاً عن أخطاء الصياغة