SupportRetriever LogoSupportRetrieverתמיכת לקוחות בסיוע AI

הגדרת MCP (Model Context Protocol)

אופציונלי: חבר endpoint של MCP כדי ש-AI Companion יוכל לשלוף הקשר נוסף (למשל נתוני משתמש, מידע חשבון) בעת יצירת הצעות תשובה. אתה מספק כתובת URL, סוד לאימות וסכמת JSON שמתארת את ה-body שה-endpoint שלך מצפה לו.

מהו MCP?

MCP (Model Context Protocol) מאפשר לחשוף endpoint של HTTPS שמחזיר נתונים ל-AI. כשמעבדים הודעת לקוח, SupportRetriever יכול לקרוא ל-endpoint שלך עם JSON body (במבנה לפי הסכמה שלך) ולהשתמש בתשובה להעשרת ההצעות. שימושים טיפוסיים:

  • חיפוש נתוני לקוח או חשבון לפי אימייל או מזהה
  • שליפת מידע על מנוי או שימוש
  • משיכת נתונים מה-backend או ה-CRM שלך

מפתח הסוד נשמר מוצפן ולעולם לא מוחזר. רק ה-URL, הסכמה (body) ומפת השדות נשמרים בצורה גלויה.

מתי להשתמש ב-MCP

השתמש ב-MCP כאשר:

  • אתה רוצה שה-AI יקבל גישה לנתונים שלא בבסיס הידע (למשל נתונים לפי משתמש או לפי חשבון).
  • הנתונים נמצאים מאחורי API שבשליטתך ואפשר לחשוף אותו דרך HTTPS עם סוד משותף.

אפשר להשתמש גם בכתובת בסיס ידע וגם ב-MCP יחד: בסיס הידע מספק תיעוד כללי, ו-MCP מספק הקשר ספציפי לבקשה.

הגדרת MCP

  1. עבור להגדרות AI Companion והרחב את סעיף MCP (לחץ עריכה ליד MCP אם הוא מקופל).
  2. הזן את ה-URL שלך (חייב HTTPS), למשל https://api.example.com/mcp.
  3. הזן את מפתח הסוד (משמש לאימות בקשות ל-endpoint שלך). הוא מוצפן לפני האחסון. השאר את השדה ריק בעת עריכה אם אינך רוצה לשנות את הסוד הקיים.
  4. הזן את Body כסכמת JSON שמתארת את ה-payload שה-endpoint מצפה לו (למשל JSON Schema עם אובייקט properties ברמה העליונה).
  5. אם בסכמה יש properties, מופיעה טבלת Field mapping. לכל property בחר מאיפה מגיע הערך:
    • לקוח name – משדה השם ב-submission
    • לקוח email – משדה האימייל ב-submission
    • Metadata key – ממתadata של שליחת הטופס (למשל פרמטרי URL כמו ?userId=123); הזן את שם מפתח ה-metadata (למשל userId).
  6. לחץ שמירה לשמירת ההגדרה, או הסר MCP לאיפוס.

URL ו-Secret

  • URL: חייב להיות כתובת HTTPS תקינה. SupportRetriever ישלח בקשה לכתובת הזו כשנדרש הקשר (יישום הקריאה בפועל מטופל על ידי המוצר; המאמר מתאר רק הגדרה).
  • מפתח סוד: נשמר מוצפן. השתמש בו בשרת שלך כדי לוודא שבקשות מגיעות מ-SupportRetriever (למשל דרך header או חתימה). אל תשתף אותו; החלף אותו אם נחשף.

Body (JSON Schema)

ה-Body צריך להיות סכמת JSON שמגדירה את מבנה ה-request body שנשלח ל-endpoint. לדוגמה:

{
  "type": "object",
  "properties": {
    "uid": { "type": "string", "description": "Firebase UID" },
    "emails": {
      "type": "array",
      "items": { "type": "string", "format": "email" },
      "maxItems": 10,
      "description": "Look up by email(s)"
    }
  }
}

לאחר הדבקת סכמה תקינה עם אובייקט properties ברמה העליונה, הממשק מציג טבלת Field mapping כדי למפות כל property למקור נתונים (שם לקוח, אימייל לקוח או מפתח metadata).

Field Mapping

המיפוי מחבר כל property בסכמה למקור הערך בזמן הבקשה:

  • לקוח name – ערך משדה השם ב-submission של הטופס.
  • לקוח email – ערך משדה האימייל ב-submission של הטופס.
  • Metadata key – ערך ממתadata של ה-submission (למשל מפרמטרי URL כשהטופס נפתח). הזן את שם המפתח המדויק (למשל userId, campaign).

עבור properties מסוג מערך או אובייקט, הערך הממופה עדיין מקור יחיד (למשל מפתח metadata אחד או אימייל); איך בונים את ה-body הסופי נקבע על ידי המוצר כשהוא קורא ל-endpoint.

הסרת MCP

בסעיף MCP לחץ הסר MCP. זה מאפס את ה-URL, הסוד, ה-body והמיפויים. הגדרות AI Companion ובסיס הידע לא משתנות.

נושאים קשורים

מוכנים לפשט את התמיכה?
הצטרפו לאלפים שמשתמשים ב-SupportRetriever לניהול שיחות עם לקוחות.
נסה חינם

גלה עוד

עיין בכל המאמרים