SmartAssistant — עוזר AI למשרד
גרסה: 2.10.5 | מחבר: klear | EspoCRM: >= 8.0.0
תיאור
עוזר AI מאוחד למשרד עורכי דין. צ'אט צף עם שני מצבי עבודה: מצב משרד (סקירה כללית, התראות, סטטיסטיקות) ומצב תיק (סיוע מעמיק בתיק ספציפי). כולל זיכרון תיק מובנה, ביצוע פעולות באישור המשתמש, התראות משרד (תיקים לא פעילים, משימות באיחור, דיונים קרובים), ואינטגרציה עם ה‑Stream של התיק.
תלויות
- שירות ה‑AI (shira‑hermes) — נדרש; העוזר מדבר איתו דרך Webhook. בלעדיו הצ'אט אינו פעיל.
- NetworkStorageIntegration — נדרש לניתוח וקריאת מסמכי התיק.
- הערה: אם מותקנת גם KnowledgeBase, היא משתמשת בהגדרות האינטגרציה של SmartAssistant — אין להסיר את SmartAssistant כל עוד KnowledgeBase מותקנת.
התקנה
- הורד את
SmartAssistant-2.10.5.zipוהתקן דרך ניהול → הרחבות. - בניהול → אינטגרציות → Smart Assistant הזן את כתובת ה‑Webhook, מפתח ה‑API, ומפתח ה‑API של EspoCRM.
- בצע Rebuild ורענון קשיח.
הגדרות
| הגדרה | תיאור |
|---|---|
| webhookUrl | כתובת שירות ה‑AI (shira‑hermes). |
| apiKey | מפתח אימות מול שירות ה‑AI. |
| espocrmApiKey | מפתח API שבו שירות ה‑AI חוזר לפנות ל‑EspoCRM (מומלץ לשייך למשתמש API עם הרשאות מצומצמות). |
| ספי התראה | ימי חוסר‑פעילות לאזהרה/קריטי, חלון דיונים קרובים. |
מה מתווסף למערכת
- כפתור צ'אט צף בכל מסך, עם היסטוריית שיחות ועיון בזיכרון התיק.
- זיכרון תיק (CaseMemory): מאגר ידע מובנה לכל תיק (עובדות מפתח, אסטרטגיה, החלטות, ציר זמן ועוד) — נשמר ידנית, ע"י העוזר, או אוטומטית בשינויי תיק.
- דשבורד התראות ותצוגות SmartRequest/SmartResponse/SmartAction בציר הזמן של התיק.
- ניהול מהממשק: עריכת פרומפטים, כללי התנהגות, מיומנויות ופרופילי משתמש.
טיפול בעיות נפוצות
| תסמין | סיבה | פתרון |
|---|---|---|
| הצ'אט לא מגיב | שירות ה‑AI לא מוגדר/לא זמין | בדוק את webhookUrl ושהשירות (shira‑hermes) רץ. |
| KnowledgeBase מפסיקה לעבוד | הוסרה/בוטלה אינטגרציית SmartAssistant | החזר את אינטגרציית SmartAssistant — KnowledgeBase תלויה בה. |
| ניתוח מסמכים נכשל | NetworkStorageIntegration לא מותקן | התקן את NetworkStorageIntegration. |
הרשאות
העוזר פועל בגבולות ההרשאות של המשתמש: כל פעולה, קריאת מסמך, זיכרון תיק או "צלילה" לתיק במצב משרד מתבצעת רק על תיקים שהמשתמש מורשה לגשת אליהם, וקריאת מסמכים מוגבלת לתיקיית התיק הרלוונטי בלבד. יצירת כללי עוזר (כללים החלים על כל המשרד) שמורה למנהל מערכת.
תיעוד טכני למפתחים (שירותים, פעולות, hooks, זרימת ה‑webhook):
ARCHITECTURE.md.