Der Container V2 bietet erhebliche Verbesserungen gegenüber dem ursprünglichen Container und wird weiterhin die aktuellsten Funktionen und Änderungen enthalten. 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 Vorschlagsfeed 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 erreicht. Informationen zur Einrichtung finden Sie unter Connector für UI-Module. 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 Gebietsschemacode 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) aus dem Stammpfad geladen:
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 Unterhaltungsprofil 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 dem generativen 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 | Optionales Namespace-Limit. 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 Eigenschaftstypen, 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;
}