Contenedor V2

El contenedor V2 ofrece mejoras significativas en comparación con el contenedor inicial. Para garantizar que el agente siempre tenga acceso a las sugerencias más eficaces 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 versión 1, en la versión 2 debes inicializar el conector del módulo de IU por separado. Desacoplar 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 de la versión 1 solo se aplican al conector del módulo de IU.

Localización

El contenedor de la versión 2 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 del script:

Ejemplo para 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 se establece de forma predeterminada en inglés (en), cargado 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)
  • Polaco (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 establecer en HTML o con setAttribute() en JavaScript.

Nombre de la propiedad Tipo Comentario
características cadena Lista separada por comas de las claves de funciones de sugerencias de Agent Assist que se renderizarán. Lista de formatos admitidos: 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 Indica si se deben cargar de forma dinámica las funciones de sugerencia configuradas en el perfil de conversación en lugar de codificarlas de forma rígida en features. La configuración predeterminada es "false".
disabled-features cadena Lista separada por comas de las funciones de sugerencia que se deben excluir cuando use-configured-features es "true". Ejemplo: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id cadena Es el ID de sesión opcional para el uso no basado en conversaciones, como con Asistente de conocimiento generativo.
show-header BooleanString Indica si se debe mostrar el encabezado de desarrollo de la marca de Agent Assist. La configuración predeterminada es "false".
show-dark-mode-toggle BooleanString Indica si se debe mostrar el botón de activación para cambiar entre el modo oscuro y el modo claro. La configuración predeterminada es "true".
espacio de nombres cadena Es el límite opcional del espacio de nombres. Solo se necesita si se implementan varias instancias de módulos de IU en una sola página.
handoff-summarization-enabled BooleanString Indica si se debe activar automáticamente el resumen de la conversación cuando se inicializa una conversación existente. La configuración predeterminada es "false".

Entradas

Las entradas son objetos de JavaScript o de otros tipos de propiedades complejos 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 del Asistente de conocimiento generativo, como copiar y pegar respuestas, y personalizar los destinos de los vínculos a artículos.

Tipos

Consulta la siguiente sección para ver 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;
}