Conteneur V2

Le conteneur V2 offre des améliorations significatives par rapport au conteneur initial et continuera de proposer les fonctionnalités et les modifications les plus récentes. Pour s'assurer que les suggestions les plus percutantes et les outils clés sont toujours accessibles à l'agent, 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 de module d'interface utilisateur

Contrairement à la version 1, vous devez initialiser le connecteur de module d'interface utilisateur séparément dans la version 2. Le découplage du connecteur du conteneur permet une plus grande flexibilité d'intégration. Pour la configuration, consultez Connecteur de modules d'interface utilisateur. De nombreuses propriétés du conteneur V1 ne s'appliquent qu'au connecteur de module d'interface utilisateur.

Localisation

Le conteneur V2 est compatible avec les langues localisées. Pour charger le conteneur dans une langue spécifique, ajoutez le code des paramètres régionaux 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 est défini par défaut sur l'anglais (en), 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 composant 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	chaîne	Liste de clés de fonctionnalités de suggestions d'Agent Assist à afficher, séparées par une virgule. Liste compatible : 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 suggestions configurées dans le profil de conversation doivent être chargées de manière dynamique au lieu d'être codées en dur dans features. La valeur par défaut est "false".
disabled-features	chaîne	Liste de fonctionnalités de suggestions à exclure lorsque use-configured-features est "true", séparées par une virgule. Exemple : "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id	chaîne	ID de session facultatif pour une utilisation non basée sur une conversation, par exemple avec l'assistance base de connaissances générative.
show-header	BooleanString	Indique si l'en-tête de branding Agent Assist doit être affiché. La valeur par défaut est "false".
show-dark-mode-toggle	BooleanString	Indique si le bouton permettant d'alterner entre le mode sombre et le mode clair doit être affiché. La valeur par défaut est "true".
espace de noms	chaîne	Limite d'espace de noms facultative. N'est nécessaire que si vous implémentez plusieurs instances de module d'interface utilisateur sur une seule page.
handoff-summarization-enabled	BooleanString	Indique si le résumé de la conversation doit être déclenché 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 d'é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/le collage des réponses et la personnalisation des cibles des liens d'articles.

Types

Pour connaître les types personnalisés utilisés par le composant, consultez la section suivante.

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