Configurar o Prompt de AI para Copilot for Agents Automated Summary (AutoSummary)

Este recurso oferece suporte a Copilot for Agents e Copilot Automated Summary (AutoSummary). O termo Copilot for Agents às vezes é usado para se referir a ambos, exceto quando indicado de outra forma.

Você pode usar NiCE CXone GenAI Prompts para controlar o Prompt que Copilot for Agents usa para criar autosummaries. Isso permite controlar a duração, o tom e as instruções do autosummary. Depois de concluir a configuração do Prompt, você pode importar ou inserir até cinco transcrições para testar as configurações. Se não estiver satisfeito com a resposta gerada no teste, você pode continuar a ajustar suas configurações até ficar satisfeito. Depois disso, você pode publicar o Prompt para torná-lo disponível para seleção dentro do perfil Copilot for Agents na página Copilot for Agents Config.

Todos os usuários agora podem abrir a lista suspensa modelo LLM. Usuários com uma licença Prompt editor Advanced podem selecionar qualquer modelo na lista; outros usuários estão limitados aos modelos padrão. A própria lista é agrupada por modelos padrão e premium, com os modelos verificados por NiCE CXone exibidos primeiro e o rest listado em ordem alfabética.

Se você não tem a licença Prompt editor Advanced, os modelos premium aparecem na lista, mas você não pode selecioná-los.

Para ver quais modelos são premium, abra o LLM Manager.

Os modelos Premium são cobrados com base no uso. Sua organização é cobrada pelo número de tokens que o modelo lê e grava quando um Prompt é executado. Para usar modelos Premium, sua organização precisa do Item de consumo de LLM em seu contrato. Entre em contato com seu representante de conta NiCE CXone para obter informações sobre preços.

NiCE Default está disponível como uma opção de modelo de LLM. Ele representa o modelo que a NiCE CXone atualmente recomenda para esse tipo específico de Prompt. Se um modelo de Prompt oferecer suporte a somente um modelo, NiCE Default é a única opção exibida, e a lista suspensa fica desabilitada. Se um modelo oferecer suporte a múltiplos modelos, NiCE Default aparece junto com eles como uma opção selecionável.

Se o modelo LLM atualmente selecionado para um perfil estiver programado para desativação, NiCE CXone exibe um aviso próximo à lista suspensa LLM Model informando que o modelo será desativado em um número determinado de dias e solicitando que você atualize para um modelo compatível.

Quando um modelo que você usa estiver mais próximo da data de desativação, o NiCE CXone também exibirá uma caixa de diálogo de atualização de LLM quando você abrir o perfil afetado. A caixa de diálogo informa a data em que o modelo muda para o modo de retenção, após a qual o modelo não estará mais acessível, e lembra você de atualizar o LLM e testar e publicar todos os perfis afetados antes dessa data. Selecione Não mostrar esta mensagem novamente para suprimir a caixa de diálogo desse perfil, ou clique em ok para fechá-la.

Se um modelo atingir sua data de desativação e você não tiver selecionado um modelo diferente, NiCE CXone muda automaticamente o perfil para NiCE Default. teste e publique o perfil após essa mudança para confirmar se a saída ainda atende aos seus requisitos.

Complete cada uma dessas tarefas na ordem indicada.

Lançamento GenAI Prompts

  1. Clique no seletor de aplicativos icon of app selector .

  2. Em geral, selecione AI Studio.

  3. Na navegação à esquerda AI Studio, selecione GenAI Prompts.

Criar Perfil de Prompt

Permissões necessárias: iniciar GenAI Prompts, Edição de Acesso a prompts

Você também precisará de uma licença para NiCE CXone Copilot for Agents e o recurso AutoSummary habilitado.

Cada fluxo vem com um perfil padrão. Você pode criar um prompt personalizado utilizando um formulário em branco ou copiando um prompt existente e fazendo edições. Enquanto você está trabalhando no perfil, ele é salvo automaticamente apenas para você. Outras pessoas não podem ver o novo perfil, ou as edições que você está fazendo em um perfil existente, até que você clique em Publish Prompt. Os perfis também não ficam disponíveis para seleção como o prompt ativo até que tenham sido publicados.

