Contenedor V2

El contenedor V2 ofrece mejoras significativas con respecto al contenedor inicial y seguirá teniendo las funciones y los cambios más actualizados. Para garantizar que el agente siempre tenga acceso a las sugerencias más impactantes y a las herramientas clave, la versión 2 usa una pantalla reactiva con paneles dinámicos y un feed unificado de sugerencias.

Uso

Importa el módulo en tu página HTML con el siguiente código:

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

Incorpora el módulo con la siguiente etiqueta:

<agent-assist-ui-modules-v2>

Conector del módulo de la IU

A diferencia de la V1, debes inicializar el conector del módulo de la IU por separado en la V2. Desvincular el conector del contenedor permite una mayor flexibilidad de integración. Para la configuración, consulta Conector de módulos de la IU. Muchas de las propiedades del contenedor V1 solo se aplican al conector del módulo de la IU.

Localización

El contenedor V2 admite idiomas localizados. Para cargar el contenedor en un idioma específico, antepón el código de configuración regional a la ruta de acceso de la secuencia de comandos:

Ejemplo para el japonés:

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

Si no se especifica ninguna configuración regional, el contenedor usa el inglés (en) de forma predeterminada, que se carga desde la ruta de acceso raíz: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Configuraciones regionales admitidas:

• Árabe (ar)
• Chino (simplificado) (zh_cn)
• Croata (hr)
• Inglés (Australia) (en_au)
• Inglés (Canadá) (en_ca)
• Inglés (Reino Unido) (en_gb)
• Filipino (fil)
• Francés (fr)
• Francés (Canadá) (fr_ca)
• Alemán (de)
• Hindi (hi)
• Húngaro (hu)
• Italiano (it)
• Japonés (ja)
• Coreano (ko)
• Malayo (ms)
• Noruego (no)
• (pl)
• Portugués (Brasil) (pt_br)
• Rumano (ro)
• Ruso (ru)
• Español (es)
• Sueco (sv)
• Tailandés (th)
• Turco (tr)
• Vietnamita (vi)

Atributos

Los atributos son propiedades de componentes basadas en cadenas que se pueden configurar en HTML o con setAttribute() en JavaScript.

Nombre de la propiedad	Tipo	Comentario
características	string	Lista separada por comas de las claves de funciones de sugerencias de Agent Assist que se deben renderizar. Lista admitida: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Se ignora si use-configured-features se establece en true.
use-configured-features	BooleanString	Especifica si se deben cargar de forma dinámica las funciones de sugerencias configuradas en el perfil de conversación en lugar de codificarlas de forma rígida en features. El valor predeterminado es "false".
disabled-features	string	Lista separada por comas de las funciones de sugerencias que se deben excluir cuando use-configured-features es "true". Ejemplo: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id	string	Es un ID de sesión opcional para el uso que no se basa en conversaciones, como con Asistente de conocimiento generativo.
show-header	BooleanString	Especifica si se debe mostrar el encabezado de la marca de Agent Assist. El valor predeterminado es "false".
show-dark-mode-toggle	BooleanString	Especifica si se debe mostrar el botón de activación para el modo oscuro en comparación con el modo claro. El valor predeterminado es "true".
espacio de nombres	string	Límite de espacio de nombres opcional. Solo es necesario si se implementan varias instancias de módulos de la IU en una sola página.
handoff-summarization-enabled	BooleanString	Especifica si se debe activar automáticamente el resumen de la conversación cuando se inicializa una conversación existente. El valor predeterminado es "false".

Entradas

Las entradas son objetos de JavaScript o tipos de propiedades complejas que se deben asignar directamente en la instancia del elemento:

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;

Nombre de la propiedad	Tipo	Comentario
knowledgeAssistCardConfig	KnowledgeAssistV2Config	Son configuraciones opcionales para las tarjetas de Asistente de conocimiento generativo, que incluyen copiar y pegar respuestas, y personalizar los destinos de los vínculos de artículos.

Tipos

Consulta la siguiente sección para conocer los tipos personalizados que usa el 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;
}