É no ecrã Templates da Cris ( Menu Supervisor > Framework PHC > Templates da Cris ) onde é feita a configuração de comandos, instruções, contextos e dados a serem enviados para a assistente Cris. Este ecrã permite a personalização de prompts para diferentes cenários nos ecrãs de registos, agenda e análises avançadas, e agora também está disponível nos Ecrãs de Utilizador.
Para conhecer todas as funcionalidades inerentes a este ecrã, iremos começar por explicar os campos que compõem os Templates da Cris:
Resumo: Este campo é de preenchimento obrigatório e permite escrever um pequeno descritivo e nome do template, caso o campoTexto para botão não esteja preenchido..
Grupo: É possível definir um grupo de forma a agrupar os diversos templates por temas. Pode selecionar um grupo já existente ou criar um novo.
Texto para botão: Permite preencher o nome do template que irá ser apresentado nos ecrãs para seleção. Se este campo não estiver preenchido a informação que irá apresentar nos ecrãs de seleção será a informação preenchida no campo Resumo.
Inativo: Ao ativar este campo, o template da Cris fica inativo e deixa de ser apresentado nos locais.
Dados Principais
Local para uso deste template: Análise avançada (apenas disponível nas gamas Advanced e Enterprise) e Ecrã.
Este é o template por defeito para o local definido: Permite selecionar o template padrão para o local definido, utilizado no botão "Consultar Cris".
Template disponível quando o ecrã não tem nenhum registo selecionado (fim de ficheiro): Ao ativar esta opção o template é apresentado em modo fim de ficheiro no ecrã selecionado (apenas disponível para o local Ecrã).
Ordem: É possível definir a ordem de apresentação dos templates associados ao local definido.
Primeiro ordena pelo campo "Ordem" e segundo ordena pelo campo "Resumo" por ordem alfabética. Quando o valor é "0" os templates são apresentados no fim da lista e passam a ser ordenados pela ordem alfabética do "Resumo".
Acesso: Define as permissões de acesso ao template.
Pergunta para a Cris
Conteúdo da pergunta: Este campo é de preenchimento obrigatório com a pergunta a efetuar à Cris.
Dicas
É possível usar variáveis na pergunta relativas aos campos da tabela principal do ecrã escolhido no separador "Dados principais" (por exemplo: se ecrã de "CL - Clientes" usar #cl.nome# para indicar que nesse sitio deseja incluir o valor do nome do cliente, correspondente ao registo que estiver visível no ecrã de clientes quando utilizar este template a partir do mesmo).
Tipo de resposta: Pré-preenchido com o valor dos parâmetros gerais, mas personalizável com "Objetiva", "Neutra" e "Criativa".
Tamanho da resposta: Pré-preenchido com o valor dos parâmetros gerais, mas personalizável com "Curta", "Média" e "Longa".
Modelo da Cris: Pré-preenchido com o valor dos parâmetros gerais, mas personalizável com "Legado", "Padrão" e "Especial".
Contexto da pergunta: Permite adicionar texto ao contexto do parâmetro geral.
Ignorar o contexto definido nos parâmetros gerais do sistema: Ao ativar esta opção o contexto da pergunta definido no parâmetro geral é substituído pelo contexto preenchido no campo anterior.
Dados a Enviar
Este separador só fica disponível ao ativar a opção "Ecrã" nos "Dados principais" e permite selecionar o tipo de dados a enviar do ecrã escolhido: Listagem rápida de utilizador (listagem original ou listagem de utilizador) e Campos disponíveis (tabela principal).
Os campos selecionados podem ter como base "Expressão T-SQL" ou "Expressão XBase", sendo que, se as duas estiverem preenchidas, é a expressão xbase que prevalece. Caso a expressão xbase tenha um resultado vazio então será utilizado o resultado da expressão t-sql.
Envia adicionalmente todos os dados presentes no ecrã: Por defeito o campo fica ativo e desta forma os dados do ecrã são adicionados à listagem rápida ou campos selecionados.
Dicas
Este separador fica indisponível ao escolher o ecrã "SMXAGEN" (Agenda de marcações), por não existirem listagens rápidas nem campos atribuídos a uma tabela principal associada ao ecrã.
Dados Extra
(Apenas disponível nas gamas Advanced e Enterprise)
Os dados extra são obtidos a partir de xbase: Ao ativar este campo é possível criar uma "Expressão XBase" para retornar uma string (apenas disponível na gama Enterprise).
Dicas
É possível usar as variáveis relativas aos campos da tabela principal do ecrã escolhido no separador "Dados principais", as variáveis de sistema, a variável #stamp# que guarda o stamp de ligação correspondente ao registo que estiver visível no ecrã e a variável #genaiquestion# que guarda a pergunta do utilizador.
No final do código deve-se utilizar a keyword "Return" seguida da variável que guarda os dados que se pretende enviar para a Cris analisar e responder às questões do utilizador com base nesses dados.
Na grelha é possível introduzir linhas com análises avançadas ou expressões t-sql para obter dados extra. É constituída pelas seguintes colunas:
- Tipo: Expressão T-SQL ou Análise avançada;
- Análise: Lista das análises avançadas do utilizador;
- Expressão de retorno: Expressão T-SQL;
- Descrição para os dados: Descrição para identificar os dados retornados pela expressão t-sql ou análise avançada;
- Inativo: Ao ativar esta opção na linha, o conteúdo não é utilizado para enviar dados.
Eventos
(Apenas disponível na gama Enterprise)
Neste separador é possibilitado ao implementador personalizar e manipular a resposta da Cris. Esta personalização, disponível através de uma expressão de código XBase no novo separador Eventos nos Templates da Cris, torna-se especialmente útil para ajustar respostas, integrar ligações para documentação adicional, ou estruturar a resposta da Cris de uma forma mais alinhada ao contexto do cliente.
Recursos Disponíveis no Código XBase:
1- Variáveis e Campos Disponíveis:
#genaianswer#: Guarda a resposta original da Cris.
#stamp#: Contém o ID do registo atual.
Campos específicos do registo que invocou o assistente (por exemplo, CL.NOME para o nome do cliente).
Variáveis de sistema, como m.m_chnome, que guarda o nome do utilizador da sessão.
2- Retorno de Resposta: O código deve retornar uma string que servirá como resposta personalizada da Cris.
3- Botão de Ajuda “?”: Clicando no botão “?” do lado direito, no separador "Eventos", o utilizador pode visualizar informações detalhadas sobre a sintaxe e utilização da expressão XBase.
Dicas
1 - Na lista das análises não é apresentada a análise selecionada nos "Dados principais";
2 - Na lista das análises não são apresentadas as análises que estejam associadas a ecrãs diferentes (Menu Supervisor > Configuração de Análises > Análises Avançadas do utilizador > separador "Ecrã") do que foi selecionado nos "Dados principais";
3 - Ao selecionar uma análise a "Descrição para os dados" é preenchida por defeito com o nome da análise;
4 - Caso não seja preenchida a "Descrição para os dados" da "Expressão T-SQL", é utilizada uma descrição por defeito ("Dados extra 1", "Dados extra 2", ...);
5 - Com o tipo "Expressão T-SQL" é possível usar as variáveis relativas aos campos da tabela principal do ecrã escolhido no separador "Dados principais" e a variável #stamp# que guarda o stamp de ligação correspondente ao registo que estiver visível no ecrã.
Notas
- Os Templates da Cris só estão disponíveis nos ecrãs de registos, na agenda e nas análises avançadas de utilizador e se o utilizador tiver ativo o "Acesso direto ao GenAI - Respostas internas com consumo de palavras";
- Nos ecrãs de registos e na agenda de marcações (exceto agenda do navegador), junto do botão "Consultar Cris", foi adicionado um botão para selecionar os templates associados;
- Ao entrar no ecrã de "Consultar a Cris" também é possível selecionar os vários templates;
- Ao "Consultar a Cris" através de um template, o botão "Continuar no chat externo" deixa de estar disponível e só é possível fazer perguntas através do botão "Obter resposta";
- Ao "Consultar a Cris" só são enviados os dados a que o utilizador tem acesso, tanto das Análises Avançadas como das Listagens Rápidas de utilizador.
- Não é possível executar javascripts na personalização de respostas no PHC CS Desktop.
- Na tabela "genaitpcris" foi adicionado o novo campo "xbrespcris".
Informação
- Esta funcionalidade só está disponível se o utilizador tiver acesso de administrador de sistema. É necessário ter o Módulo PHC CS GenAI, Módulo PHC CS Supervisor e PHC ON ativo.
- Os Templates da Cris criados no PHC CS Desktop não podem ser utilizados no PHC CS Web e vice-versa, pois dependem das tabelas associadas e que são diferentes nas duas plataformas.