Modificar seu script do Studio para Copilot for Agents

Esta é a terceira e última etapa de configuração de Copilot for Agents.

Você precisa criar ou modificar pelo menos um Studio script para configurar Copilot for Agents no seu contact center. Você deve adicionar a ele uma Agent Assist action e atribuir o perfil Copilot for Agents que você criou anteriormente. O script deve ser projetado para rotear interaçõesClosed A conversa completa com um agente por meio de um canal. Por exemplo, uma interação pode ser uma chamada de voz, um e-mail, um chat ou uma conversa em mídia social. por competênciasClosed Usada para automatizar a distribuição de interações com base nas competências, nas habilidades e no conhecimento dos agentes. para os Agentes para os quais você deseja que Copilot for Agents esteja disponível.

Complete cada uma dessas tarefas na ordem indicada.

Adicionar ações ao seu script

Permissões necessárias: Studio Script View, Create/Edit

  1. No Studio, abra o script que deseja usar.

    • Se o seu perfil Copilot for Agents usar Resumo da jornada, você deve adicionar uma CC Create ação ao script para interações de voz.

    • Adicione a CC Create ação antes da ação ONANSWER.

    • Preferencialmente, posicione-o antes de REQAGENT, para que o Customer Card exista antes que os Autosummaries ou Dispositions sejam gerados. Os Cartões do Cliente são necessários para que o Resumo da jornada colete e resuma o contexto da interação do cliente.

  2. Adicione uma ação Agent Assist após a ação ONANSWER ou ONASSIGNMENT.

  3. Se você estiver trabalhando com um script de voz, adicione uma ação CONTINUOUS TRANSCRIPTION action imediatamente após a ação AGENT ASSIST. Selecione seu serviço de transcrição no assistente dessa ação. Em seguida, configure as seguintes propriedades:

  4. Se você estiver trabalhando com um script digital, adicione uma ação SNIPPET action antes da ação AGENT ASSIST. Dê a esta ação SNIPPET uma Caption de set AgentID. Copie a seguinte linha de código e cole-a na guia Exibir texto, da janela editor.

    ASSIGN global:__AgentId = "{AGENTID}"
  5. Para concluir a configuração do script:

    • Adicione snippets de inicialização ao script usando as ações Snippet actions. Você pode fazer isso para personalizar seu aplicativo de assistência ao agente.
    • Reconfigure os conectores de ação para garantir o fluxo de contato adequado e corrigir possíveis erros.
    • Conclua qualquer script adicional e teste o script.

Atribuir um Perfil a um script de Studio

Permissões necessárias: Studio Script View, Create/Edit

Use estes exemplos de scripts para voz e digital.

  1. No Studio, abra o script que deseja usar.
  2. Clique em abrir editor Icon of small rounded rectangle with a bar across the top na ação Agent Assist.

  3. Na coluna da esquerda, clique na marca de seleção A light gray checkmark inside a light gray circle. ao lado do aplicativo ou do perfil de assistência ao agente que você deseja atribuir a este script.

    Uma alternativa ao uso da marca de seleção é criar uma variável no seu script Studio. Use a variável para passar o nome do aplicativo ou do perfil para a propriedade Assign Launch Config Name da ação AGENT ASSIST.

  4. Clique me Fechar.

Atribuir Múltiplos Perfis a um script Studio

Permissões necessárias: Studio Script View, Create/Edit

Você pode usar variáveis Studio para atribuir múltiplos perfis Copilot for Agents a um script Studio. Você então usa um código de lógica que determina quando cada perfil é utilizado.

Use estes exemplos de scripts para voz e digital.

