Configurar Prompt de AI para Copilot for Agents respostas na BDC

Você pode usar NiCE CXone GenAI Prompts para controlar o prompt que Copilot for Agents usa para criar uma resposta de KB. Isso permite que você controle o idioma, o tom e o tamanho da resposta de KB. Depois de concluir a configuração do prompt, você pode inserir manualmente artigos para testar as configurações. Se não estiver satisfeito com a resposta gerada no teste, você pode continuar a refinar suas configurações até ficar satisfeito. Depois disso, você pode publicar o prompt para disponibilizá-lo para seleção dentro do perfil Copilot for Agents na página Config do Copilot for Agents.

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: 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 de respostas da KB (Knowledge Base) 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 Perfis expanda Copilot for Agents > KB Answer.

  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 guia Prompt Configuration, ajuste os valores para estes campos conforme necessário:

    • Quem é a persona?

    • Qual é o idioma do resumo?

    • Qual é o tom do resumo?

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

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

  4. Clique em Publicar Prompt.

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.

Adicionar Consultas para Testando

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

Todos os artigos que você adicionar à tabela são incluídos na resposta de teste.

  1. Clique na guia Consultas.

  2. Enter o KB ID da base de conhecimento que você deseja usar para gerar respostas de consulta.

  3. Clique no botão adicionar + ao lado da caixa de texto Consulta para adicionar consultas.

Você pode adicionar até 5 consultas.

Usar Variáveis em Prompts do Copilot

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

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

Use essas variáveis somente para testar 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, Enter um nome de Variável claro e descritivo que corresponda à forma como os dados são referenciados em seu Prompt. Por exemplo, ANI ou Direção da chamada.

    A destaque de variável no editor de Prompt diferencia maiúsculas de minúsculas. Por exemplo, se o nome da variável for ANI, somente ANI é destacado. ANI ou ANI são tratados como valores diferentes e não são destacados.

  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 as 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ê deseja adicionar.

    A tabela não suporta matrizes.

Editar uma variável

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

  • As alterações são salvo 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 o tempo de 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 em seus 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 com segurança 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 de forma segura 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 do cabeçalho

    • Geração de registro de data/hora

    • Estrutura de dados de contexto

    • Serialização JSON

    • Lógica de envio de API

  4. Dentro do script, adicione suas variáveis personalizadas na seção contextData designada. Quaisquer variáveis adicionadas aqui ficam disponíveis para Copilot em tempo de execução.

  5. Use um Snippet ou a ação apropriada para fazer o POST da carga útil na API de Contexto da Interação. Copilot consome automaticamente os valores e os disponibiliza em modelos de Prompt.

  6. Em seu perfil Copilot, faça referência a variáveis usando chaves duplas. Por exemplo, {{CustomerName} }, {{ProductCategory} } ou {{ReasonForCall} }. Quando o script envia esses valores em tempo de execução, Copilot os injeta no prompt e gera uma resposta da KB sensível ao contexto.

Testar e Publicar o Prompt

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

Depois de configurar as configurações do prompt e adicionar consultas, você pode testar seu prompt. Isso ajudará você a ver como fica o texto gerado pelo AI e lhe dará a oportunidade de refinar suas configurações. Publicando o prompt o torna disponível tanto para outros verem quanto para seleção no perfil Copilot for Agents na página Copilot for Agents Config.

  1. Quando estiver feliz com a personalização das suas consultas e do Prompt, clique em Test Prompt.

  2. Revise as Copilot for Agents respostas de KB geradas para as consultas e o knowledge hub fornecidos. Se não estiver satisfeito com o resultado, ajuste as configurações de configuração do prompt e tente novamente. Continue testando as consultas e ajustando suas configurações até estar satisfeito com a resposta de consulta que o seu prompt está gerando.

  3. Clique em Publicar Prompt.

Quando você testa o Prompt, está fazendo isso antes da criação de um perfil Copilot. Isso significa que as respostas são geradas usando a configuração de conhecimento padrão Copilot. Como resultado, a saída exibida durante o teste pode ser diferente da experiência dos usuários quando o Prompt for utilizado em um perfil Copilot for Agents totalmente configurado, que pode incluir configurações personalizadas, permissões ou acesso a fontes de conhecimento adicionais.

Selecione o Prompt em Copilot for Agents

Após publicar o perfil de prompt, você pode selecioná-lo no aplicativo Copilot for AgentsAgent Assist Hub.

  1. Ainda no aplicativo geral, vá até AI Studio > Profiles.
  2. Selecione o perfil Copilot que deseja modificar ou clique em Adicionar Perfil Copilot para criar um novo. Siga estas instruções se precisar configurar o perfil inteiro.
  3. Clique na guia Conhecimento. Selecione Knowledge Hub como sua Fonte de Conhecimento e, em seguida, ative Enable KB Answers. No menu suspenso KB Answer Prompt na seção Primary KB Answer Configuration, selecione o perfil de prompt que deseja usar.
  4. Clique em Salvar.