Adicionar Nó Recuperar Conhecimento em AI Agents (Cognigy)

Os nós em um fluxo AI Agents (Cognigy) representam ações ou lógica que seu agente virtual executa. Editar um nó permite configurar suas propriedades, atualizar parâmetros ou ajustar seu comportamento dentro do fluxo.

O nó Recuperar Conhecimento permite que o AI Agents (Cognigy) busque informações relevantes de fontes de conhecimento conectadas, como Knowledge Hub, durante uma interação. Ele processa a consulta do usuário, pesquisa na base de conhecimento configurada e retorna o conteúdo mais relevante para gerar respostas precisas e com reconhecimento de contexto.

Para um determinado fluxo, você pode configurar somente um nó Recuperar Conhecimento, que pode ser vinculado a uma única base de conhecimento Knowledge Hub. A configuração de múltiplos nós de conhecimento no mesmo fluxo não é compatível atualmente.

Iniciar AI Agents (Cognigy) através de NiCE CXone

  1. Clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background, vá para geral e selecione Automação.

  2. Dentro de Automação, selecione Cognigy AI.

Adicionar Nó de Recuperar Conhecimento em AI Agents (Cognigy)

  1. Em AI Agents (Cognigy), selecione Build > Fluxos.

  2. Na lista, selecione o Fluxo que deseja editar, por exemplo, SayHelloAndHandover.

  3. Se o projeto contiver múltiplos fluxos, selecione Main Flow no seletor de Fluxo na parte superior. O fluxo é aberto na visualização Chart, onde você pode adicionar e configurar nós.

  4. No editor Fluxo, selecione o ícone de mais (+) onde o nó Recuperar Conhecimento deve ser adicionado.

  5. Selecione a aba Por Função > categoria CXone > Recuperar Conhecimento. O nó é adicionado ao seu fluxo.

  6. Clique no nó para abrir o painel Editar Nó no lado direito.

  7. O painel Editar Nó exibe campos configuráveis específicos do tipo de nó.

  8. Para um nó Recuperar Conhecimento, você verá os seguintes campos:

Nome do campo

Definição

Notas

ID do Knowledgehub Insira o ID de Knowledge Hub de AI Studio’s Knowledge Hub. Cada base de conhecimento tem um ID de Knowledge Hub exclusivo que você pode copiar e colar aqui. Esse ID determina qual fonte de conhecimento será usada para recuperar as respostas.
  1. Navegue até AI Studio > Knowledge Hub.

  2. Selecione o ícone Mais ações Ícone de mais opções que abre um menu com ações adicionais para o item selecionado, como copiar ID, excluir, desativar ou definir como ponto de entrada ao lado da base de conhecimento apropriada.

  3. No menu, selecione a opção Copiar ID da KB.

Consulta de entrada Indica a pergunta do usuário final que será usada para pesquisar uma resposta na base de conhecimento. ``` ```
Consulta
Consulta Persona Descreve a persona que você deseja que AI adote ao gerar o resumo. Não use este campo se estiver usando o Prompt editor e tiver definido um Id do perfil do Gerenciador de prompts, pois o Gerenciador de prompts já possui uma persona configurada nele.
Idioma de Consulta Selecione o idioma do resumo gerado. Essa configuração afeta somente o idioma de saída.

Selecione o idioma no qual deseja que o LLM responda.

O campo Idioma da Consulta para selecionar o idioma em que o LLM responde

Knowledge Hub
Filtrar Especifique critérios para selecionar quais artigos de conhecimento devem ser incluídos no Knowledge Hub, com base em seus metadados.

Define filtros de recuperação baseados em JSON que aplicam condições de atributo para restringir quais documentos são retornados, com Suporte a condições únicas e grupos lógicos aninhados usando andAll/orAll. Suporta múltiplos operadores (É igual a, notEquals, comparações numéricas, in/notIn, startsWith) sobre atributos de string, número e booleano, para que você possa criar filtros simples ou complexos como,

{
"equals":
{
"key":"PageRestriction",
"value":"Public"
}
}

Para obter detalhes, consulte a seção Operador de Filtrar.

Máx Artigos Define o número máximo de artigos a serem recuperados da base de conhecimento para gerar a resposta.  
Prompt Cria um prompt personalizado para controlar o tom e fornecer contexto para sua base de conhecimento. Não use esse campo se você estiver usando o Prompt editor e tiver definido um "Id do perfil do Gerenciador de prompts".  
ARN do Model Selecione o modelo de LLM a ser usado para gerar a resposta de conhecimento.

