Container V2

Il container V2 offre miglioramenti significativi rispetto al container iniziale e continuerà a includere le funzionalità e le modifiche più recenti. Per garantire che i suggerimenti e gli strumenti chiave più efficaci 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, nella versione 2 devi inizializzare separatamente il connettore del modulo UI. Il disaccoppiamento del connettore dal container consente una maggiore flessibilità di integrazione. Per la configurazione, consulta Connettore dei moduli UI. Molte delle proprietà del container della versione 1 si applicano solo al connettore del modulo UI.

Localizzazione

Il container della versione 2 supporta le lingue localizzate. Per caricare il container 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 internazionale, il container utilizza l'inglese (en) come lingua predefinita, caricata 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)
• Malese (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
features	string	Elenco separato da virgole delle chiavi delle funzionalità di suggerimento di Agent Assist da eseguire il rendering. Elenco supportato: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Viene ignorato se use-configured-features è impostato su true.
use-configured-features	BooleanString	Indica se caricare dinamicamente le funzionalità di suggerimento configurate nel profilo della conversazione anziché codificarle in modo rigido 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 sulla conversazione, ad esempio con Assistenza knowledge base generativa.
show-header	BooleanString	Indica se mostrare l'intestazione del brand Assistenza agente. Il valore predefinito è "false".
show-dark-mode-toggle	BooleanString	Indica se mostrare l'opzione per passare dalla modalità Buio alla modalità Luce. Il valore predefinito è "true".
namespace	string	Limite dello spazio dei nomi facoltativo. È necessario solo se implementi più istanze del modulo UI in una singola pagina.
handoff-summarization-enabled	BooleanString	Indica 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à complesse 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 di Assistenza conoscenza generativa, inclusa la copia/incolla delle risposte e la personalizzazione delle destinazioni dei link agli articoli.

Tipi

Per i tipi personalizzati utilizzati dal componente, consulta la sezione seguente.

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