שילוב עם Wagtail
עוזר בינה מלאכותית שעונה על שאלות באתר Wagtail שלך
סקירה כללית
חבילת Wagtail מציבה עוזר בינה מלאכותית באתר שלך. כפתור צ'אט יושב בפינה של כל עמוד, המבקרים שואלים במילים שלהם, והתשובה מגיעה מהתוכן שלך: האתר שלך, המסמכים שהעלית ומאמרי העזרה שלך.
הבהרה לגבי בינה מלאכותית: התשובות באתר שלך נוצרות על ידי בינה מלאכותית. לפעמים הן עלולות להיות שגויות או חלקיות. בדוק אותן לפני שאתה מסתמך עליהן, במיוחד בהחלטות חשובות.
איך זה עובד
החבילה מוסיפה תוכנת ביניים שמציבה סקריפט קטן אחד ממש לפני תגית הסגירה body של כל עמוד. הסקריפט ממתין שהעמוד יסיים להיטען ואז מביא את רכיב הצ'אט מ-Asyntai, כך שהאתר שלך מצויר קודם ומהירות העמוד לא משתנה. השרת שלך לעולם אינו מדבר עם Asyntai; רק הדפדפן של המבקר עושה זאת.
אינך משנה דבר בתבניות שלך. תוכנת הביניים משאירה את ממשק הניהול של Wagtail בשקט, ומשאירה בשקט כל דבר שאינו עמוד HTML.
דרישות
- חשבון Asyntai. התוכנית החינמית מספיקה כדי להתחיל.
- אתר Wagtail בגרסה 5.2 או חדשה יותר, על Django 4.2 או חדש יותר ו-Python 3.9 או חדש יותר.
- גישה לקוד של אותו אתר, כי אתה מתקין חבילת Python.
התקנה
בצע את השלבים האלה כדי להוסיף את Asyntai לאתר Wagtail שלך:
התקן את החבילה
התקן אותה מ-Python Package Index, באותה סביבה שבה רץ האתר שלך:
pip install wagtail-ai-chatbot
הוסף אותה להגדרות
הוסף את היישום ואת מודול ההגדרות של Wagtail ל-INSTALLED_APPS, ואת תוכנת הביניים בראש MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
הרץ את המיגרציה
היא יוצרת את הטבלה ששומרת את ההגדרות שלך:
python manage.py migrate wagtail_asyntai
הדביקו את מזהה הווידג'ט
בממשק הניהול של Wagtail פתח את Settings ואחר כך את Asyntai chat assistant. הדבק את מזהה הווידג'ט ובחר Save. את המזהה תמצא בלוח הבקרה של Asyntai תחת Setup & Integration. אפשר להדביק את כל קטע הקוד; החבילה שומרת רק את המזהה.
טיפ: הוסיפו את המסמכים שלכם, השאלות והתשובות שלכם וההנחיות שלכם בלוח הבקרה של Asyntai לפני הפרסום, כדי שהעוזר יענה נכון כבר למבקר הראשון.
הגדרות
- מזהה הווידג'ט: הצ'אט פועל כל עוד בשדה הזה יש מזהה תקין, וכבוי כשהשדה ריק.
- הצג את הצ'אט רק למבקרים שאינם מחוברים: משתמשים מחוברים לעולם אינם רואים את הצ'אט. שימושי כשהעוזר נועד למי שעדיין לא נרשם.
- כתובת סקריפט הווידג'ט: השאר את הערך כפי שהוא, אלא אם התמיכה של Asyntai מבקשת ממך לשנות אותו.
ההגדרות הן לכל אתר בנפרד, כך שפרויקט המשרת כמה אתרים מהתקנת Wagtail אחת יכול לתת לכל אתר עוזר משלו.
הגדרות בקובץ ההגדרות שלך
פרויקט ששומר את התצורה במשתני סביבה יכול לדלג על ממשק הניהול ולקבוע את הערכים בקוד. אם שניהם מלאים, ממשק הניהול מנצח.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
שלושה ערכים נוספים אינם חובה: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL ו-ASYNTAI_SKIP_PREFIXES. האחרון מונה את הנתיבים שהווידג'ט לעולם אינו נוגע בהם, ואתה זקוק לו כשממשק הניהול שלך אינו ב-/admin/.
הצבת הווידג'ט ביד
אם אתה מעדיף לבחור את המקום בעצמך, ותר על תוכנת הביניים ושים את התגית בתבנית הבסיס שלך. התגית ותוכנת הביניים לעולם אינן פועלות שתיהן, לכן אפשר להשאיר את שתיהן.
{% load asyntai %} ... {% asyntai_widget %}
מה העוזר יודע לעשות
- לענות על שאלות המבקרים מיד, מסביב לשעון, בכל עמוד
- לענות ביותר מ־80 שפות, שמזוהות אוטומטית מתוך השאלה
- להישאר פתוח בזמן שהמבקר עובר מעמוד לעמוד
- להשתמש במסמכים שהעליתם, בשאלות הנפוצות ובהנחיות שלכם כדי לענות במדויק
פרטיות
החבילה מפרסמת בעמוד בדיוק שני ערכים: מזהה הווידג'ט וכתובת הסקריפט. שום דבר על העמודים שלך או על המשתמשים שלך אינו נשלח ל-Asyntai. רק הדפדפן של המבקר מדבר עם Asyntai, ורק כשהמבקר פותח את הצ'אט.
תוכניות ומחירים
השילוב עם Wagtail זמין בכל התוכניות של Asyntai, גם בתוכנית החינמית. כל תוכנית כוללת מכסת הודעות חודשית משותפת לכל הערוצים והשילובים שלך. צפה במחירים.
הסרה
רוקן את שדה מזהה הווידג'ט כדי לכבות את הצ'אט. כדי להסיר את החבילה, הוצא את תוכנת הביניים ואת היישום מההגדרות והסר אותה עם pip.
קוד מקור
החבילה חופשית ובקוד פתוח, ברישיון MIT. אפשר לקרוא כל שורה בGitHub.
צריך עזרה?
אם יש לך שאלות או שנתקלת בבעיות, צור קשר איתנו ב-[email protected].