Se você criar um novo perfil, mas não o publicar dentro de 30 dias após a edição mais recente, as configurações do perfil na aba Prompt Configuration serão revertidas para os valores padrão. Se você editar um perfil existente, mas não o publicar dentro de 30 dias após a edição mais recente, as alterações na aba Prompt Configuration serão revertidas para as configurações especificadas na versão publicada mais recente.

  1. Na árvore Profiles, expanda Copilot for Agents > Copilot AutoSummary.
  2. Crie um novo perfil. Você pode fazer isso de uma das duas formas a seguir:

    1. Crie um novo perfil em branco. Para fazer isso, clique no ícone de adição Icon: a plus sign próximo ao grupo AutoSummary. O novo perfil aparece na parte inferior da lista.

    2. Duplicar um perfil existente.

      1. Clique no ícone de pontos sobrepostos Icon of three vertical black dots ao lado do perfil existente que deseja copiar e selecione Duplicate.

      2. Renomeie a cópia localizando-a na parte inferior dos perfis de AutoSummary, clicando no ícone de pontos empilhados Icon of three vertical black dots e selecionando renomear. Enter o novo nome DO perfil e clique na marca de seleção Icon of black check mark para salvá-lo.

  3. Na aba Prompt Configuration, ajuste os valores desses campos conforme necessário:

    • Quem é o agente da central de contatos?

    • Quem é o cliente da central de contatos?

    • Qual é o tom do resumo?

    • Qual é o comprimento máx. do resumo?

    • Qual é o idioma do resumo?

    • Quais são as instruções para o resumo?

  4. Limites de Duração do campo GenAI Prompts

    Os campos GenAI Prompts suportam dois tipos de entradas de texto. Cada tipo tem um comprimento máximo definido.

    Tipo DE campo

    Comprimento máximo

    Campos de texto livre (por exemplo, rótulos, descrições de persona) 200 caracteres
    Campos de área de texto (por exemplo, instruções, Prompts longos) 10.000 caracteres

    O tipo DE campo usado depende da configuração do Prompt.

    • Os campos de texto livre são usados para entradas curtas, tais como:

      • Rótulo do agente

      • Rótulo do cliente

      • Descrição de persona

    • Os campos de área de texto são usados para entradas mais longas, como:

      • Instruções

      • Prompts personalizados

    GenAI Prompts exibe dinamicamente o tipo DE campo apropriado com base na configuração do Prompt.

    A Interface exibe um aviso somente quando o comprimento máximo é excedido. Para evitar erros, certifique-se de que suas entradas permaneçam dentro dos limites suportados.

    Sobre o comportamento de tamanho da resposta do GenAI Prompts

    Modelos de linguagem grande (LLMs) tentam seguir instruções para limitar o tamanho de suas respostas. No entanto, a saída real pode, às vezes, ser um pouco mais longa ou mais curta do que o solicitado.

    Esse comportamento é esperado e não é específico de um único modelo ou funcionalidade. Isso ocorre porque:

    • Contagem de palavras: os LLMs geram texto com base em tokens, e não em contagens exatas de palavras. O mapeamento entre tokens e palavras é aproximado.

    • Geração de linguagem natural: O modelo prioriza frases coerentes e naturais. Em alguns casos, a conclusão de uma frase ou ideia pode exceder o intervalo de tamanho solicitado.

    • Prompts ou tópicos Complexos: Quando a interação é complexa, o modelo pode usar mais palavras para incluir os detalhes necessários, mesmo quando solicitado a manter a resposta breve.

    O que esperar

    • O tamanho máximo selecionado (por exemplo, Curto, Médio, Longo) é tratado como uma orientação, não um limite rígido.

    • Pequena variação em torno do alcance selecionado é normal.

    • A variação pode ser mais perceptível ao usar opções de comprimento mais curtas, pois algumas palavras extras causam uma diferença percentual maior.

    Recomendações

    • Use opções de comprimento mais curtas quando desejar resumos concisos e de alto nível.

    • Se Agent Workspace (Agent) ou Supervisor Workspace (Supervisor) exigirem mais detalhes, selecione uma opção de comprimento maior e ajuste as instruções para especificar o que deve ser incluído ou excluído.

    • Revise periodicamente os resumos gerados com seus agentes e supervisores e ajuste a configuração do prompt (instruções, tom e extensão) conforme necessário.

Adicionar transcrições para Testando

Permissões necessárias: iniciar GenAI Prompts, Edição de Acesso a prompts