Estas etapas descrevem um exemplo simples de como atribuir dois perfis do Copilot for Agents a um script. Seu script pode ser mais complexo. Entre em contato com os Serviços para obter o melhor design e implementação.

  1. No Studio, abra o script que deseja usar.

  2. Se ainda não o fez, adicione uma ação AGENT ASSIST na localização correta do seu script.

  3. Adicione uma SNIPPET action antes da ação AGENT ASSIST e conecte-as.

  4. Duplo clique na ação SNIPPET.

  5. Na janela do Snippet editor, crie três variáveis. Você precisa de duas variáveis para armazenar os nomes de perfil do Copilot for Agents e de uma variável para armazenar o nome DO perfil que você deseja que o script use quando for executado.

  6. Abaixo dessas variáveis, insira o código de lógica que determina quando cada perfil é usado. Este código altera o valor da variável profileToUse.

  7. Duplo clique na ação AGENT ASSIST para abrir Agent Assist Hub.

  8. Para cada perfil Copilot for Agents que você deseja usar:

    1. Clique no nome DO perfil na coluna da esquerda.

    2. Copie o nome DO perfil a partir da Guia geral.

    3. Cole-o no código do Snippet que você criou anteriormente como o valor de uma das variáveis de nome DO perfil. No código do exemplo anterior, os nomes de variáveis são profile1 e profile2.

  9. Clique com o botão direito na ação AGENT ASSIST. Na propriedade assistLaunchConfigName, digite {profileToUse}. Este é o nome da variável que contém o perfil que você deseja que o script use, delimitado por chaves.

  10. Salve o seu script.

Filtrar respostas da KB por Tags de Knowledge Management (Expert)

Permissões necessárias: Studio Script View, Create/Edit

Se você integrou uma base de conhecimento Knowledge Management (Expert), você pode, opcionalmente, usar NiCE CXone Knowledge Management (Expert) tags Icon of dark gray square with an arrow pointing out of its upper right corner para filtrar respostas da KB. Para fazer isso, você pode configurar dois tipos de listas de tags:

  • Lista de tags padrão: O perfil Copilot for Agents pode acessar somente artigos da KB com as tags presentes nesta lista de tags. Ela gera respostas da base de conhecimento utilizando apenas estes artigos nela contidos.

  • Lista de tags personalizadas: Existem dois tipos de tags personalizadas:

    • Filtrar: A configuração de type como filter adiciona os valores de tag selecionados aos critérios de filtragem Knowledge Hub para a configuração de resposta na BDC. Isso então limita os resultados de artigos àqueles que foram explicitamente marcados com tag na base de conhecimento. Essa abordagem é útil para limitar o conjunto de artigos a serem considerados na geração de respostas na BDC, mas traz a sobrecarga de ter que marcar os artigos com tags. Os Agentes podem selecionar as tags de uma lista de tags personalizada para filtrar as respostas na BDC. Você pode especificar até cinco listas de tags personalizadas por perfil Copilot for Agents.

    • Acrescentar: Definir type como append adiciona os valores de tag selecionados à consulta como um contexto suplementar. Esta opção não exige a marcação de artigos. Ela considera todos os artigos filtrados pelo perfil Copilot for Agents e depende de Copilot para identificar os artigos relevantes com base na consulta mais o contexto suplementar. Por exemplo, considere uma pergunta "Quando devo plantar meus vegetais?" em que o valor de Append selecionado para "Plants" é "Carrots, Potatoes". A consulta real enviada a Copilot para uma KB Answer é "Quando devo plantar meus vegetais? Plants include Carrots, Potatoes."

    Se o seu perfil Copilot for Agents usar o conector Knowledge Hub, você também pode filtrar as respostas da KB por quaisquer metadados de Knowledge Hub, não somente tags. Saiba como em Filtrar respostas da KB por metadados de Knowledge Hub.

    Exemplo utilizando a filter opção:

    1. No Studio, abra o script que estiver configurando para o Copilot for Agents.

    2. Caso ainda não tenha feito isso, adicione uma Agent Assistação após ONANSWER ou ONASSIGNMENT.

    3. Selecione a ação Agent Assist.

    4. Configure a propriedade scriptParams da ação Agent Assist com uma lista das tags Knowledge Management (Expert) pelas quais você deseja filtrar, neste formato:

      
      {"expertTags":{
         "matchType":"ALL",
         "standard":["Tag1","Tag2","Tag3","Tag4","Tag5"],
         "custom":[
      {"name":"NameofTagList1","type":"Filter","values":["Tag1","Tag2"],"default":["Tag1"]},{"name":"NameofTagList2","type":"Filter","values":["Tag3","Tag4"],"default":["Tag4"]}
      ]
      }
      }

      Neste exemplo, matchType está definido como ANY, portanto Copilot for Agents exibe respostas da KB marcadas com 2024 ou 2025, OR Platinum ou Gold, OR Silver ou Bronze — em vez de exigir que um artigo corresponda a todos os três grupos de marcadores ao mesmo tempo.

      matchType é opcional e controla como os valores das tags padrão e personalizadas são combinados quando Knowledge Hub filtra artigos da base de conhecimento:

      • ALL (padrão) — um artigo da KB deve corresponder a todos os grupos de tags. Se você omitir matchType, ou se o seu script foi configurado antes da existência dessa opção, a filtragem continua a se comportar dessa forma. Nenhuma alteração é necessária para preservar o comportamento atual.

      • ANY — um artigo da KB pode corresponder a qualquer um dos grupos de marcadores. matchType não diferencia maiúsculas de minúsculas. Por exemplo, any, ANY e Any são tratados da mesma forma.

      Onde default é a tag selecionada automaticamente na lista de tags personalizadas. Certifique-se de que os nomes das tags que você inserir correspondam exatamente aos nomes das tags na sua base de conhecimento Knowledge Management (Expert).

    5. Salve o seu script.

