Biz1 סוכן AI בסרגל הצד — מדריך מלא

עודכן לאחרונה: 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 (legacy) | `application/helpers/general_helper.php` → `creeate_mission_customer_reminder_sendmessage_with_ai()` |

| JS | `new/js/project-general-js/sidebarrr_newwwwwww-jquery.js` |

| Loaded via | `config.php` כולל את כל קבצי הסוכן |

2. ארכיטקטורה

(תרשים ארכיטקטורה: הודעת משתמש ← API ← מומחים ← הבהרה או ביצוע.)

סדר ניתוב (ההתאמה הראשונה מנצחת)

1. **מומחה אוטומציה** — `biz1_agent_automation.php` אם ההודעה נראית כאוטומציה 2. **מומחה הגדרות** — `biz1_agent_settings.php` אם ההודעה נראית כהגדרות (בעלים/מנהל בלבד) 3. **נתב כללי** — בוחר כוונה מתוך `biz1_agent_intent_list()` 4. **מומחה כללי** — ממלא שדות מהקטלוג; עשוי להבהיר 5. **ביצוע** — `general_helper` מפעיל פעולת DB לפי `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` |

| **הוצאות** | `add_expenses`, `add_expenses_with_file` |

| **רשימות** | `list_suppliers`, `list_categories`, `list_folders`, `list_tags`, `list_status` |

| **חדרים** | `room_booking`, `list_rooms`, `check_room_availability` |

| **תצורה** | `add_folder`, `update_folder`, `add_field`, `add_tabs_setting`, `add_custom_field_for_tabs_setting` |

| **אוטומציות** | `add_automation_full`, `add_automation_event`, `add_automation_actions` |

| **הגדרות** | `explain_settings`, `update_settings` |

| **קמפיין** | `add_campaign` |

| **דוחות** | `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()` — ארגון/משתמש בסשן חייבים להתאים; מטען AI מנוקה מזהויות - **מצבים:** הסבר מול עדכון - **מבצע באופן מובנה** — אינו משתמש ב- `general_helper` לשמירות - **מפתחות ניתנים לעדכון:** `biz1_agent_settings_updatable_keys()` — ראה SETTINGS_MAP.md - **שפות:** הודעות מערכת EN / HE / AR + תגובת AI בשפת המשתמש

5.2 אוטומציה — `biz1_agent_automation.php`

- **סוגים:** `add_automation_event`, `add_automation_full`, `add_automation_actions` - **אירוע** = שורת `automation_event` (טריגר) - **פעולה** = שורות `automation` (שלבים) - קטלוג: תיקיות, תגיות, מקורות, חברי צוות, תבניות - מבצע באמצעות עוזרי הוספת אוטומציה ב- `general_helper`

5.3 תיקייה — `biz1_agent_folder.php`

- **`biz1_agent_execute_update_folder()`** — עדכוני תיקייה חלקיים (עמודות, לשוניות, שיתוף, SMTP, תגיות) - בשימוש מסרגל הצד כאשר הסוג הוא `update_folder` / `update_folder_columns` - מעשיר קטלוג: לשוניות, רשימת SMTP, חברות, עמודות לוח מחוונים

6. API של AI

| פונקציה | תפקיד |

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

| `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()` בבקרים |

| כתיבות הגדרות | בעלים או מנהל בלבד; מזהה ארגון סשן לכל כתיבות ה-DB |

| הקשר ארגוני | `$Org['id']` חייב להיות שווה ל-`session organizations_user_id` עבור סוכן ההגדרות |

| מטען AI | לעולם אל תבטח ב-`user_id`, `org_id`, `owner_id` מ-JSON — מנוקה לפני כתיבה |

| פעולות CRM בסרגל הצד | מופעל כמשתמש מחובר; ארגון מהסשן באמצעות תבניות עוזר קיימות |

9. שפות (EN / HE / AR)