Contêiner V2

O contêiner V2 oferece melhorias significativas em relação ao contêiner inicial. Para garantir que as sugestões mais impactantes e as ferramentas principais estejam sempre acessíveis ao agente, a versão 2 usa uma tela 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 de módulo UI

Ao contrário da V1, é preciso inicializar o conector do módulo UI separadamente na V2. Ao desacoplar o conector do contêiner, é possível ter mais flexibilidade de integração. Para a configuração, consulte Conector de módulos da interface. Muitas das propriedades no contêiner V1 se aplicam apenas ao conector do módulo de UI.

Localização

O contêiner V2 é compatível com 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 vai usar o inglês (en) por padrão, carregado do caminho raiz: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Localidades disponíveis:

  • Á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 compatível: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Será ignorado se use-configured-features for definido como true.
use-configured-features BooleanString Se os recursos de sugestão configurados no perfil de conversa devem ser 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 é "true". Exemplo: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id string ID de sessão opcional para uso não baseado em conversas, como com a assistência de conhecimento generativo.
show-header BooleanString Se o cabeçalho da marca do Agent Assist será mostrado. O valor padrão é "false".
show-dark-mode-toggle BooleanString Se o botão de alternância entre o modo escuro e o modo claro vai aparecer. O valor padrão é "true".
namespace string Limite opcional de namespace. Só é necessário ao implementar várias instâncias de módulos UI em uma única página.
handoff-summarization-enabled BooleanString Indica se o resumo de conversa será acionado automaticamente quando uma conversa existente for inicializada. O valor padrão é "false".

Entradas

As entradas são objetos JavaScript ou outros tipos de propriedades complexas que precisam ser atribuídas diretamente na 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 conferir 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;
}