Container V2

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

Usage

מייבאים את המודול לדף ה-HTML באמצעות הקוד הבא:

<script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

מטמיעים את המודול באמצעות התג הבא:

<agent-assist-ui-modules-v2>

מחבר מודול ממשק משתמש

בשונה מ-V1, ב-V2 צריך לאתחל את מחבר מודול ממשק המשתמש בנפרד. הפרדה של המחבר מהכלי המכיל מאפשרת גמישות רבה יותר בשילוב. הוראות להגדרה זמינות במאמר UI modules connector. הרבה מהמאפיינים במאגר התגים V1 רלוונטיים רק למחבר של מודול ממשק המשתמש.

התאמה לשוק המקומי

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

דוגמה ליפנית:

<script src="https://www.gstatic.com/agent-assist-ui-modules/ja/v2/container.js"></script>

אם לא מצוין לוקאל, ברירת המחדל של הקונטיינר היא אנגלית (en), והוא נטען מנתיב הבסיס: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

לוקאלים נתמכים:

• ערבית (ar)
• סינית (פשוטה) (zh_cn)
• קרואטית (hr)
• אנגלית (אוסטרליה) (en_au)
• אנגלית (קנדה) (en_ca)
• אנגלית (בריטניה) (en_gb)
• פיליפינית (fil)
• צרפתית (fr)
• צרפתית (קנדה) (fr_ca)
• גרמנית (de)
• הינדי (hi)
• הונגרית (hu)
• איטלקית (it)
• יפנית (ja)
• קוריאנית (ko)
• מלאית (ms)
• נורווגית (no)
• פולנית (pl)
• פורטוגזית (ברזיל) (pt_br)
• רומנית (ro)
• רוסית (ru)
• ספרדית (es)
• שוודית (sv)
• תאילנדית (th)
• טורקית (tr)
• וייטנאמית (vi)

מאפיינים

מאפיינים הם מאפייני רכיבים מבוססי-מחרוזת שאפשר להגדיר ב-HTML או באמצעות setAttribute() ב-JavaScript.

שם המאפיין	סוג	תגובה
מאפיינים	מחרוזת	רשימה מופרדת בפסיקים של מפתחות של תכונות הצעות ב-Agent Assist לעיבוד. רשימה נתמכת: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. המערכת מתעלמת מהמדיניות הזו אם הערך של use-configured-features הוא true.
use-configured-features	BooleanString	האם לטעון באופן דינמי את תכונות ההצעה שהוגדרו בפרופיל השיחה במקום להגדיר אותן בהגדרת קוד קשיחה ב-features. ברירת המחדל היא "false".
disabled-features	מחרוזת	רשימה מופרדת בפסיקים של תכונות ההצעה שיוחרגו כשuse-configured-features הוא "true". דוגמה: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id	מחרוזת	מזהה סשן אופציונלי לשימוש שלא מבוסס על שיחה, כמו שימוש ב-Knowledge Assist.
show-header	BooleanString	האם להציג את כותרת המיתוג של Agent Assist. ברירת המחדל היא "false".
show-dark-mode-toggle	BooleanString	האם להציג את המתג למעבר בין מצב כהה למצב בהיר. ברירת המחדל היא "true".
מרחב שמות	מחרוזת	מגבלה אופציונלית של מרחב שמות. נדרש רק אם מטמיעים כמה מופעים של מודול ממשק משתמש בדף אחד.
handoff-summarization-enabled	BooleanString	האם להפעיל אוטומטית סיכום שיחות כשמתחילה שיחה קיימת. ברירת המחדל היא "false".

קלט

הקלט הוא אובייקטים של JavaScript או סוגים מורכבים אחרים של מאפיינים שצריך להקצות ישירות במופע של הרכיב:

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;

שם המאפיין	סוג	תגובה
knowledgeAssistCardConfig	KnowledgeAssistV2Config	הגדרות אופציונליות לכרטיסי עזרה מ-AI גנרטיבי, כולל העתקה והדבקה של תשובות והתאמה אישית של יעדי הקישורים למאמרים.

סוגים

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

BooleanString

"true" | "false"

KnowledgeAssistV2Config

interface KnowledgeAssistV2Config {
  /** Configuration for how suggested article links are opened. */
  articleLinkConfig?: {
    /** Whether to open the article in a new tab or in a popup window. Defaults to 'blank' (new tab). */
    target?: "blank" | "popup";
    /** Options to configure the popup's size and location. */
    popupWindowOptions?: string;
    /** The field name on the document metadata if a separate article link source is provided. */
    linkMetadataKey?: string;
  };
  /** Whether to show the Copy Answer button on suggestions. */
  showCopyAnswer: boolean;
  /** Whether to show the Paste Answer button on suggestions. */
  showPasteAnswer: boolean;
}