Container V2

Der Container V2 bietet erhebliche Verbesserungen gegenüber dem ursprünglichen Container. Damit der Kundenservicemitarbeiter immer Zugriff auf die wirkungsvollsten Vorschläge und wichtigsten Tools hat, wird in Version 2 eine reaktive Anzeige mit dynamischen Bereichen und einem einheitlichen Feed mit Vorschlägen verwendet.

Nutzung

Importieren Sie das Modul mit dem folgenden Code in Ihre HTML-Seite:

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

Betten Sie das Modul mit dem folgenden Tag ein:

<agent-assist-ui-modules-v2>

UI-Modul-Connector

Im Gegensatz zu V1 müssen Sie den UI-Modul-Connector in V2 separat initialisieren. Durch die Entkopplung des Connectors vom Container wird eine höhere Flexibilität bei der Integration ermöglicht. Eine Anleitung zur Einrichtung finden Sie unter UI-Module-Connector. Viele der Eigenschaften im V1-Container gelten nur für den UI-Modul-Connector.

Lokalisierung

Der V2-Container unterstützt lokalisierte Sprachen. Wenn Sie den Container in einer bestimmten Sprache laden möchten, stellen Sie dem Skriptpfad den Gebietsschema-Code voran:

Beispiel für Japanisch:

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

Wenn kein Gebietsschema angegeben ist, wird standardmäßig Englisch (en) verwendet, das aus dem Stammpfad geladen wird: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Unterstützte Sprachen:

  • Arabisch (ar)
  • Chinesisch (vereinfacht) (zh_cn)
  • Kroatisch (hr)
  • Englisch (Australien) (en_au)
  • Englisch (Kanada) (en_ca)
  • Englisch (Vereinigtes Königreich) (en_gb)
  • Filipino (fil)
  • Französisch (fr)
  • Französisch (Kanada) (fr_ca)
  • Deutsch (de)
  • Hindi (hi)
  • Ungarisch (hu)
  • Italienisch (it)
  • Japanisch (ja)
  • Koreanisch (ko)
  • Malaiisch (ms)
  • Norwegisch (no)
  • Polnisch (pl)
  • Portugiesisch (Brasilien) (pt_br)
  • Rumänisch (ro)
  • Russisch (ru)
  • Spanisch (es)
  • Schwedisch (sv)
  • Thailändisch (th)
  • Türkisch (tr)
  • Vietnamesisch (vi)

Attribute

Attribute sind stringbasierte Komponenteneigenschaften, die in HTML oder mit setAttribute() in JavaScript festgelegt werden können.

Eigenschaft Typ Kommentar
Features String Durch Kommas getrennte Liste der Schlüssel für Agent Assist-Vorschlagsfunktionen, die gerendert werden sollen. Unterstützte Liste: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Wird ignoriert, wenn use-configured-features auf true gesetzt ist.
use-configured-features BooleanString Gibt an, ob die im Konversationsprofil konfigurierten Vorschlagsfunktionen dynamisch geladen werden sollen, anstatt sie in features fest zu codieren. Die Standardeinstellung ist "false".
disabled-features String Durch Kommas getrennte Liste der Vorschlagsfunktionen, die ausgeschlossen werden sollen, wenn use-configured-features gleich "true" ist. Beispiel: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id String Optionale Sitzungs-ID für die nicht konversationsbasierte Nutzung, z. B. mit Generative Knowledge Assist.
show-header BooleanString Gibt an, ob die Kopfzeile mit dem Agent Assist-Branding angezeigt werden soll. Die Standardeinstellung ist "false".
show-dark-mode-toggle BooleanString Gibt an, ob die Ein/Aus-Schaltfläche für den dunklen und den hellen Modus angezeigt werden soll. Die Standardeinstellung ist "true".
Namespace String Optionale Namespace-Beschränkung. Nur erforderlich, wenn mehrere UI-Modulinstanzen auf einer einzelnen Seite implementiert werden.
handoff-summarization-enabled BooleanString Gibt an, ob die Zusammenfassung von Unterhaltungen automatisch ausgelöst werden soll, wenn eine vorhandene Unterhaltung initialisiert wird. Die Standardeinstellung ist "false".

Eingaben

Eingaben sind JavaScript-Objekte oder andere komplexe Attributtypen, die der Elementinstanz direkt zugewiesen werden müssen:

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;
Eigenschaft Typ Kommentar
knowledgeAssistCardConfig KnowledgeAssistV2Config Optionale Konfigurationen für Generative Knowledge Assist-Karten, einschließlich des Kopierens/Einfügens von Antworten und des Anpassen von Artikel-Linkzielen.

Typen

Im folgenden Abschnitt finden Sie die benutzerdefinierten Typen, die von der Komponente verwendet werden.

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