Container V2

Il contenitore V2 offre miglioramenti significativi rispetto al contenitore iniziale. Per garantire che i suggerimenti più efficaci e gli strumenti chiave siano sempre accessibili all'agente, la versione 2 utilizza una visualizzazione reattiva con riquadri dinamici e un feed unificato di suggerimenti.

Utilizzo

Importa il modulo nella pagina HTML con il seguente codice:

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

Incorpora il modulo con il seguente tag:

<agent-assist-ui-modules-v2>

Connettore del modulo UI

A differenza della versione 1, devi inizializzare separatamente il connettore del modulo UI nella versione 2. Il disaccoppiamento del connettore dal container consente una maggiore flessibilità di integrazione. Per la configurazione, consulta Connettore dei moduli UI. Molte delle proprietà del contenitore V1 si applicano solo al connettore del modulo UI.

Localizzazione

Il contenitore V2 supporta le lingue localizzate. Per caricare il contenitore in una lingua specifica, anteponi il codice delle impostazioni internazionali al percorso dello script:

Esempio per il giapponese:

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

Se non viene specificata alcuna impostazione locale, il container utilizza l'inglese (en) per impostazione predefinita, caricato dal percorso principale: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Impostazioni internazionali supportate:

  • Arabo (ar)
  • Cinese (semplificato) (zh_cn)
  • Croato (hr)
  • Inglese (Australia) (en_au)
  • Inglese (Canada) (en_ca)
  • Inglese (Regno Unito) (en_gb)
  • Filippino (fil)
  • Francese (fr)
  • Francese (Canada) (fr_ca)
  • Tedesco (de)
  • Hindi (hi)
  • Ungherese (hu)
  • Italiano (it)
  • Giapponese (ja)
  • Coreano (ko)
  • Malay (ms)
  • Norvegese (no)
  • Polacco (pl)
  • Portoghese (Brasile) (pt_br)
  • Rumeno (ro)
  • Russo (ru)
  • Spagnolo (es)
  • Svedese (sv)
  • Thai (th)
  • Turco (tr)
  • Vietnamita (vi)

Attributi

Gli attributi sono proprietà dei componenti basate su stringhe che possono essere impostate in HTML o utilizzando setAttribute() in JavaScript.

Nome proprietà Tipo Commento
funzionalità string Elenco separato da virgole delle chiavi delle funzionalità di suggerimento di Agent Assist da visualizzare. Elenco supportato: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Ignorato se use-configured-features è impostato su true.
use-configured-features BooleanString Se caricare dinamicamente le funzionalità di suggerimento configurate nel profilo della conversazione anziché codificarle in modo permanente in features. Il valore predefinito è "false".
disabled-features string Elenco separato da virgole delle funzionalità di suggerimento da escludere quando use-configured-features è "true". Esempio: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id string ID sessione facoltativo per l'utilizzo non basato su conversazione, ad esempio con l'assistenza knowledge base generativa.
show-header BooleanString Indica se mostrare l'intestazione del branding di Agent Assist. Il valore predefinito è "false".
show-dark-mode-toggle BooleanString Se mostrare l'opzione per la modalità Buio o Luce. Il valore predefinito è "true".
spazio dei nomi string Limite facoltativo dello spazio dei nomi. Necessario solo se implementi più istanze del modulo UI su una singola pagina.
handoff-summarization-enabled BooleanString Se attivare automaticamente il riepilogo della conversazione quando viene inizializzata una conversazione esistente. Il valore predefinito è "false".

Input

Gli input sono oggetti JavaScript o altri tipi di proprietà complessi che devono essere assegnati direttamente all'istanza dell'elemento:

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;
Nome proprietà Tipo Commento
knowledgeAssistCardConfig KnowledgeAssistV2Config Configurazioni facoltative per le schede dell'assistenza knowledge base generativa, tra cui la copia/incolla delle risposte e la personalizzazione delle destinazioni dei link agli articoli.

Tipi

Consulta la sezione seguente per i tipi personalizzati utilizzati dal componente.

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