الوكلاء#
تربط Agents الصور والنماذج والشروط والإجراءات ضمن سير عمل مرئي. استخدم YOLO لتحديد الصور التي تحتاج إلى تدقيق أدق، أو اطلب من نموذج رؤية ولغة شرحها، أو اجمع صورًا محددة في مجموعة بيانات لمراجعتها.
افتح Agents في الشريط الجانبي أو انتقل إلى platform.ultralytics.com/agents. يظهر Agents في الشريط الجانبي لكل مستخدم مسجّل الدخول، في مساحات العمل الشخصية والجماعية، دون الحاجة إلى تفعيل إعداد الوصول المبكر.
شغّل أول سير عمل لك#
- افتح 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 | POST جسم JSON إلى نقطة نهاية HTTPS |
| التصدير | تصدير نموذج باستخدام سير عمل التصدير الحالي في المنصة |
| إخراج | عرض نتيجة الكتلة السابقة |
حدّد كتلة لتحرير إعداداتها. صِل مخرجًا بكتلة أخرى لتمرير نتيجته إلى المراحل اللاحقة. يمكن توصيل مخرج واحد بكتل متعددة؛ على سبيل المثال، صِل شرطًا بكل من مجموعة بيانات وجهة وSlack. يستخدم كل فرع الشرط المُقيَّم نفسه.
تصفية الاكتشافات باستخدام شرط#
استخدم كتلة البوابة نفسها لأعداد الاكتشافات ومرشحات الثقة. اختر نتيجة المرحلة السابقة، أو أي فئة أو فئة محددة، ثم اختر عامل مقارنة. على سبيل المثال:
- عدد الأشخاص ≥ 1: تابع عند اكتشاف شخص واحد على الأقل.
- الثقة بين 0.25 و0.5: تابع عند وقوع اكتشاف مطابق واحد على الأقل ضمن هذا النطاق الشامل.
- فئة محددة ضمن نطاق ثقة: اجمع الاكتشافات غير المؤكدة لهذه الفئة وحدها.
تفحص مرشحات الثقة الاكتشافات الفردية. تجتاز صورة بدرجات 0.3 و0.9 نطاق 0.25–0.5 لأن أحد الاكتشافات يطابقه. لا تجتاز الصور التي لا تتضمن اكتشافات شرط الثقة. اضبط حد الثقة لنموذج التنبؤ على قيمة منخفضة بما يكفي للاحتفاظ بالاكتشافات التي تريد تقييمها.
يكتمل الشرط الذي لا ينطبق من دون أي إخراج لاحق. ولا تُشغَّل الإجراءات المتصلة به لتلك الصورة.
جمع الصور للمراجعة#
افتح Collect Uncertain Detections، واختر مجموعة بيانات مصدرًا وتقسيمًا، وحدد نشر التنبؤات، واضبط نطاق الثقة. حدد مجموعة بيانات وجهة موجودة في الكتلة الأخيرة Dataset. أنشئ مجموعة بيانات أولًا من صفحة مجموعات البيانات عند الحاجة.
تستقبل الوجهة الصور الأصلية من دون تسميات في التقسيم train. يتم تخطي النسخ الموجودة، وتسري حصص التخزين المعتادة لمجموعات البيانات. لا تُنسخ تسميات المصدر ولا تنبؤات النموذج بوصفها تعليقات توضيحية. افتح الوجهة في محرر التعليقات التوضيحية الحالي لمراجعة الصور المجمعة ووضع تسمياتها.
استخدم الصور المستضافة التي يمكن لمساحة عملك الوصول إليها، ومجموعة بيانات وجهة يمكنك تعديلها. لا يمكن استخدام مجموعات البيانات المتصلة بالتخزين السحابي أو المحلية في الموقع كوجهات للتجميع.
إرسال تنبيهات Slack مشروطة#
اربط Slack ضمن Settings > Integrations، ثم صِل شرطًا بكتلة Slack. أدخل الرسالة واستخدم {output} لتضمين نتيجة المنبع. يربط Capture and Alert الشرط نفسه أيضًا بمجموعة بيانات، بحيث تُجمع الصورة المطابقة وتُرسل رسالة إلى القناة المتصلة.
تُضبط رسائل Slack لسير العمل ضمن الكتلة. وهي منفصلة عن خيارات إشعارات التدريب والتصدير والنشر في Settings.
إرسال خطافات الويب#
ترسل كتلة Webhook طلبًا واحدًا من POST لكل نتيجة، مع Content-Type: application/json، إلى عنوان URL عام يستخدم HTTPS، لذا يمكن لأي خدمة تقبل طلب JSON استلام نتيجة الشرط. أدخل عنوان URL الوجهة ونص JSON بحد أقصى 10,000 حرف، مع وضع {output} داخل سلسلة نصية، حيث يُستبدل بنتيجة المنبع؛ والكتلة نهائية ولا تقبل أي اتصال صادر. لا تُتبع عمليات إعادة التوجيه، وتنتهي مهلة الاتصال بعد 5 ثوانٍ، وتؤدي الاستجابة التي لا تكون من فئة 2xx إلى فشل الكتلة.
متابعة التقدم وإيقاف التشغيل#
تعرض الكتل النشطة مؤشرًا أخضر دوارًا. وتعرض الكتل المكتملة علامة صح وحدودًا خضراء، بينما تظهر حدود حمراء حول الكتل الفاشلة. توضح الأعداد المدخلات التي وصلت إلى كل كتلة، وتظل الكتل اللاحقة غير منفذة عندما لا يطابق الشرط.
تعيد إعادة تحميل الصفحة عرض تقدم التشغيل ونشر التنفيذ المحدد. وتظل النتائج المكتملة ظاهرة لسير العمل المطابق. انقر Stop لإلغاء تشغيل نشط؛ وينتظر الإلغاء وصول الكتلة قيد التنفيذ إلى نقطة تسمح بالإلغاء. كما يؤدي إيقاف نشر التنفيذ أو حذفه إلى إلغاء سير العمل.
إدارة الوكلاء باستخدام API#
تتيح واجهة Agents API عرض الوكلاء وحفظهم وحذفهم برمجيًا، وتتيح Python SDK الوصول إليها بوصفها client.agents في ultralytics-platform>=0.1.74. يعيد الحفظ أخطاء الكتل نفسها التي تعرضها لوحة العمل. يظل بدء التشغيل من لوحة العمل: افتح وكيلًا محفوظًا في https://platform.ultralytics.com/agents?workflow={id} وانقر Run.
استكشاف الأخطاء وإصلاحها#
- يتجاوز التشغيل الحدود المشتركة للتجربة: اختر نشرًا مخصصًا، بما في ذلك نشر مجاني مؤهل، أو قلل دقة الصورة وعدد المدخلات واستدعاءات النماذج أو المزوّدين.
- النشر قيد التجهيز أو متوقف: انتظر حتى يصبح جاهزًا أو ابدأ تشغيله من Deployments.
- مفتاح المزوّد غير موجود: اربط المزوّد المحدد ضمن Settings > API Keys. في مساحة عمل جماعية، اطلب من مالك مساحة العمل إضافة المفتاح أو استبداله.
- لا تصل أي صور إلى الوجهة: افحص الشرط والحد الأدنى لثقة التنبؤ. لا تحقق نتائج الكشف الفارغة مطلقًا نطاق الثقة.
- الصور المجمعة بلا تسميات: يضيف التجميع الصور الأصلية للمراجعة. استخدم أدوات التعليقات التوضيحية الحالية لوضع التسميات عليها.