As opções disponíveis são amazon.nova-pro-v1:0, amazon.nova-lite-v1:0 e anthropic.claude-haiku-4-5-20251001-v1:0.

Se você estiver usando o ID do Gerenciador de prompts, não será necessário usar o ARN do modelo neste campo, pois os gerenciadores de prompts já têm os seguintes modelos selecionados:

  • Nova Pro

  • Nova Lite

  • Para traduzir este texto, preciso que você forneça o conteúdo do segmento que deseja traduzir. Observo que a mensagem contém apenas instruções e contexto, mas não inclui o texto-fonte em inglês a ser traduzido (o valor "x" referenciado). Por favor, envie o segmento de texto original para que eu possa realizar a tradução conforme as regras especificadas.

  • Peço desculpas, mas não há texto fornecido para tradução nesta solicitação. Por favor, forneça o segmento de texto em inglês que precisa ser traduzido para o português brasileiro (pt-BR), seguindo as regras e o contexto especificados.

Respostas na BDC
Id do perfil do gerenciador de prompts Enter o id do perfil do Gerenciador de prompts do AI Studio. Isso permite que você gerencie e edite seu prompt diretamente no Gerenciador de prompts.
  1. Navegue até AI Studio > GenAI Prompts.

  2. Abra Copilot for Agents > respostas na BDC.

  3. Selecione o ícone Mais ações More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point próximo ao perfil de prompt do KB Answer apropriado.

  4. Selecione Copy ID no menu.

Palavras Máximas para respostas Defina o comprimento máximo para a resposta de conhecimento gerada.  
Max Links Define o número máximo de links de citação a serem incluídos na resposta gerada.  
Armazenamento de resultado
Armazenamento de resultado Especificar onde o conteúdo recuperado deve ser armazenado.
Nome da variável Insira o nome da variável em que o conteúdo armazenado será salvo.

A resposta do LLM é armazenada nessa variável, e os valores são exibidos no chat com base nas configurações mostradas na captura de tela.

Nó Say:

``` As configurações de Output Type no nó de configuração Retrieve Knowledge ```

Tratamento de erro
Registrar no Sistema Habilitar o registro de erros nos logs do sistema. Os registros podem ser visualizados na página Logs do seu Projeto. O parâmetro está inativo por padrão.
Selecionar Abordagem de Tratamento de Erro Defina como lidar com erros que ocorrem durante a solicitação.

Com base no seu requisito, você pode selecionar uma das seguintes opções de Tratamento de Erro:

  • Parar Execução do Fluxo: Encerra a execução do Fluxo atual.

  • Continuar Execução do Fluxo: Permite que o Fluxo continue sendo executado, ignorando o erro e avançando para as próximas etapas.

  • Ir para o Nó: Redireciona o Workflow para um Nó específico no Fluxo, o que pode ser útil para recuperação de erro ou tratamento de erro personalizado.

Mensagem de erro (Opcional) Insira uma mensagem personalizada para exibir quando ocorrer um erro. Este campo é opcional. Esse parâmetro fica ativo quando a opção Continue Flow Execution em Select Error Handling Approach é selecionada. mensagem Opcional para gerar saída se a recuperação de conhecimento falhar.
Configurações de depurar
Configurações de depurar Por motivos de desempenho, o registro de depuração só estará ativo quando estiver testando no Painel de interação e quando o Modo de depuração estiver ativado nele.  
Log do Corpo da Solicitação Habilite ou desabilite o registro do corpo da solicitação enviada ao Knowledge Hub.  
Log Solicitação Habilite ou desabilite o registro do tempo necessário para a conclusão da solicitação.  
Latency Mocking Insira o código fictício a ser usado quando a simulação (mocking) estiver ativada para o Nó. Mocking permite alterar o comportamento de um Nó substituindo sua lógica por código mock, sem alterar as configurações originais do Nó. Essa abordagem permite manter a lógica original do Fluxo e simular comportamentos de Nó para testar condições específicas do Fluxo no Simulador, no Painel de Interação e em Endpoints, sem reconfigurar os Nós. Mocking fornece o campo Mock Code nas configurações de cada Nó no editor de Nó. Este campo oferece suporte a código JavaScript para acessar os objetos Entrada, Contexto e Perfil, além da função API.say. O código mock substitui completamente a lógica de execução do Nó configurado em tempo de execução. Para obter detalhes, consulte o tema Mocking.
Configurações
Rótulo Define um nome personalizado para o Nó.  
Comentar Campo de texto livre.  
Analytics Etapa A Etapa é registrada no terminal OData do Cognigy Insights e Cognigy.AI, após a passagem do Nó  

