> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/almyzat-alreysyh/ai-agent-usage.md).

# AI Assistant | HMI, Workflows and Custom Blocks

![AI Agent](/files/M3Jchg4bvew8saNUZh5y) *AI Agent*

AugeLab AI هو خبيرك داخل التطبيق للميزات، استكشاف الأخطاء وإصلاحها، وتصميم تدفقات العمل. للحصول على أفضل نتيجة، قدّم دائمًا سياقًا واضحًا (Goal, Setup, Action, and Expected Result).

<details>

<summary>🛠️ بناء تدفقات العمل والسيناريوهات</summary>

الذكاء الاصطناعي يبني منطقًا أفضل عندما يعرف بيئتك والقيود.

* **التفاصيل التي يجب تضمينها:** مصدر الإدخال (Camera/Folder)، هدف الإخراج (Measurement/Detection)، والقيود (Target FPS/Accuracy).
* **مثال على طلب:**

  > Goal: Detect missing silver parts on a black conveyor belt moving at 0.2m/s. Setup: Windows 11, NVIDIA GPU, Basler camera. Expected: Recommended node sequence and tuning tips.

![AI Agent Interface](/files/M3Jchg4bvew8saNUZh5y) *AI Agent Interface*

</details>

<details>

<summary>🧩 تصميم البلوكات المخصصة</summary>

وصف البلوكات المخصصة كـ "مواصفة منتج مصغرة" يساعد الذكاء الاصطناعي على توليد بنية Python الصحيحة.

* **التفاصيل التي يجب تضمينها:** أنواع الدخل/الخرج (Image, Bool, إلخ)، المعاملات القابلة للتعديل من قبل المستخدم، ومنطق النجاح/الفشل.
* **مثال على طلب:**

  > Goal: Create a block that checks if a part is in a safe window. Input: Detection (x,y,w,h). Output: PASS/FAIL for HMI. Need parameters for tolerance and debounce.

![Custom Block Logic](/files/PDl0MKgY4XhsGHRaTpq1) *Custom Block Logic*

</details>

<details>

<summary>🖥️ إنشاء تطبيقات HMI</summary>

ركّز على مَن يستخدم الشاشة وماذا يحتاجون أن يقرروا.

* **التفاصيل التي يجب تضمينها:** الجهاز المستهدف (Touchscreen/PC)، البيانات الأساسية للعرض السريع (Counters/Status)، والإجراءات المطلوبة (Start/Stop/Reset).
* **مثال على طلب:**

  > Goal: Simple operator HMI for PASS/FAIL station. Needs a large status indicator and a reset button for alarms.

</details>

<details>

<summary>🐞 استكشاف الأخطاء والأداء</summary>

لإصلاح الأخطاء أو "التأخر"، يحتاج الذكاء الاصطناعي إلى أدلة واضحة.

* **بالنسبة للأخطاء:** قدّم نص الخطأ بالضبط، خطوات إعادة إنتاج المشكلة، والسجلات.
* **بالنسبة للأداء:** اذكر أي إجراء بطيء (مثال: "Inference taking 500ms") واستخدام GPU لديك.
* **مثال على طلب:**

  > Goal: Fix crash on Chat panel. Setup: Windows 11. Action: Clicked Chat menu. Result: App closed immediately. Log: \[Attached].

![Debugging with AI Agent](/files/QRn41PXAl8rrESgCo7RF) *Debugging with AI Agent*

</details>

<details>

<summary>📸 لقطات شاشة فعّالة والخصوصية</summary>

* **التقاط اللوحة كاملة:** أظهر العقدة المحددة ولوحة الإعدادات معًا.
* **التسليط:** استخدم أسهمًا أو دوائر لتوضيح الخطأ أو الزر المفقود.
* **🔒 الخصوصية أولًا:** لا تشارك مفاتيح الترخيص، كلمات المرور، أو بيانات العملاء الحساسة. قم بتشويش المعلومات في الصور قبل رفعها.

</details>

***

### 💡 إذا أخطأ المساعد:

لا تفتح محادثة جديدة. قدّم تصحيحًا محددًا مثل:

> "هذا غير صحيح تمامًا. أنا أستخدم تحديدًا \[Panel Name] والمشكلة هي \[X]. الرجاء تجنّب استخدام \[Node Y]."