Filtrar respostas da KB por metadados de Knowledge Hub

Permissões necessárias: Studio Script View, Create/Edit

Se o seu perfil Copilot for Agents usar o conector Knowledge Hub, você pode usar filtros de agente para limitar os artigos de conhecimento que Copilot for Agents usa para criar respostas da KB. Os filtros de Agente usam os metadados dos seus artigos. Metadados são informações extras salvas com cada artigo, como um nome de produto, um nível de plano ou um idioma. Cada metadado tem uma chave, que é o seu nome.

Você adiciona filtros de agente ao seu script Studio como um bloco de JSON chamado agentFilters. JSON é um formato de texto para dados estruturados. Você pode definir até cinco filtros.

Os filtros de agente se aplicam a respostas automáticas na BDC e a respostas na BDC que os agentes solicitam na barra de pesquisa, tanto para interações de voz quanto para interações digitais. Eles não se aplicam quando o perfil usa o conector Direct Knowledge Management (Expert).

Como os Filtros de Agente funcionam com tags e Filtros de Perfil

  • Tags: O bloco agentFilters funciona como o bloco expertTags descrito em Filtrar respostas da KB por Knowledge Management (Expert) Tags. A diferença é que o expertTags filtra somente por tags, enquanto o agentFilters pode filtrar por qualquer chave de metadados. O bloco expertTags ainda funciona. Não é necessário alterar os scripts que o utilizam.

  • Ambos os blocos em um único script: Se o seu script tiver um bloco agentFilters válido, Copilot for Agents o utiliza e ignora expertTags, mesmo quando agentFilters não tiver nenhum filtro nele. Se o bloco agentFilters não for um JSON válido, Copilot for Agents utiliza expertTags em vez disso.

  • Filtros de perfil: Copilot for Agents combina filtros de agente com os filtros em Sub-Filtros de conteúdo Primário e Metadados e Sub-Filtros de conteúdo Secundário e Metadados na aba Conhecimento do perfil. Um artigo deve corresponder a ambos para ser usado.

Modos filtrar e Acrescentar