Gerenciar Opções do Nó no Painel Editar Nó

Use o menu Mais opções More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point no painel Editar Nó para realizar ações adicionais em um nó. Essas ações ajudam você a copiar identificadores, gerenciar o status do nó ou definir o ponto de partida de um fluxo.

Copiar um ID de Nó

Copie o identificador exclusivo de um nó para usar em Chamadas de API ou depuração.

  1. No painel Editar Nó, selecione o nó desejado.

  2. Clique no ícone Mais opções Ícone Mais opções que abre um menu com ações adicionais para o item selecionado, como copiar ID, excluir, desativar ou definir como ponto de entrada.

  3. Selecione Copiar ID do Nó.

    O ID do nó é copiado para sua área de transferência.

Excluir um Nó

Remover o nó do fluxo permanentemente.

  1. No painel Editar Nó, selecione o nó que deseja excluir.

  2. Clique no ícone Mais opções Ícone Mais opções que abre um menu com ações adicionais para o item selecionado, como copiar ID, excluir, desativar ou definir como ponto de entrada.

  3. Selecione excluir.

    Confirme a exclusão quando solicitado.

    Excluindo um nó, essa ação não pode ser desfeita. Recrie o nó, se necessário.

Desativar um Nó

Desative temporariamente um nó sem removê-lo do fluxo.

  1. No painel Editar Nó, selecione o nó que deseja desabilitar.

  2. Clique no ícone Mais opções Ícone Mais opções que abre um menu com ações adicionais para o item selecionado, como copiar ID, excluir, desativar ou definir como ponto de entrada .

  3. Selecione Desabilitar.

    O nó permanece no fluxo, mas não será executado até que você o ative novamente.

Definir um Nó como ponto de entrada

Defina um nó como o ponto de partida para o fluxo.

  1. No painel Editar Nó, selecione o nó que deseja definir como ponto de entrada.

  2. Clique no Mais opções Ícone Mais opções que abre um menu com ações adicionais para o item selecionado, como copiar ID, excluir, desativar ou definir como ponto de entrada ícone.

  3. Selecione set Entrypoint.

    O fluxo será iniciado a partir deste nó em vez do nó de início padrão.

Operador filtrar

Esta seção aborda a sintaxe generalizada para operadores únicos e múltiplos:

  • Condição única

{"<operator>": {
"key": "<metadata-key>",
"value": <value>
}
}
  • Múltiplas Condições — AND (todas devem corresponder)

{
"andAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
  • Múltiplas Condições — OR (pelo menos uma deve corresponder)

{
"orAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
  • Aninhado — AND com OR dentro (lógica Complexa)

{
"andAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{
"orAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
]
}
  • Operadores válidos — Substitua <operator> por um de:

Símbolo Console

Nome do Filtrar de API (<operator>)

Tipo de dados suportado

Inglês simples

=

Igual a Comando, Número, Booleano Es exatamente igual a

!=

não é igual a Comando, Número, Booleano Não é diferente de

^

startsWith Comando, Número, Booleano Começa com

>

greaterThan Número Is greater than

>=

Maior ou igual Número É maior ou igual a

<

lessThan Número É menor do que

<=

menor ou igual a Número É menor do que ou igual a

:

em Comando list É um dos itens da lista

!:

notIn Lista de comandos Não está em nenhuma das listas
  • Referência de Substituição

placeholder Substituir por

<operator>

Qualquer Nome de Filtrar de API da tabela acima

<metadata-key>

Uri, Título, PageRestriction, Tags, etc. (diferencia maiúsculas de minúsculas)

<valor> (comando)

"Público"

<value> (Number)

2023

<value> (Booleano)

verdadeiro ou falso

<value> (lista de comando)

["value1", "value2"] — somente para in e notIn
  • <metadata-key>: Define em Knowledge Hub. Esse valor pode variar de acordo com o conector KMS.

  • <Value>: Deve corresponder ao valor enviado pelo KMS.

andAll e orAll exigem um mínimo de duas condições dentro da matriz.

  • Referência de Operadores válidos

Nome do Filtrar de API

(<operador>)

Tipo de dados suportado Significado

equals

Comando, Número, Booleano É exatamente igual a

Não é igual

Comando, Número, Booleano Não é igual a

startsWith

String, Number, Boolean Começa com

greaterThan

Número Is greater than

Maior ou igual a

Número

É maior ou igual a

Menor que

Número É menor do que

menor ou igual

Número É menor do que ou igual a

em

Lista de comandos É um dos da lista

notIn

Lista de comando Não está em nenhuma da lista