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 מחרוזת מזהה סשן אופציונלי לשימוש שלא מבוסס על שיחה, למשל עם הצעות לתשובות ב-Agent 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 הגדרות אופציונליות לכרטיסי הצעות לתשובות ב-Agent Assist, כולל העתקה והדבקה של תשובות והתאמה אישית של יעדי הקישורים למאמרים.

סוגים

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

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;
}