וידג

הוסיפו סוכן AI קולי לכל אתר באמצעות כמה שורות קוד

רכיב הווידג'ט הקולי המוטמע של ThunderPhone מאפשר למבקרים באתר שלכם לדבר עם סוכן AI ישירות מהדפדפן. אין צורך בשיחת טלפון -- המשתמשים לוחצים על לחצן ומתחילים שיחה קולית בזמן אמת המופעלת באמצעות ThunderPhone.

הווידג'ט מוצג כסרגל במראה זכוכית המותאם לערכות נושא בהירות וכהות, עם צבעי הדגשה ומיקום הניתנים להתאמה אישית. הוא מופץ כחבילת npm @thunderphone/widget וזמין גם דרך CDN עבור סביבות ללא מאגד מודולים.

ווידג'ט ThunderPhone בערכות נושא בהירות וכהות עם מגוון צבעי הדגשה

דרישות מקדימות

לפני הטמעת הווידג'ט, השלימו את שלושת השלבים הבאים ב-לוח הבקרה של ThunderPhone:

צרו מפתח API שניתן לפרסום
עברו אל מפתחים בהגדרות לוח הבקרה וצרו מפתח שניתן לפרסום. מפתחות שניתנים לפרסום מתחילים ב-pk_live_ ובטוחים לשילוב בקוד בצד הלקוח.
הגדירו דומיינים מורשים
באותן הגדרות מפתחים, הוסיפו את הדומיינים שבהם הווידג'ט יוטמע. localhost מורשה תמיד לצורכי פיתוח. תווים כלליים נתמכים (לדוגמה, *.example.com).
צרו ווידג'ט Web
עברו אל ווידג'טים של Web בלוח הבקרה וצרו ווידג'ט. בחרו את הסוכן שברצונכם לחשוף ואת המפתח שניתן לפרסום שבו תרצו להשתמש. הסוכן נפתר אוטומטית מתצורת המפתח שניתן לפרסום.

התחלה מהירה

התקינו את החבילה:

npm install @thunderphone/widget

הוסיפו את הווידג'ט לאפליקציה שלכם:

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function App() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      theme="dark"
      primaryColor="#8b5cf6"
    />
  )
}

זה הכול. המשתמשים שלכם יראו סרגל שיחה במראה זכוכית שמחבר אותם לסוכן ה-AI שלכם בלחיצה אחת.

התאמה אישית

לווידג'ט יש ארבעה מאפייני מראה:

מאפיין	ברירת מחדל	תיאור
`theme`	`'light'`	`'light'` עבור זכוכית לבנה, `'dark'` עבור זכוכית כהה
`primaryColor`	`'#000000'` (בהיר) / `'#ffffff'` (כהה)	צבע הדגשה ללחצן ההתחלה, לצורת הגל ולמחוון ההתחברות
`title`	`'Voice assistant'`	הטקסט שמוצג בווידג'ט
`position`	`'bottom-right'`	פינת חלון התצוגה: `'bottom-right'`, `'bottom-left'`, `'top-right'`, `'top-left'`

Light theme (default)

<ThunderPhoneWidget
  publishableKey="pk_live_your_publishable_key"
/>

Dark theme with custom color

<ThunderPhoneWidget
  publishableKey="pk_live_your_publishable_key"
  theme="dark"
  primaryColor="#8b5cf6"
  title="Ask our AI"
/>

שלושה מאפיינים נוספים מתאימים את ההפעלה במקום את המראה -- כולם מועברים לבקשת ההפעלה כאשר מתחילה שיחה:

מאפיין	תיאור
`language`	דריסת שפה לכל הפעלה -- קוד או אזור כגון `en`, `es` או `fr-FR`
`voice`	דריסת קול לכל הפעלה -- שם קול כגון `maria`
`context`	הקשר עובדתי של הדף או האתר שמועבר לסוכן (מקוצר בצד השרת ל-12,000 תווים)

עיינו ב-הפניה לרכיב React לקבלת טבלת המאפיינים המלאה.

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

אפשרויות שילוב

בחרו את שיטת השילוב המתאימה למערך שלכם:

רכיב React

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

Hook ללא ממשק

שליטה מלאה בממשק המשתמש. ה-Hook useThunderPhone מנהל את סשן הקול בזמן שאתם בונים ממשק משלכם.

CDN / תגית Script

אין צורך ב-bundler. טענו את הווידג'ט באמצעות תגית script עבור אתרים סטטיים, WordPress וסביבות אחרות שאינן React.

עיצוב

הווידג'ט כולל ערכות נושא בהירות וכהות מובנות, הנשלטות באמצעות המאפיין theme, וצבע הדגשה הנשלט באמצעות המאפיין primaryColor. להתאמה אישית מעמיקה יותר, תוכלו לדרוס מאפיינים מותאמים אישית ומחלקות CSS. לפרטים, עיינו במדריך העיצוב.

וידג

דרישות מקדימות#

התחלה מהירה#

התאמה אישית#

אפשרויות שילוב#

עיצוב#