--- sourceDocument: Interfaces conversacionais do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais do Xanadu ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Criar um controle personalizado Virtual Agent # Criar um controle personalizado Virtual Agent {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Crie um controle de resposta personalizado que os autores do tópico possam usar em tópicos ou blocos de tópicos. Em conversas Virtual Agent, um controle de entrada coleta informações dos usuários finais, enquanto um controle de resposta exibe informações para os usuários finais. ## Antes de Iniciar [Criar a definição de controle personalizada](https://servicenow-prod.fluidtopics.net/xXLkSJq4Z7Mf3wztEZfmDw "Defina uma entrada personalizada ou definição de controle de resposta que mapeie para um componente personalizado."). Importante: Para implementar entradas seguras (password2) em seu controle personalizado Virtual Agent, você deve aderir aos requisitos de aplicação com escopo em Workflow Studio. Para obter detalhes, consulte [Requisitos de aplicação com escopo Workflow Studio para entradas seguras](https://servicenow-prod.fluidtopics.net/tVKVbMB1siGoBQH8DaL9SA "Cumpra os seguintes requisitos de aplicação com escopo para implementar entradas seguras (password2) em seus tópicos Virtual Agent."). Dica: Os desenvolvedores e autores de tópicos podem precisar acessar controles personalizados criados em outros escopos da aplicação. Para conceder acesso a eles, consulte [Criar privilégios de acesso entre escopos para blocos de tópico e controles personalizados](https://servicenow-prod.fluidtopics.net/9fTxd6Fu80xiT85iouo2Cw "Permita que os autores e desenvolvedores de tópicos acessem blocos de tópicos Virtual Agent e controles personalizados de outras aplicações com escopo."). Função necessária: virtual_agent_admin ou admin ## Procedimento 1. Navegar até TodosInterfaces conversacionaisVirtual AgentDesigner. 2. Na página Tópicos, clique em + Criar. 3. No formulário, preencha os campos. {#create-custom-control__table_dzy_15h_cmb__entry__2} | Campo | Descrição | |-|-| | Tipo | Lista de objetos que você pode criar em Designer do Virtual Agent. Escolha o tipo de controle personalizado: * Controle da Entrada Personalizada * Controle da Resposta Personalizada {#create-custom-control__ul_yly_pfg_dmb} | | Nome | Nome exclusivo para o controle personalizado que reflete sua finalidade. | | Descrição | Breve explicação da finalidade e funcionalidade do controle. | | Propriedades avançadas (opcional) || | Tornar entradas seguras \[Somente controles de entrada personalizados\] || | Habilitar | Comutador de alternância que permite que um controle de entrada personalizado passe por entradas seguras, como senhas. | | Disponível na paleta || | Habilitar | Chave de alternância que determina se o controle personalizado aparece como seu próprio ícone na seção Utilitários da paleta na guia Fluxo. Isso fornece acesso fácil ao controle para outros autores. | | Adicional || | Categorias | Lista de categorias. As categorias identificam e agrupam tópicos relacionados, blocos de tópicos ou controles personalizados. Se aplicável, escolha uma categoria para o seu controle. | [Tabela 1. Formulário de propriedades] {#create-custom-control__table_dzy_15h_cmb} 4. Clique em Criar. A guia Fluxo é aberta e exibe um fluxo inicial que contém um nó de controle personalizado. 5. Clique no nó Iniciar e defina os parâmetros de entrada para o controle. Os autores do tópico fornecerão esses parâmetros e valores de entrada do tópico de chamada. 1. Clique em + Adicionar. 2. No formulário, preencha os campos. {#create-custom-control__id_n4c_4sz_gpb__entry__2} | Campo | Descrição | |-|-| | Nome | Nome da variável de entrada que armazena o valor de entrada. | | Tipo | Tipo de dados que estão sendo passados para o bloco de tópicos. Por exemplo, String, Booleane assim por diante. Os campos mudam de acordo com sua escolha. Para obter mais informações, consulte [Tipos de dados de entrada em tópicos Virtual Agent](https://servicenow-prod.fluidtopics.net/uPsxMHHTekvnOXgK_EHFpA "Você pode definir entradas de tipos de dados Glide Virtual Agent (com.glide.cs.chatbot) usados normalmente em Designer do Virtual Agent sem escrever um script. Defina o tipo de dados de entrada no nó inicial de um controle personalizado ou bloco de tópicos."). | | Necessários | Opção para definir o parâmetro conforme necessário. | | Dica | Dica de ferramenta visível ao criar um tópico de chamada. Veja o exemplo a seguir: | | Tabela | ServiceNow tabela que é usada para consultar a entrada. Este campo estará disponível somente quando Referência ou Matriz.Referência for selecionado no campo Tipo. | | Número máximo de linhas | Número máximo de linhas que o bloco de tópico tem permissão para definir. Este campo estará disponível somente quando Matriz for selecionado no campo Tipo. | | Valor Padrão | Valor padrão para a variável. Este valor pode ser usado ao visualizar o bloco. Valores padrão duplicados não são permitidos com tipos de dados de matriz. | [Tabela 2. Adicionar caixa de diálogo de variável de entrada] {#create-custom-control__id_n4c_4sz_gpb} 3. Clique em Salvar. 4. Repita essas etapas para parâmetros adicionais. {#create-custom-control__substeps_j5d_fbw_3mb} 6. Clique no nó Final e defina os parâmetros de saída e os valores retornados do controle personalizado. Os autores do tópico podem usar o valor de saída no tópico de chamada. 1. Clique em + Adicionar novo. 2. Insira o nome e o valor do parâmetro. 3. Repita essas etapas para parâmetros adicionais. 4. Clique em Salvar. {#create-custom-control__substeps_v3h_mmc_bpb} 7. Clique no nó de controle personalizado e preencha a folha de propriedades da seguinte forma: * Para um controle de entrada personalizado, preencha [Folha de propriedades de entrada personalizada](https://servicenow-prod.fluidtopics.net/aYc6l~l6fMSIH3P2sUc6FQ "Use esta planilha para definir um controle de entrada personalizado em Virtual Agent."). * Para um controle de entrada personalizado seguro, preencha [Folha de propriedades de entrada personalizada segura](https://servicenow-prod.fluidtopics.net/56IoAd3RPIUjOZ7xRkm3VQ "Use esta planilha para especificar entradas seguras, como uma senha, em um controle de entrada personalizado em Virtual Agent."). * Para um controle de resposta personalizado, preencha [Folha de propriedades de saída personalizada](https://servicenow-prod.fluidtopics.net/6TjV8_4M7Ba7aRu7CCH7Yg "Use esta planilha para definir um controle de resposta personalizado em Virtual Agent."). 8. Para criar o controle, clique em Salvar e em Publicar. {#create-custom-control__steps_egn_xm2_dmb} ## Resultado Se você selecionou Disponível na paleta na página Propriedades, o ícone Controle personalizado será exibido como seu próprio ícone na seção Utilitários da paleta. O controle está listado na página Tópicos e você pode usar o menu Tipo para mostrar somente controles personalizados. ## O que Fazer Depois [Adicione um controle personalizado a um tópico ou bloco de tópicos Virtual Agent.](https://servicenow-prod.fluidtopics.net/tVGIUvZ3wYWNSVxo~GDkVA "Adicione um controle personalizado a um tópico ou bloco de tópicos Virtual Agent. Durante a conversa, você pode coletar entradas do usuário ou exibir saídas para o usuário.").