Cada filtro de agente usa um dos dois modos:

  • Filtrar: Copilot for Agents usa somente artigos cujos metadados correspondem aos valores de filtro. Seus artigos devem ter esses metadados.

  • Acrescentar: Copilot for Agents adiciona o nome do filtro e os valores à pergunta como contexto extra. Isso não limita os artigos. Por exemplo, a pergunta Como faço para redefinir meu roteador? torna-se Como faço para redefinir meu roteador? (modelo do Dispositivo inclui RT-500).

Filtros Bloqueados

Coloque seus filtros no grupo Bloqueado. Copilot for Agents sempre aplica os filtros Bloqueados, usando os valores padrão definidos por você. Os Agentes podem visualizar os filtros Bloqueados em Copilot for Agents, mas não podem alterá-los.

Para saber o que os agentes veem, acesse Filtrar respostas da KB por Knowledge Management (Expert) tags na ajuda do agente.

Propriedades do Filtro de agente

Propriedade Detalhes
agentFilters A chave de nível superior para o bloco. Não diferencia maiúsculas de minúsculas. Por exemplo, agentFilters e AgentFilters funcionam ambos.
Bloqueado O grupo de filtros que Copilot for Agents sempre aplica. Contém filtros, MatchType e ShowFilterUX.
Filtros A lista de filtros no grupo. Cada filtro usa as propriedades nas linhas abaixo.
nome Obrigatório. string. O nome do filtro que os agentes veem. Em modo Acrescentar, o nome também é adicionado à pergunta.
modo Obrigatório. Valores permitidos: Acrescentar, Filtrar. Filtrar limita artigos por metadados. Acrescentar adiciona o nome e os valores à pergunta como contexto extra. Se o modo estiver ausente ou em branco, Copilot for Agents o trata como Filtrar.
datatype O tipo de dado que o filtro usa. Valores permitidos: ListSingle, ListMulti, Numérico, string.
listItems Lista de strings. Os valores disponíveis para este filtro. Obrigatório quando datatype for ListSingle ou ListMulti.
listDefault Opcional. Lista de strings. Os valores que são selecionados por padrão. Para filtros bloqueados, Copilot for Agents sempre usa esses valores.
default Para filtros Numéricos e de string, o valor padrão.
mdaKey Obrigatório. string. A chave de metadados em Knowledge Hub que o filtro verifica.
mdaOperator Obrigatório. Valores permitidos: Contém, Em, igual a. igual a: o valor do artigo corresponde ao valor do filtro. Em: o valor do artigo é um dos valores do filtro. Contém: o valor do artigo inclui o valor do filtro.
MatchType Opcional. Valores permitidos: Any, All. padrão: Qualquer. Qualquer: um artigo pode corresponder a qualquer filtro do grupo. todos: um artigo deve corresponder a todos os filtros do grupo.
ShowFilterUX Opcional. Valores permitidos: Sim, Não. padrão: Sim. Sim: os agentes podem exibir os valores do filtro Bloqueado em Copilot for Agents. Não: os agentes não veem os valores do filtro Bloqueado.
secondaryAgentFilters Opcional. Filtros para respostas secundárias da KB. Usa o mesmo formato de agentFilters. Aplica-se somente quando a opção Enable Secondary KB Answers está ativada no perfil. Se este bloco não estiver presente, Copilot for Agents usa o bloco secondaryExpertTags, se o seu script tiver um.

Adicionar filtros de Agente ao Seu script

  1. No Studio, abra o script que estiver configurando para o Copilot for Agents.

  2. Se ainda não o fez, adicione uma ação AGENT ASSIST após ONANSWER ou ONASSIGNMENT.

  3. Adicione uma ação SNIPPET antes da ação AGENT ASSIST.

  4. Na ação SNIPPET, adicione código que constrói seu JSON agentFilters e o atribui a uma variável. Use o snippet de código de Parâmetros de script como modelo.

  5. Selecione a ação AGENT ASSIST.

  6. No campo scriptParams, insira o nome da variável que contém o JSON. Insira somente o nome da variável, sem chaves ou JSON. Saiba mais sobre a propriedade scriptParams.

  7. Salve o seu script.