Archived

This repository has been archived on 2026-07-19. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

T

chaim 0dc26f3b15 feat: SmartAssistant v2.4.0 — create_call tool + behavioral rules system

- Add create_call tool: records phone calls as Call entity (not Meeting)
- Add AssistantRule entity: persistent behavioral rules the AI follows
- Add save_rule tool: AI can save new rules when user requests them
- Add systemInstructions to webhook: call vs meeting guidance, open question tracking
- Add recentCalls to case context for AI awareness
- Add AssistantRuleContextProvider: injects active rules per mode into context

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-06 06:20:23 +00:00

5.1 KiB

Raw Permalink Blame History

SmartAssistant — פרומפט פריסה לסביבת פיתוח

העתק את הפרומפט הבא כהודעה פותחת בשיחה חדשה של Claude Code, מתוך תיקיית הפרויקט.

## הקשר

אני עובד על הרחבת SmartAssistant ל-EspoCRM — עוזר AI צף למשרד עורכי דין.
הקוד מוכן (v1.0.3), וצריך להשלים את הפריסה בסביבת הפיתוח.

קרא את DEPLOYMENT_REVIEW.md לסיכום מלא של מה בוצע, מה נבדק, ומה נשאר.

## סביבת הפיתוח

- EspoCRM Dev: https://espocrm.dev.marcus-law.co.il (Coolify UUID: c591uqmu49qa5kh7t2z7a2mp)
- n8n: https://n8n.dev.marcus-law.co.il
- Gitea: https://gitea.dev.marcus-law.co.il (repo: espocrm-extensions/SmartAssistant)
- קרדנשיאלים ב-Infisical (תיקיות /espocrm, /n8n)

## המשימות — שלב 1: הכנה לפריסה

בצע את המשימות הבאות בסדר. לפני כל שלב — עדכן אותי מה אתה הולך לעשות וחכה לאישור.

### 1. בדיקת תאימות סביבה
- בדוק גרסת EspoCRM בסביבת dev (צריך >= 8.0.0)
- בדוק גרסת PHP (צריך >= 8.1)
- בדוק שאין שאריות של מודולים ישנים (CrmAssistant / OfficeAssistant הוסרו מהפרויקט)

### 2. בדיקת אנטיטי AssistantConversation
- המודול משתמש באנטיטי AssistantConversation לשמירת שיחות (ראה ConversationRepository.php)
- בדוק אם האנטיטי הזה קיים ב-EspoCRM Dev
- אם לא קיים — צריך ליצור אותו. בדוק את הקוד ב-ConversationRepository.php כדי להבין אילו שדות נדרשים, והכן entityDefs JSON

### 3. בניית n8n Workflow לטיפול בצ'אט
זה הרכיב הקריטי החסר. המודול שולח webhook ל-n8n ומצפה לתשובה.

**Webhook Payload (נשלח מ-EspoCRM):**
```json
{
  "message": "הודעת המשתמש",
  "context": { ... הקשר תיק/משרד מלא ... },
  "conversationId": "conv_xxx",
  "conversationHistory": [{ "role": "user/assistant", "content": "..." }],
  "mode": "office|case"
}

Response נדרש (חזרה ל-EspoCRM):

{
  "text": "תשובת העוזר",
  "actions": [
    {
      "tool": "create_task|add_note|change_status|create_meeting|schedule_hearing|list_documents|analyze_document|save_memory|rename_document",
      "params": { ... },
      "actionId": "action_xxx",
      "displayText": "תיאור הפעולה למשתמש"
    }
  ]
}

הפעולות שהעוזר יכול לבקש:

כלי	פרמטרים	דורש אישור
create_task	name, dateEnd, priority, description	כן
add_note	text	כן
change_status	status	כן
create_meeting	name, dateStart, dateEnd, description	כן
create_call	name, dateStart, dateEnd, description, direction, status	כן
schedule_hearing	date, description	כן
list_documents	—	לא (מיידי)
analyze_document	documentId	כן
save_memory	name, content, category, importance	לא (מיידי)
save_rule	name, rule, scope (global/case/office)	לא (מיידי)
rename_document	documentId, newName	כן

דרישות ל-Workflow:

Webhook trigger שמקבל POST
שליחת ההודעה + הקשר ל-LLM (Claude/GPT)
System prompt שמכיר את הכלים הזמינים ואת פורמט התשובה
החזרת JSON תקין בפורמט למעלה
שמירת היסטוריית שיחה (conversationId)
טיפול בשני המצבים (office/case) עם system prompts מתאימים

4. הגדרת Integration ב-EspoCRM

אחרי שה-workflow מוכן:

Admin > Integrations > Smart Assistant
webhookUrl = כתובת ה-webhook מ-n8n
apiKey = מפתח אימות (אם הגדרנו)
שאר הערכים: ברירת מחדל

5. בדיקות ידניות ראשונות

אחרי הפריסה:

האם ה-FAB (כפתור צ'אט) מופיע?
האם ניתן לשלוח הודעה במצב משרד ולקבל תשובה?
האם ניתן לנווט לתיק ולשלוח הודעה במצב תיק?
האם פעולות מוצגות לאישור?
האם ההתראות מופיעות ב-navbar?
האם הדשלט מציג נתונים?

הנחיות

השתמש ב-MCP tools (Coolify, Gitea, n8n, Infisical) לכל פעולה
אל תבצע פעולות הרסניות בלי אישור שלי
אם נתקלת בבעיה — תאר מה קרה ומה ניסית, ותשאל מה לעשות
עדכן את DEPLOYMENT_REVIEW.md עם כל ממצא חדש


---

## הערות שימוש

- **היכן להריץ:** בתיקיית `/home/chaim/espocrm-extensions/SmartAssistant`
- **MCP נדרשים:** coolify-dev, gitea-dev, n8n-dev, infisical
- **משך משוער:** השלב הקריטי הוא בניית ה-n8n workflow (#3) — זה ידרוש עיצוב system prompts ובדיקות
- **מה הפרומפט לא כולל:** הסרת מודולים ישנים (תלוי בממצאי שלב 1), הוספת תרגום he_IL (שיפור עתידי)

5.1 KiB Raw Permalink Blame History

SmartAssistant — פרומפט פריסה לסביבת פיתוח

4. הגדרת Integration ב-EspoCRM

5. בדיקות ידניות ראשונות

הנחיות

5.1 KiB

Raw Permalink Blame History