الوكلاء#
تربط الوكلاء الصور والنماذج والشروط والإجراءات ضمن سير عمل مرئي. استخدم YOLO لتحديد الصور التي تحتاج إلى تدقيق أقرب، أو اطلب من نموذج الرؤية واللغة شرحها، أو اجمع صورًا محددة في مجموعة بيانات لمراجعتها.
افتح الوكلاء من الشريط الجانبي أو انتقل إلى platform.ultralytics.com/agents. يظهر الوكلاء في الشريط الجانبي لكل مستخدم سجّل الدخول، في مساحات العمل الشخصية ومساحات عمل الفرق، دون الحاجة إلى تفعيل إعداد الوصول المبكر.
شغّل سير العمل الأول#
- افتح الوكلاء، وانقر على إضافة كتلة > القوالب، ثم اختر YOLO → مراقبة VLM.
- حدّد كتلة صورة الإدخال، واختر مجموعة بيانات مرفوعة، ثم حدّد صورة تتضمن شخصًا. استخدم صورة لا يتجاوز حجمها 4 ميغابكسل للتجربة المشتركة.
- أبقِ نموذج YOLO26 nano الافتراضي. يُجتاز الشرط عندما يرصد YOLO شخصًا واحدًا على الأقل.
- حدّد وصف المشهد، واختر نموذجًا للرؤية واللغة، وأدخل مطالبة. أضف مفتاح موفّر الخدمة المطابق في الإعدادات > مفاتيح API إذا لم تكن قد فعلت ذلك من قبل. في مساحة عمل فريق، اطلب من مالك مساحة العمل إضافة مفتاح موفّر الخدمة أو استبداله.
- أبقِ تجربة مشتركة · 60 ثانية محددًا لتشغيل صغير، ثم انقر على تشغيل.
- راقب تحديث الكتل وافحص الإخراج. إذا لم يُرصد أي شخص، ينتهي تنفيذ الشرط دون تشغيل فرع الوصف.
يمكنك تشغيل مسودة قبل حفظها. استخدم حفظ سير العمل لتسمية سير عمل وحفظه لاستخدامه لاحقًا، واحفظه مجددًا بعد إجراء تغييرات. يعرض زر Python رمز سير العمل المُنشأ.
ابدأ بقالب#
| القالب | سير العمل | مفيد لـ |
|---|---|---|
| YOLO → مراقبة VLM | صورة → YOLO → شرط → نموذج للرؤية واللغة → إخراج | وصف مشهد فقط عند رصد شخص |
| جمع الاكتشافات غير المؤكدة | مجموعة بيانات → نشر → شرط الثقة → مجموعة بيانات | إنشاء مجموعة للمراجعة من الصور ذات الاكتشافات غير المؤكدة |
| التقاط وتنبيه | صورة → YOLO → شرط → مجموعة بيانات وSlack | حفظ صورة وإشعار قناة استنادًا إلى الشرط نفسه |
القوالب نقاط بداية قابلة للتحرير. حدّد الصور والنشر ومجموعة البيانات المستهدفة وعمليات التكامل لمساحة عملك قبل تشغيلها. تعمل مسارات العمل هذه عند النقر على تشغيل؛ ويحلل قالب المراقبة صورة الإدخال المحددة.
اختر مكان التشغيل#
يحدّد منتقي التنفيذ بجوار تشغيل الأجهزة المستخدمة لسير العمل.
| الخيار | استخدمه من أجل | الحدود والأسعار |
|---|---|---|
| تجربة مشتركة · 60 ثانية | تجربة سير عمل صغير | مدة تصل إلى 60 ثانية، و20 صورة إدخال إجمالًا، لا يتجاوز حجم كل منها 4 ميغابكسل، و20 استدعاءً للنموذج/موفّر الخدمة؛ نموذج YOLO محلي واحد باستخدام نموذج YOLO26 nano رسمي |
| نشر مخصص حالي | مجموعات بيانات أكبر أو عمليات تشغيل أطول أو نماذج محلية أخرى | يستخدم الأجهزة والأسعار الحالية لذلك النشر، بما في ذلك النشر المخصص المجاني المؤهل؛ ولا يوجد حد إجمالي لمدة سير العمل أو عدد الصور |
| نشر جديد… | إنشاء أجهزة مخصصة من أداة الإنشاء | يفتح مربع حوار إنشاء عمليات النشر والأسعار الحالي؛ اختر الموارد وانتظر حتى يصبح النشر جاهزًا |
تتيح التجارب المشتركة ثلاث عمليات تشغيل في الدقيقة؛ ولا يوجد حد لمعدل عمليات التشغيل على نشر مخصص. تدعم عمليات التشغيل على المنصة ما يصل إلى 20 كتلة. تشمل استدعاءات النماذج/موفّري الخدمة YOLO ونماذج الرؤية واللغة وتنبؤات النشر وإجراءات Slack وWebhook؛ وقد يؤدي التفرّع إلى زيادة عدد الاستدعاءات لكل صورة إدخال.
تستمر عمليات التشغيل المخصصة ضمن طلبات ذات نقاط تحقق على النشر المحدد. لا يؤدي إغلاق المتصفح أو إعادة تحميله إلى إيقاف عملية التشغيل. تظل حدود النشر الحالي وحدود موفّري الخدمة سارية، ويفوتر موفّر الخدمة المرتبط بمفتاحك استخدام نماذج اللغة. راجع أسعار النشر للاطلاع على خيارات الأجهزة.
تحدّد كتلة النشر نقطة النهاية المستخدمة لخطوة التنبؤ. ويحدّد منتقي التنفيذ المكان الذي يعمل فيه سير العمل نفسه. يمكنك اختيار النشر المخصص نفسه لكليهما.
إعداد الكتل#
| الكتلة | الغرض |
|---|---|
| صورة | ارفع صورة أو مقطع فيديو تُستخرج منه عينات تصل إلى 10 إطارات افتراضيًا، أو حدّد صورة واحدة من مجموعة بيانات مرفوعة |
| مجموعة بيانات بلا اتصال وارد | قراءة الصور من مجموعة بيانات وتقسيم محددين، مع حد إدخال قابل للضبط |
| YOLO | تشغيل نموذج رسمي أو نموذج مُدرّب من مساحة العمل |
| النشر | إجراء تنبؤ عبر عملية نشر جاهزة وحالية على المنصة |
| LLM | إرسال الصورة والسياق السابق إلى نموذج اللغة أو نموذج الرؤية واللغة المحدد |
| بوابة | التحكم في التنفيذ اللاحق باستخدام شرط أو وتيرة محددة |
| مجموعة بيانات باتصال وارد | إضافة الصورة الواردة إلى مجموعة بيانات مستهدفة |
| Slack | إرسال رسالة إلى قناة Slack المتصلة بمساحة العمل |
| Webhook | إرسال متن JSON إلى نقطة نهاية HTTPS عبر POST |
| تصدير | تصدير نموذج باستخدام سير عمل التصدير الحالي في المنصة |
| الإخراج | عرض نتيجة الكتل السابقة |
حدّد كتلة لتحرير إعداداتها. صِل مخرجًا بكتلة أخرى لتمرير نتيجته إلى المراحل اللاحقة. يمكن توصيل مخرج واحد بكتل متعددة؛ على سبيل المثال، صِل شرطًا واحدًا بكل من مجموعة البيانات المستهدفة وSlack. يستخدم كل فرع الشرط المُقيّم نفسه.
تصفية الاكتشافات باستخدام شرط#
استخدم كتلة البوابة نفسها لأعداد الاكتشافات ومرشّحات الثقة. اختر نتيجة المرحلة السابقة، أو أي فئة أو فئة محددة، ومقارنة. على سبيل المثال:
- عدد الأشخاص ≥ 1: تابع عندما يُرصد شخص واحد على الأقل.
- الثقة بين 0.25 و0.5: تابع عندما يقع اكتشاف مطابق واحد على الأقل ضمن هذا النطاق الشامل للحدّين.
- فئة محددة ضمن نطاق ثقة: اجمع الاكتشافات غير المؤكدة لهذه الفئة فقط.
تفحص مرشّحات الثقة الاكتشافات الفردية. تجتاز صورة تتضمن درجتي 0.3 و0.9 نطاق 0.25–0.5 لأن أحد الاكتشافات يطابقه. لا تجتاز الصور التي لا تتضمن اكتشافات شرط الثقة. اضبط حد الثقة لنموذج التنبؤ على قيمة منخفضة بما يكفي للاحتفاظ بالاكتشافات التي تريد تقييمها.
ينتهي تنفيذ الشرط الذي لا يتحقق دون إخراج للمراحل اللاحقة. ولا تُنفذ الإجراءات المتصلة به لتلك الصورة.
جمع الصور للمراجعة#
افتح جمع الاكتشافات غير المؤكدة، واختر مجموعة بيانات مصدرًا وتقسيمًا، وحدّد نشر التنبؤ، واضبط نطاق الثقة. حدّد مجموعة بيانات مستهدفة حالية في كتلة مجموعة البيانات الأخيرة. أنشئ مجموعة بيانات من صفحة مجموعات البيانات أولًا إذا لزم الأمر.
تستقبل الوجهة الصور الأصلية دون تسميات، في التقسيم train الخاص بها. يتم تخطي النسخ الموجودة، وتسري حصص تخزين مجموعات البيانات المعتادة. لا تُنسخ تسميات المصدر وتنبؤات النموذج على هيئة تعليقات توضيحية. افتح الوجهة في محرر التعليقات التوضيحية الحالي لمراجعة الصور المجموعة ووضع تسميات لها.
استخدم صورًا مستضافة يمكن لمساحة عملك الوصول إليها، ومجموعة بيانات مستهدفة يمكنك تحريرها. لا يمكن استخدام مجموعات البيانات المتصلة بتخزين سحابي أو محلي داخل المؤسسة وجهاتٍ للجمع.
إرسال تنبيهات Slack مشروطة#
صِل Slack من الإعدادات > عمليات التكامل، ثم صِل شرطًا بكتلة Slack. أدخل الرسالة واستخدم {output} لتضمين نتيجة المرحلة السابقة. يربط قالب التقاط وتنبيه الشرط نفسه أيضًا بمجموعة بيانات، بحيث تُجمع الصورة المطابقة وتُرسل رسالة إلى القناة المتصلة.
تُضبط رسائل Slack الخاصة بسير العمل في الكتلة. وهي منفصلة عن خيارات إشعارات التدريب والتصدير والنشر في الإعدادات.
إرسال Webhooks#
ترسل كتلة Webhook عنصرًا واحدًا من POST لكل نتيجة، مع Content-Type: application/json إلى عنوان URL عام لـ HTTPS، بحيث يمكن لأي خدمة تقبل طلب JSON تلقي نتيجة الشرط. أدخل عنوان URL للوجهة ومتن JSON لا يتجاوز 10,000 حرف، مع تضمين {output} داخل سلسلة نصية ليُستبدل بنتيجة المرحلة السابقة؛ وهذه الكتلة نهائية ولا تقبل أي اتصال صادر. لا تُتبع عمليات إعادة التوجيه، وتنتهي مهلة الاتصال بعد 5 ثوانٍ، وتؤدي الاستجابة غير الناجحة برمز 2xx إلى فشل الكتلة.
متابعة التقدم وإيقاف عملية تشغيل#
تُظهر الكتل النشطة مؤشرًا دوارًا أخضر. وتُظهر الكتل المكتملة علامة صح وحدودًا خضراء، بينما تظهر حدود حمراء حول الكتل الفاشلة. تُبيّن الأعداد المدخلات التي وصلت إلى كل كتلة، وتظل الكتل اللاحقة دون تنفيذ عندما لا يتحقق الشرط.
تؤدي إعادة تحميل الصفحة إلى استعادة تقدم عملية التشغيل ونشر التنفيذ المحدد. وتظل النتائج المكتملة ظاهرة لسير العمل المطابق. انقر على إيقاف لإلغاء عملية تشغيل نشطة؛ وينتظر الإلغاء حتى تصل الكتلة الجاري تنفيذها إلى نقطة تسمح بالإلغاء. كما يؤدي إيقاف نشر التنفيذ أو حذفه إلى إلغاء سير العمل.
استكشاف الأخطاء وإصلاحها#
- تتجاوز عملية التشغيل حدود التجربة المشتركة: حدّد نشرًا مخصصًا، بما في ذلك نشر مجاني مؤهل، أو قلّل دقة الصورة وعدد المدخلات واستدعاءات النموذج/موفّر الخدمة.
- النشر قيد الإعداد أو متوقف: انتظر حتى يصبح جاهزًا أو ابدأ تشغيله من عمليات النشر.
- مفتاح موفّر الخدمة غير موجود: صِل موفّر الخدمة المحدد من الإعدادات > مفاتيح API. في مساحة عمل فريق، اطلب من مالك مساحة العمل إضافة المفتاح أو استبداله.
- لا تصل أي صور إلى الوجهة: افحص الشرط وحد الثقة للتنبؤ. لا تحقق نتائج الاكتشاف الفارغة نطاقًا للثقة مطلقًا.
- الصور المجموعة لا تتضمن تسميات: تضيف عملية الجمع الصور الأصلية للمراجعة. استخدم أدوات التعليقات التوضيحية الحالية لوضع تسميات لها.