Importar uma transcrição

  1. Clique na guia Transcrição.

  2. Na área opções de transcrição, no campo tipo de arquivo de Transcrição, selecione Segmento.

  3. Enter o id DO segmento da transcrição que deseja usar na caixa de texto Quais são os ids DO segmento das transcrições?. Clique no botão de adicionar Icon: A plus sign. A nova transcrição aparece na tabela abaixo da caixa de texto.

  4. Clique no ícone de papel e lápis Icon: Lined paper with a pencil in the corner para visualizar e editar a transcrição importada. A transcrição mostra o diálogo do agente em roxo e do contato em azul.

  5. Modifique a transcrição conforme necessário. Você pode realizar qualquer uma das seguintes ações:

    • Clique em + Frase do Agente ou + Frase do cliente na parte superior da janela para adicionar uma nova caixa de diálogo de um determinado tipo. A nova caixa de diálogo do agente ou do contato aparece na parte inferior da transcrição. Enter o diálogo para a função que você selecionou.

    • Adicione outra caixa de diálogo do mesmo tipo (agente ou cliente) selecionando a caixa acima de onde deseja a nova caixa e clicando no ícone de adicionar caixa de diálogo Icon of gray-blue speech bubble with text lines and a plus sign. A nova caixa aparece abaixo da caixa selecionada. Enter o diálogo desejado e, em seguida, clique no ícone de salvar Icon of gray-blue floppy disk .

    • Edite uma caixa de diálogo selecionando a caixa que deseja alterar e clicando no ícone de lápis Icon: a pencil. Faça as alterações necessárias e, em seguida, clique no ícone de salvar Icon of gray-blue floppy disk .

    • Mova as caixas de diálogo para mais acima ou mais abaixo na transcrição selecionando a caixa e clicando no ícone de seta para cima Icon of gray-blue upward-pointing chevron ou no ícone de seta para baixo Icon of gray-blue downward-pointing chevron até que a caixa esteja onde você deseja.

    • Exclua uma caixa de diálogo selecionando a caixa e clicando no ícone de lixeira Icon of gray-blue trash can.

    • Remova todo o diálogo clicando em Clear no canto superior direito da janela.

  6. Continue adicionando diálogo de agente e contato até concluir a transcrição.

  7. Clique no ícone voltar para a Lista de Transcrições para retornar à tabela de transcrições.

  8. Continue adicionando as transcrições que você deseja testar. testar o Prompt usará todas as transcrições que você incluiu na tabela.

Inserir Transcrição Manualmente

  1. Clique na guia Transcrições.

  2. Para o campo Tipo de Transcrição do Arquivo, selecione Nova Transcrição.

  3. Clique em Create New Transcript. Uma nova transcrição aparece na tabela abaixo.

  4. Clique no ícone de papel e lápis Icon: Lined paper with a pencil in the corner.

  5. Modifique a nova transcrição usando as seguintes ações conforme necessário:

    • Clique em + Frase do Agente ou + Frase do cliente na parte superior da janela para adicionar uma nova caixa de diálogo de um determinado tipo. A nova caixa de diálogo do agente ou do contato aparece na parte inferior da transcrição. Enter o diálogo para a função que você selecionou.

    • Adicione outra caixa de diálogo do mesmo tipo (agente ou cliente) selecionando a caixa acima de onde deseja a nova caixa e clicando no ícone de adicionar caixa de diálogo Icon of gray-blue speech bubble with text lines and a plus sign. A nova caixa aparece abaixo da caixa selecionada. Enter o diálogo desejado e, em seguida, clique no ícone de salvar Icon of gray-blue floppy disk .

    • Edite uma caixa de diálogo selecionando a caixa que deseja alterar e clicando no ícone de lápis Icon: a pencil. Faça as alterações necessárias e, em seguida, clique no ícone de salvar Icon of gray-blue floppy disk .

    • Mova as caixas de diálogo para mais acima ou mais abaixo na transcrição selecionando a caixa e clicando no ícone de seta para cima Icon of gray-blue upward-pointing chevron ou no ícone de seta para baixo Icon of gray-blue downward-pointing chevron até que a caixa esteja onde você deseja.

    • Exclua uma caixa de diálogo selecionando a caixa e clicando no ícone de lixeira Icon of gray-blue trash can.

    • Remova todo o diálogo clicando em Clear no canto superior direito da janela.

  6. Continue a adicionar diálogo de agente e contato até concluir a transcrição.

  7. Clique no ícone voltar para a Lista de Transcrições para retornar à tabela de transcrições.

  8. Continue adicionando as transcrições que deseja testar. testar o Prompt utilizará todas as transcrições que você incluiu na tabela.

Use Variáveis em Prompts Copilot

Permissões necessárias: GenAI Prompts, Edição de Acesso a prompts

Use variáveis para definir valores dinâmicos que seu Prompt pode referenciar em tempo de execução.

