Conteneur V2

Le conteneur V2 offre des améliorations significatives par rapport au conteneur initial. Pour que l'agent ait toujours accès aux suggestions les plus pertinentes et aux outils clés, la version 2 utilise un affichage réactif avec des panneaux dynamiques et un flux unifié de suggestions.

Utilisation

Importez le module dans votre page HTML avec le code suivant :

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

Intégrez le module avec la balise suivante :

<agent-assist-ui-modules-v2>

Connecteur du module d'UI

Contrairement à la V1, vous devez initialiser le connecteur de module d'UI séparément dans la V2. En dissociant le connecteur du conteneur, vous bénéficiez d'une plus grande flexibilité d'intégration. Pour la configuration, consultez Connecteur de modules d'UI. De nombreuses propriétés du conteneur V1 ne s'appliquent qu'au connecteur de module d'UI.

Localisation

Le conteneur V2 est compatible avec les langues localisées. Pour charger le conteneur dans une langue spécifique, ajoutez le code de langue au chemin du script :

Exemple pour le japonais :

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

Si aucun paramètre régional n'est spécifié, le conteneur utilise l'anglais (en) par défaut, chargé à partir du chemin racine : html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Paramètres régionaux compatibles :

  • Arabe (ar)
  • Chinois (simplifié) (zh_cn)
  • Croate (hr)
  • Anglais (Australie) (en_au)
  • Anglais (Canada) (en_ca)
  • Anglais (Royaume-Uni) (en_gb)
  • Philippin (fil)
  • Français (fr)
  • Français (Canada) (fr_ca)
  • Allemand (de)
  • Hindi (hi)
  • Hongrois (hu)
  • Italien (it)
  • Japonais (ja)
  • Coréen (ko)
  • Malais (ms)
  • Norvégien (no)
  • Polonais (pl)
  • Portugais (Brésil) (pt_br)
  • Roumain (ro)
  • Russe (ru)
  • Espagnol (es)
  • Suédois (sv)
  • Thaï (th)
  • Turc (tr)
  • Vietnamien (vi)

Attributs

Les attributs sont des propriétés de composants basées sur des chaînes, qui peuvent être définies en HTML ou à l'aide de setAttribute() en JavaScript.

Nom de propriété Type Commentaire
fonctionnalités string Liste de clés de fonctionnalités de suggestions Agent Assist à afficher, séparées par une virgule. Liste des formats acceptés : AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Ignoré si use-configured-features est défini sur true.
use-configured-features BooleanString Indique si les fonctionnalités de suggestion configurées dans le profil de conversation doivent être chargées dynamiquement au lieu d'être codées en dur dans features. La valeur par défaut est "false".
disabled-features string Liste de fonctionnalités de suggestions à exclure (séparées par une virgule) lorsque use-configured-features est défini sur "true". Exemple : "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id string ID de session facultatif pour une utilisation non basée sur une conversation, par exemple avec Generative knowledge assist.
show-header BooleanString Indique s'il faut afficher l'en-tête de branding Agent Assist. La valeur par défaut est "false".
show-dark-mode-toggle BooleanString Indique si le bouton bascule pour le mode sombre ou le mode clair doit être affiché. La valeur par défaut est "true".
espace de noms string Limite d'espace de noms facultative. N'est nécessaire que si vous implémentez plusieurs instances de module d'UI sur une même page.
handoff-summarization-enabled BooleanString Indique si la synthèse de conversation doit être déclenchée automatiquement lorsqu'une conversation existante est initialisée. La valeur par défaut est "false".

Entrées

Les entrées sont des objets JavaScript ou d'autres types de propriétés complexes qui doivent être attribués directement à l'instance de l'élément :

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;
Nom de propriété Type Commentaire
knowledgeAssistCardConfig KnowledgeAssistV2Config Configurations facultatives pour les fiches Generative Knowledge Assist, y compris la copie/coller des réponses et la personnalisation des cibles des liens vers les articles.

Types

Consultez la section suivante pour connaître les types personnalisés utilisés par le composant.

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