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.
Esta tabela mostra os LLMs entre os quais você pode escolher, juntamente com uma classificação de 1 a 10 para velocidade, precisão, tratamento de complexidade e resistência a alucinações. 1 é sempre a pontuação mais baixa e 10 é sempre a pontuação mais alta. Uma pontuação alta é desejável para velocidade, precisão e tratamento de complexidade, mas não para custo e resistência a alucinações.
-
Esta tabela lista somente os modelos LLM que NiCE CXone verificou para este caso de uso. A lista suspensa LLM Model no aplicativo pode mostrar modelos adicionais que ainda não foram verificados por NiCE CXone; na lista suspensa, um ícone
ao lado de um modelo indica que ele foi verificado por NiCE CXone. Você pode selecionar qualquer modelo listado, mas, se escolher um que não esteja nesta tabela, testar esse modelo para seu caso de uso específico é de sua responsabilidade. -
Padrão do NiCE não é um modelo fixo — ele aponta para o modelo que NiCE CXone atualmente recomenda para esse tipo de prompt, e esse modelo subjacente pode mudar ao longo do tempo. Por esse motivo, padrão do NiCE não está listado como uma linha separada na tabela abaixo.
-
Além disso, os perfis que anteriormente usavam Nova Pro como padrão agora podem exibir NiCE Default em vez disso, sem alteração funcional.
| Modelo LLM | Velocidade | Precisão | Atendimento de complexidade | Resistência a alucinações | notes |
|---|---|---|---|---|---|
| Nova Micro | 10 | 6 | 5 | 6 | Leve, baixa latência; raciocínio limitado. |
|
Nova Lite |
9 |
7 | 6 | 7 | Inteligência superior em comparação ao Micro; ainda leve e rápido. |
| Nova Pro | 8 | 8 | 8 | 8 | Bom equilíbrio entre inteligência, raciocínio e velocidade. |
| Claude 4.5 Haiku | 8 | 8 | 7 | 8 | Precisão e raciocínio sólidos; adequado para casos de uso focados em eficiência. |
| Claude 4.5 Sonnet | 7 | 9 | 9 | 9 | Inteligência e raciocínio de nível flagship. |
| Claude 3 Haiku (Descontinuado) | 8 | 7 | 6 | 7 | Confiável e eficiente para sua época. Incluído para fins de consistência, mas outros modelos provavelmente são uma escolha melhor para aplicativos modernos. |
| Claude 3.5 Haiku (Descontinuado) | 8 | 8 | 7 | 8 | Alta precisão e raciocínio; adequado para casos de uso focados em eficiência. |
| Claude 3.5 V2 Sonnet (Descontinuado) | 7 | 9 | 9 | 9 | Inteligência e raciocínio de nível emblemático. |
Complete cada uma dessas tarefas na ordem indicada.
Lançamento GenAI Prompts
-
Clique no seletor de aplicativos
. -
Em geral, selecione AI Studio.
-
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.
-
Na árvore Perfis expanda Copilot for Agents > KB Answer.
-
Crie um novo perfil. Você pode fazer isso de uma das duas formas a seguir:
-
Crie um novo perfil em branco. Para fazer isso, clique no ícone de adição
próximo ao grupo AutoSummary. O novo perfil aparece na parte inferior da lista. -
Duplicar um perfil existente.
-
Clique no ícone de pontos sobrepostos
ao lado do perfil existente que deseja copiar e selecione Duplicate. -
Renomeie a cópia localizando-a na parte inferior dos perfis de AutoSummary, clicando no ícone de pontos empilhados
e selecionando renomear. Enter o novo nome DO perfil e clique na marca de seleção
para salvá-lo.
-
-
-
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?
Saiba mais sobre os campos nesta etapa
Campo Detalhes Quem é a persona? Uma descrição da persona que você deseja que AI assuma ao gerar o resumo.
Qual é o idioma do resumo? O idioma no qual o resumo aparece. Você pode escolher entre estas opções:
-
Inglês
-
Português
Este campo afeta somente o idioma do conteúdo gerado.
Qual é o tom do resumo? O tom do resumo entre estas opções:
-
Formal
-
Informal
-
Casual
Quais são as instruções para o resumo A informação que você deseja que o resumo inclua e o formato que você deseja para ela.
Importante: O campo Qual é o idioma do resumo? afeta somente o idioma do resumo gerado. Você deve inserir estas instruções em inglês.
Qual é o comprimento máx. do resumo? O comprimento máximo do resumo entre estas opções:
-
Curto (1 - 50) palavras
-
Médio (51 - 100) palavras
-
Long (101 - 200) palavras
-
Extra longo (201 - 250) palavras
-
Estendido (251 - 500) palavras
Os modelos de linguagem grande tentam seguir o tamanho máximo selecionado, mas o resumo gerado pode ser um pouco mais longo ou mais curto do que o alcance solicitado. Isso pode ser mais perceptível em tamanhos menores. Para mais informações, consulte Sobre o comportamento do tamanho da resposta de GenAI Prompts.
-
-
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.
-
Clique na guia Consultas.
-
Enter o KB ID da base de conhecimento que você deseja usar para gerar respostas de consulta.
-
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.
-
Clique na guia Variáveis ao lado de Prompt Configuration e Consultas.
-
Na guia Variáveis, clique em Adicionar.
-
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.
-
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.
-
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:
-
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.
-
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.
-
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
-
-
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.
-
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.
-
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.
-
Quando estiver feliz com a personalização das suas consultas e do Prompt, clique em Test Prompt.
-
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.
-
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.
- Ainda no aplicativo geral, vá até AI Studio > Profiles.
- 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.
- 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.
- Clique em Salvar.