Use estas variáveis somente para testar o seu prompt no Prompt editor. Elas não afetam nada fora do editor.

  1. Clique na guia Variáveis ao lado de Prompt Configuration e Consultas.

  2. Na guia Variáveis, clique em Adicionar.

  3. Na coluna Variáveis, insira um nome de Variável claro e descritivo que corresponda à forma como os dados são referenciados no seu Prompt. Por exemplo, ANI ou Direção da chamada.

    Variable highlighting in the prompt editor is case sensitive. For example, if the variable name is ANI, only ANI is highlighted. Ani or ani are treated as different values and are not highlighted.

  4. Na coluna Valores, insira o valor a ser atribuído à variável. Por exemplo, 87654321012 para ANI ou inbound para Direção da chamada.

    Somente linhas que contêm tanto um nome de variável quanto um valor são salvas. Linhas com um nome ou valor ausente não são salvas e não aparecem novamente.

  5. Repita essas etapas para quaisquer variáveis adicionais que você queira adicionar.

    A tabela não oferece suporte a arrays.

Editar uma variável

  • Atualize o texto na coluna Variáveis ou Valores conforme necessário.

  • As alterações são Salvas automaticamente.

Remover uma variável

  • Clique no ícone X no final da linha da variável para excluí-la.

Injetar Variáveis em Copilot em tempo de execução Usando Studio

Você pode passar variáveis dinâmicas do seu script Studio para Copilot durante a execução. Essas variáveis fornecem contexto em tempo real, como ANI, marcas de tempo ou dados específicos do cliente, e permitem que Copilot gere respostas mais precisas e personalizadas para cada interação.

Studio envia uma carga útil JSON contendo suas variáveis de tempo de execução para Copilot. Copilot mescla esses valores com o perfil Copilot configurado e os disponibiliza nos modelos de prompt.

Para injetar variáveis, faça o seguinte:

  1. Gere um token de acesso. Para gerar um token de acesso, consulte o guia de Introdução no portal NiCE CXone Developer. Esse token é necessário para chamar de forma segura a API do Gerenciador de prompts ou qualquer API personalizada que acione o prompt.

  2. Crie uma conexão no Integration Hub para que o CXone possa enviar a solicitação de API ao serviço Interaction Context. Essa conexão permite que Studio se comunique com a API com segurança e garante que suas variáveis de tempo de execução cheguem a Copilot sem configuração adicional.

  3. Use o script fornecido em Using Variables in Studio para gerar e enviar a carga útil de Variável necessária durante a execução. Este script inclui:

    • Preparação de cabeçalho

    • Geração de registro de data/hora

    • Estrutura de dados de contexto

    • Serialização JSON

    • Lógica de submissão de API

  4. Dentro do script, adicione suas variáveis personalizadas na seção contextData designada. Todas as variáveis adicionadas aqui ficam disponíveis para Copilot no momento da execução.

  5. Use um Snippet ou a ação apropriada para fazer o POST da carga útil para a API Interaction Context. Copilot consome automaticamente os valores e os torna disponíveis nos modelos de Prompt.

  6. No seu perfil Copilot, referencie variáveis usando chaves duplas. Por exemplo, {{CustomerName} }, {{AccountID} } ou {{ReasonForCall} }. Quando o script envia esses valores em tempo de execução, Copilot os injeta no prompt e gera uma resposta com reconhecimento de contexto.

Testar e Publicar o Prompt

Permissões necessárias: iniciar GenAI Prompts, Editar Acesso a prompts

Depois de configurar as configurações do prompt e adicionar uma transcrição, você pode testar seu prompt com essa transcrição. Isso ajudará você a ver como fica o texto gerado por AI e lhe dará a oportunidade de refinar suas configurações. Publicar o prompt o torna disponível tanto para outras pessoas verem quanto para seleção em perfis de Copilot for Agents.

  1. Quando estiver satisfeito com sua transcrição, clique em Testar Resposta.

  2. Revise a resposta gerada para o prompt e a transcrição personalizados fornecidos por você. Se você não estiver satisfeito com o resultado, ajuste as configurações de configuração do prompt e tente novamente. Continue testando a resposta e ajustando suas configurações até estar satisfeito com o autosummary que o seu prompt está gerando.

  3. Clique em Publicar Prompt.

Selecione o Prompt em Copilot for Agents

Depois de publicar o perfil de Prompt, você pode selecioná-lo na Copilot for Agents perfil da página Config.

  1. Clique no seletor de aplicativos icon of app selector e selecioneGeral.
  2. No menu à esquerda, navegue até AI Studio > Perfis.
  3. Na lista de perfis Copilot à esquerda, selecione o perfil Copilot for Agents ao qual deseja aplicar o perfil de prompt do AutoSummary. Se ainda não tiver um, clique em Adicionar Copilot perfil e siga estas instruções para criar um.
  4. Na aba Configuração, role para baixo até a seção AI Configurações de Resposta e ative Resumo final. No menu suspenso Perfil de Resumo final, selecione o perfil de prompt que deseja usar.
  5. Clique em Salvar.