وكيل الذكاء الاصطناعي Biz1 Sidebar — مرجع كامل

آخر تحديث: 2026-05-31

مساعد اللغة الطبيعية في **الشريط الجانبي الأيمن** في معظم صفحات إدارة علاقات العملاء (CRM). يوجه نية المستخدم ← إلى متخصص ← لتوضيح واجهة المستخدم أو التنفيذ الفوري.

1. مكان تواجده

| المكون | الموقع |

|-------|----------|

| واجهة المستخدم (UI) | `application/views/include/sidebar.php` — نموذج الدردشة `#send_message_biz1agent` |

| واجهة برمجة التطبيقات (Entry API) | `POST dashboard/aicomponent/send_message` ← `Aicomponent::send_message()` |

| المنسق (Orchestrator) | `include_file/biz1_agent.php` ← `biz1_agent_process_turn()` |

| المنفذ (Executor) (قديم) | `application/helpers/general_helper.php` ← `creeate_mission_customer_reminder_sendmessage_with_ai()` |

| جافاسكريبت (JS) | `new/js/project-general-js/sidebarrr_newwwwwww-jquery.js` |

| يتم التحميل عبر | `config.php` يتضمن جميع ملفات الوكيل |

2. البنية

(مخطط البنية: رسالة المستخدم ← واجهة برمجة التطبيقات (API) ← المتخصصون ← توضيح أو تنفيذ.)

ترتيب التوجيه (الأسبقية للمطابقة الأولى)

1. **متخصص الأتمتة** — `biz1_agent_automation.php` إذا كانت الرسالة تبدو كأتمتة 2. **متخصص الإعدادات** — `biz1_agent_settings.php` إذا كانت الرسالة تبدو كإعدادات (للمالك/المدير فقط) 3. **الموجه العام** — يختار النية من `biz1_agent_intent_list()` 4. **المتخصص العام** — يملأ الحقول من الكتالوج؛ قد يوضح 5. **التنفيذ** — يقوم `general_helper` بتشغيل إجراء قاعدة البيانات بواسطة `answer['type']`

3. حالة الجلسة

| المفتاح | الغرض |

|-----|---------|

| `$_SESSION['biz1_agent_draft']` | النية النشطة + الحقول المجمعة `{type, fields:{}}` |

| `$_SESSION['chat_history']` | آخر ~16 دورة (محددة بواسطة `biz1_agent_cap_history`) |

تدمج اختيارات التوضيح عبر `biz1_agent_merge_selection_message()` — يختار المستخدم من القائمة المنسدلة ← `Selected: key=value [source:catalog]`.

4. كتالوج النوايا

معرف في `biz1_agent_intent_list()` (`biz1_agent.php`):

| المجال | الأنواع |

|--------|-------|

| **إدارة علاقات العملاء (CRM)** | `add_mission`, `add_customer`, `add_reminder`, `send_message`, `search_customer`, `advanced_search_customer`, `greetings` |

| **المصروفات (Expenses)** | `add_expenses`, `add_expenses_with_file` |

| **القوائم (Lists)** | `list_suppliers`, `list_categories`, `list_folders`, `list_tags`, `list_status` |

| **الغرف (Rooms)** | `room_booking`, `list_rooms`, `check_room_availability` |

| **التكوين (Config)** | `add_folder`, `update_folder`, `add_field`, `add_tabs_setting`, `add_custom_field_for_tabs_setting` |

| **الأتمتة (Automations)** | `add_automation_full`, `add_automation_event`, `add_automation_actions` |

| **الإعدادات (Settings)** | `explain_settings`, `update_settings` |

| **الحملة (Campaign)** | `add_campaign` |

| **التقارير (Reports)** | `customer_sales`, `order_created_count` |

حالات المطالبة: كتل XML في `get_full_prompt()` داخل `general_helper.php` (`<case_add_customer>`, إلخ).

5. المتخصصون (ملفات منفصلة)

5.1 الإعدادات — `biz1_agent_settings.php`

- **من:** `biz1_agent_can_manage_settings()` — مالك المنظمة أو `member_admin` - **الأمان:** `biz1_agent_settings_validate_session_context()` — يجب أن تتطابق المنظمة/المستخدم في الجلسة؛ يتم تجريد حمولة الذكاء الاصطناعي من المعرفات - **الأنماط:** شرح مقابل تحديث - **ينفذ مباشرة** — لا يستخدم `general_helper` للحفظ - **المفاتيح القابلة للتحديث:** `biz1_agent_settings_updatable_keys()` — انظر SETTINGS_MAP.md - **اللغات:** رسائل النظام بالإنجليزية / العبرية / العربية + رد الذكاء الاصطناعي بلغة المستخدم

5.2 الأتمتة — `biz1_agent_automation.php`

- **الأنواع:** `add_automation_event`, `add_automation_full`, `add_automation_actions` - **الحدث (EVENT)** = صف `automation_event` (المشغل) - **الإجراء (ACTION)** = صفوف `automation` (الخطوات) - الكتالوج: المجلدات، العلامات، المصادر، أعضاء الفريق، القوالب - ينفذ عبر مساعدي إدراج الأتمتة في `general_helper`

5.3 المجلد — `biz1_agent_folder.php`

- **`biz1_agent_execute_update_folder()`** — تحديثات جزئية للمجلد (الأعمدة، علامات التبويب، المشاركة، SMTP، العلامات) - يستخدم من الشريط الجانبي عندما يكون النوع `update_folder` / `update_folder_columns` - يثري الكتالوج: علامات التبويب، قائمة SMTP، الشركات، أعمدة لوحة القيادة

6. واجهة برمجة تطبيقات الذكاء الاصطناعي (AI API)

| الدالة | الدور |

|----------|------|

| `biz1_agent_call_ai()` | استدعاء OpenRouter / النموذج |

| `biz1_agent_parse_ai_json()` | استخراج JSON من نص النموذج |

| `biz1_agent_enrich_clarify()` | إرفاق خيارات الكتالوج بالقوائم المنسدلة |

| `biz1_agent_build_catalog()` | الفريق، المجلدات، العلامات، القوالب، الأعمدة، النوايا |

يتم تصفية XML الكتالوج لكل نية عبر `biz1_agent_catalog_xml_tags_for_type()`.

7. واجهة مستخدم التوضيح

عندما يكون `status: clarify` (أو ما يعادله في الموجه/المتخصص):

{
  "status": "clarify",
  "message": "Which folder?",
  "suggestions": [
    {
      "key": "folder_id",
      "label": "Folder",
      "source": "folder",
      "options": [{"id": "12", "name": "Leads"}]
    }
  ]
}

تعرض الواجهة الأمامية قوائم منسدلة؛ يتم إرسال اختيار المستخدم كرسالة تالية.

8. نموذج الأمان

| القاعدة | التطبيق |

|------|----------------|

| تسجيل الدخول مطلوب | `check_login()` في وحدات التحكم |

| كتابة الإعدادات | المالك أو المدير فقط؛ معرف المنظمة في الجلسة لجميع عمليات الكتابة في قاعدة البيانات |

| سياق المنظمة | يجب أن يساوي `$Org['id']` `session organizations_user_id` لوكيل الإعدادات |

| حمولة الذكاء الاصطناعي | لا تثق أبدًا بـ `user_id`, `org_id`, `owner_id` من JSON — يتم تجريدها قبل الكتابة |

| إجراءات CRM في الشريط الجانبي | تُشغل كمستخدم مسجل الدخول؛ المنظمة من الجلسة عبر أنماط المساعد الموجودة |

9. اللغات (الإنجليزية / العبرية / العربية)