Implemente módulos e conetores da IU

O Agent Assist oferece um conjunto de módulos de componentes da IU pré-criados e personalizáveis que pode usar para integrar funcionalidades do Agent Assist na sua IU. Pode incorporar os módulos em qualquer aplicação Web para apresentar sugestões do Agent Assist aos seus agentes. Para instruções específicas sobre como integrar módulos no LivePerson, consulte o tutorial do LivePerson.

Funcionalidades do Agent Assist

Seguem-se as funcionalidades do Assistente do agente que pode implementar como componentes do módulo da IU.

Antes de começar

Antes de poder implementar módulos da IU, configure um perfil de conversa.

Implemente módulos da IU

Existem duas abordagens principais para integrar módulos do Assistente do agente na sua IU. A abordagem do contentor gerido integra todas as funcionalidades selecionadas do Assistente do agente num único painel. Em alternativa, pode importar funcionalidades individualmente se quiser personalizar a respetiva configuração na sua interface. A comunicação entre os componentes da IU e a área de trabalho do agente é facilitada por um conetor do módulo da IU. Toda a comunicação ocorre através do envio de eventos personalizados.

A abordagem de contentor e os componentes individuais podem ser usados com qualquer sistema, mas o Agent Assist só fornece conetores de módulos de IU para utilização com o Genesys Cloud, o LivePerson, o Twilio e o Salesforce. Para integrar módulos da IU com qualquer outro sistema de agente, tem de criar os seus próprios conetores. Use a abordagem do contentor V2 para a maioria das funcionalidades. Também pode implementar componentes individuais, como a Resposta inteligente, se tiver espaço.

Versões de ficheiros

Obtenha a versão mais recente de um ficheiro gstatic especificando a versão mais recente:

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

Obtenha uma versão estável específica de um ficheiro gstatic especificando a versão exata:

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

Versões mais recentes: 

      Container: v1.12
      Container: v2.0
      Common: v1.6
      Knowledge assist: v1.1
      Generative knowledge assist: v2.9
      Smart reply: v1.4
      Summarization: v1.3
      Transcript: v1.3

Contentor gerido

A abordagem de contentor gerido integra um único componente que renderiza as funcionalidades do Agent Assist escolhidas num painel unificado. Este painel também trata de todas as questões relacionadas com módulos partilhados, incluindo o carregamento de conectores e quaisquer mensagens de erro. Recomendamos esta abordagem se estiver a integrar os módulos num ambiente de trabalho de agente de terceiros, como o LivePerson, ou se precisar de uma personalização mínima ou nenhuma de como as funcionalidades do Agent Assist são renderizadas na sua IU.

Depois de o componente do contentor ser inicializado, carrega todas as dependências necessárias. Só é necessária uma única importação para inicializar o contentor, independentemente do número de funcionalidades do Assistente do agente usadas.

Inicialize o componente do contentor:

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

Nome da etiqueta do elemento:

    <agent-assist-ui-modules>

Exemplo de inicialização:

    const uiModulesEl = document.createElement('agent-assist-ui-modules');
    uiModulesEl.setAttribute('features', 'SMART_REPLY,ARTICLE_SUGGESTION');
    uiModulesEl.setAttribute('conversation-profile', 'projects/my-project/locations/global/conversationProfiles/123');
    uiModulesEl.setAttribute('auth-token', authToken);
    uiModulesEl.setAttribute('channel', 'chat');
    uiModulesEl.setAttribute('custom-api-endpoint', 'https://my-dialogflow-proxy-service.com');
    uiModulesEl.setAttribute('dark-mode-background', '#000000');
    hostElement.appendChild(uiModulesEl);

Para mais detalhes, consulte a página de documentação da API de componentes.

Componentes individuais

Tem a opção de integrar os módulos da IU do Agent Assist individualmente, em vez de num único contentor. Recomendamos esta abordagem apenas se usar uma aplicação personalizada em que os módulos possam ter de ser renderizados em diferentes secções da página ou se precisar de uma personalização significativa.

Neste caso, tem de importar cada módulo da IU específico da funcionalidade individualmente. Além disso, tem de importar e inicializar o conetor do módulo de IU.

Implemente o conetor do módulo de IU

A menos que esteja a usar a versão 1 do contentor, tem de implementar o conetor do módulo de IU para usar módulos de IU. Adicione o seguinte código à sua aplicação para expor uma classe UiModulesConnector global que pode ser instanciada e inicializada:

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

Métodos:

    constructor(): void;
    init(config: ConnectorConfig): void;
    disconnect(): void;
    setAuthToken(token: string): void;

Segue-se um exemplo da interface TypeScript completa para o objeto de configuração do conetor. Se tiver criado um conetor de módulo de IU personalizado para usar com um sistema não suportado, defina agentDesktop como Custom. O exemplo seguinte fornece uma lista de sistemas de estação de trabalho de agente suportados.

interface ConnectorConfig {
  /** Communication mode for the UI modules application. */
  channel: 'chat'|'voice';

  /** Agent desktop to use. */
  agentDesktop: 'LivePerson' | 'GenesysCloud' | 'SalesForce' | 'GenesysEngageWwe' | 'Custom';

  /** Conversation profile name to use. */
  conversationProfileName: string;

  /** API Connector config. */
  apiConfig: {
    /**
     * Authentication token to attach to outgoing requests. Should be a valid
     * OAuth token for Dialogflow API, or any other token for custom API
     * endpoints.
     */
    authToken: string;

    /**
     * Specifies a custom proxy server to call instead of calling the Dialogflow
     * API directly.
     */
    customApiEndpoint?: string;

    /** API key to use. */
    apiKey?: string;

    /**
     * Additional HTTP headers to include in the Dialogflow/proxy server API
     * request.
     */
    headers?: Array;
  }

  /** Event-based connector config. This is required for voice conversations and some features of chat conversations. Always set it. */
  eventBasedConfig?: {
    /**
     * Transport protocol to use for updates. Defaults to 'websocket' if none is
     * specified.
     */
    transport?: 'websocket'|'polling';

    /** Event-based library to use (i.e., Socket.io). */
    library?: 'SocketIo';

    /** Endpoint to which the connection will be established. */
    notifierServerEndpoint: string;
  }
}

Exemplo de instanciação:

const connector = new UiModulesConnector();

connector.init({
  channel: 'chat',
  agentDesktop: 'Custom',
  conversationProfileName: 'projects/my-project/locations/global/conversationProfiles/123',
  apiConfig: {
    authToken: 'abc123',
    customApiEndpoint: 'https://my-dialogflow-proxy-server.com',
  }
});

Exclusão de responsabilidade de preços

Se usar módulos da IU, existe um custo associado aos serviços subjacentes, incluindo o seguinte: