Contêiner V2

O contêiner V2 oferece melhorias significativas em relação ao contêiner inicial e continua tendo os recursos e mudanças mais recentes. Para garantir que as sugestões mais impactantes e as principais ferramentas estejam sempre acessíveis ao agente, a versão 2 usa uma exibição reativa com painéis dinâmicos e um feed unificado de sugestões.

Uso

Importe o módulo na sua página HTML com o seguinte código:

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

Incorpore o módulo com a seguinte tag:

<agent-assist-ui-modules-v2>

Conector do módulo UI

Ao contrário da V1, é necessário inicializar o conector do módulo UI separadamente na V2. A separação do conector do contêiner permite maior flexibilidade de integração. Para a configuração, consulte Conector de módulos de interface. Muitas das propriedades do contêiner V1 se aplicam apenas ao conector do módulo UI.

Localização

O contêiner V2 oferece suporte a idiomas localizados. Para carregar o contêiner em um idioma específico, adicione o código de localidade ao caminho do script:

Exemplo para japonês:

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

Se nenhuma localidade for especificada, o contêiner será definido como inglês (en), carregado do caminho raiz: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Localidades com suporte:

• Árabe (ar)
• Chinês simplificado (zh_cn)
• Croata (hr)
• Inglês (Austrália) (en_au)
• Inglês (Canadá) (en_ca)
• Inglês (Reino Unido) (en_gb)
• Filipino (fil)
• Francês (fr)
• Francês (Canadá) (fr_ca)
• Alemão (de)
• Hindi (hi)
• Húngaro (hu)
• Italiano (it)
• Japonês (ja)
• Coreano (ko)
• Malaio (ms)
• Norueguês (no)
• Polonês (pl)
• Português (Brasil) (pt_br)
• Romeno (ro)
• Russo (ru)
• Espanhol (es)
• Sueco (sv)
• Tailandês (th)
• Turco (tr)
• Vietnamita (vi)

Atributos

Os atributos são propriedades de componentes baseadas em strings que podem ser definidas em HTML ou usando setAttribute() em JavaScript.

Nome da propriedade	Tipo	Comentário
recursos	string	Lista separada por vírgulas de chaves de recursos de sugestão do Agent Assist a serem renderizadas. Lista com suporte: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Será ignorado se use-configured-features estiver definido como true.
use-configured-features	BooleanString	Indica se os recursos de sugestão configurados no perfil de conversa serão carregados dinamicamente em vez de serem codificados em features. O padrão é "false".
disabled-features	string	Lista separada por vírgulas de recursos de sugestão a serem excluídos quando use-configured-features for "true". Exemplo: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id	string	ID de sessão opcional para uso não baseado em conversas, como com o Assistente de conhecimento generativo.
show-header	BooleanString	Indica se o cabeçalho de marca do Agent Assist será mostrado. O padrão é "false".
show-dark-mode-toggle	BooleanString	Indica se a alternância para o modo escuro ou claro será mostrada. O padrão é "true".
namespace	string	Limite de namespace opcional. Necessário apenas se você estiver implementando várias instâncias de módulo UI em uma única página.
handoff-summarization-enabled	BooleanString	Indica se a sumarização da conversa será acionada automaticamente quando uma conversa atual for inicializada. O padrão é "false".

Entradas

As entradas são objetos JavaScript ou outros tipos de propriedade complexos que precisam ser atribuídos diretamente à instância do elemento:

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

Nome da propriedade	Tipo	Comentário
knowledgeAssistCardConfig	KnowledgeAssistV2Config	Configurações opcionais para cards do Assistente de conhecimento generativo, incluindo copiar/colar respostas e personalizar destinos de links de artigos.

Tipos

Consulte a seção a seguir para ver os tipos personalizados usados pelo 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;
}