מדריך פתרון בעיות

תיעוד / פתרון בעיות

התקלות שבאמת צצות בהתקנה ראשונה, בסדר שבו סביר שתיתקלו בהן.

מתחילים כאן

רוב הדיווחים על “זה לא עובד” מסתכמים באחד מארבעה דברים. בדקו אותם בסדר הזה. זה לוקח שתי דקות ובדרך כלל סוגר את העניין:

  1. האם מפתח ה-AI תקין?

    AI Chatbot → AI Providers → לחצו על Test ליד מפתח ה-API.

  2. האם סכימת מסד הנתונים נוצרה?

    AI Chatbot → RAG & Search → Check Status אמור להציג Schema is ready.

  3. האם הקטלוג מאונדקס?

    באותו מסך, Total Products ו-Indexed אמורים להיות זהים.

  4. האם הרישיון פעיל?

    AI Chatbot → License & Updates אמור להציג תג ירוק License Active.

הווידג’ט

ווידג’ט הצ’אט לא מופיע באתר

  • בדקו ב-Appearance. אפשר לכבות את הווידג’ט לגמרי, או להסתיר אותו בנפרד בדסקטופ או במובייל.
  • בדקו אם העמוד הנוכחי נמצא ברשימת העמודים המוחרגים.
  • נקו את תוסף המטמון ואת ה-CDN. עמוד HTML שנשמר במטמון ימשיך להיות מוגש בלי הווידג’ט.
  • פתחו את קונסולת הדפדפן (F12) וחפשו שגיאות JavaScript מתוספים אחרים. סקריפט שבור אחד יכול לעצור את כל מה שרץ אחריו.

הווידג’ט מופיע אבל שליחת הודעה לא עושה כלום

כמעט תמיד מדובר במפתח ה-AI. בדקו אותו במסך AI Providers. אם הבדיקה עוברת, פתחו את Logs ושלחו הודעה נוספת; התקלה תתועד שם.

הווידג’ט נראה שבור במובייל

בדקו ב-Appearance את האפשרויות הייעודיות למובייל, ונקו מטמון אחרי כל שינוי, כי העיצוב מוגש יחד עם קובצי התוסף.

ספק ה-AI

“Test” נכשל על מפתח שיצרתם זה עתה

  • Gemini: ודאו שהמפתח נוצר לאחרונה ב-Google AI Studio ולא נלקח מפרויקט ישן. מפתחות “standard” ישנים מוצאים משימוש ויפסיקו לעבוד לגמרי בספטמבר 2026.
  • OpenAI: החשבון צריך אמצעי תשלום ויתרה לפני שה-API עונה בכלל.
  • בדקו שאין רווחים מיותרים בתחילת הערך שהודבק או בסופו.

התשובות איטיות

עברו למודל מהיר יותר במסך AI Providers. בדקו ב-Logs אם יש ניסיונות חוזרים או מעברים לגיבוי, שמכפילים את זמן התגובה.

הבוט מתעלם מההוראות שלכם

העבירו את ההוראה ל-Custom Rules (מסך AI Providers). כללים גוברים גם על הודעת הפתיחה וגם על מסך Context.

הבוט ממציא מוצרים או פרטים

זה אומר שהוא עונה בלי הקטלוג שלכם. עברו על מקטע ה-RAG למטה: סכימה, אינדוקס וסוג המפתח.

RAG ו-Supabase

האינדוקס רץ אבל שום דבר לא נשמר

מפתח שגוי. מפתח publishable או anon ישן יכול לקרוא אבל לא לכתוב, ולכן האינדוקס לא יוצר כלום בשקט. השתמשו במפתח ה-secret (sb_secret_…) או במפתח service_role הישן. השדה במסך RAG מסומן Service Role Key (not anon key) בדיוק מהסיבה הזו.

הסטטוס לא הופך ל-“Schema is ready”

  • ודאו שהחלפתם את [YOUR-PASSWORD] במחרוזת החיבור בסיסמת מסד הנתונים האמיתית.
  • אם הסטטוס מציג Manual setup required, חברת האחסון חוסמת חיבורי PostgreSQL ישירים. השתמשו ב-Copy SQL והריצו את הסקריפט ב-SQL Editor של Supabase. התוצאה זהה.

“Test Connection” נכשל

  • בדקו שאין שגיאת הקלדה ב-Project URL; הוא חייב לכלול https://.
  • פרויקטים חינמיים ב-Supabase מושהים אחרי חוסר פעילות ממושך. פתחו את לוח הבקרה והפעילו את הפרויקט מחדש.
  • ודאו שהשרת שלכם יכול ליצור חיבורי HTTPS יוצאים.

הבוט לא מוצא כלום אחרי העברת האתר

המידע המאונדקס מתויג לפי הדומיין כדי שכמה חנויות יוכלו לחלוק פרויקט Supabase אחד. אחרי כל שינוי דומיין, כולל מעבר מסביבת בדיקות לאתר החי, הריצו שוב Re-index Products.

איכות החיפוש ירדה פתאום

אם מודל ההטמעה הוחלף, הוקטורים הישנים אינם ברי-השוואה לחדשים. הריצו אינדוקס מלא מחדש.

לקוחות לא מוצאים מוצרים שקיימים בבירור

הורידו את Similarity Threshold מ-0.7 לכ-0.6. אם דווקא מוחזרים פריטים קשורים באופן רופף, העלו ל-0.8.

רישיון

הרישיון לא מופעל

  • בדקו שאין רווחים מיותרים במפתח.
  • כל רישיון מכסה מספר מוגבל של דומיינים. אם עברתם אתר, פתחו קודם את האתר הישן ולחצו Deactivate License.
  • לחצו על Revalidate כדי לאלץ בדיקה מחודשת.

הרישיון מציג דומיין שגוי

הרישיון נקשר לדומיין שבו הופעל. בטלו אותו שם, ואז הפעילו מחדש בדומיין הנוכחי.

קריאת היומנים

המסך AI Chatbot → Logs הוא הדרך המהירה ביותר לראות מה באמת קרה בהודעה האחרונה: באיזה ספק נעשה שימוש, האם הופעל גיבוי, האם רצה קריאת כלי, וכל שגיאה שהספק החזיר.

כדי לתעד יותר פרטים ברמת WordPress, הוסיפו ל-wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

השגיאות ייכתבו אז ל-wp-content/debug.log. כבו את זה בחזרה אחרי שהבעיה נפתרה; יומן דיבאג גדל מהר בחנות עמוסה.

דרישות שרת

אם ההתנהגות לא יציבה במקום שבורה באופן עקבי, ודאו את הבסיס:

  • PHP 8.1 ומעלה
  • WooCommerce 8.0 ומעלה, פעיל
  • מגבלת זיכרון PHP של 128MB לפחות, מומלץ 256MB
  • חיבורי HTTPS יוצאים מותרים, כדי שהאתר יוכל להגיע לספק ה-AI ול-Supabase
Previousשאלות נפוצות