--- 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 --- # Como personalizar Virtual Agent com controles personalizados # Como personalizar Virtual Agent com controles personalizados {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura Controles personalizados são componentes que ServiceNow® os desenvolvedores podem criar para uso em tópicos do Virtual Agent ou blocos de tópicos. Esses controles incluem controles deslizantes ou reprodutores de vídeo. Controles personalizados complementam os controles fornecidos em Designer do Virtual Agent. Designer do Virtual Agent fornece um conjunto padrão de controles que representam [entradas do usuário](https://servicenow-prod.fluidtopics.net/SJmABV7W8HbB9xgn07_p4A "Use a coleção de controles de entrega fornecida por Designer do Virtual Agent para solicitar e capturar informações do usuário em uma conversa."), [respostas de bot](https://servicenow-prod.fluidtopics.net/_aRoiM03IGT73cQ98MNO_Q "Designer do Virtual Agent oferece vários controles para exibir respostas de bot em uma conversa. Como as respostas do bot ocorrem em plataformas de terceiros, o formato de cada saída pode variar.") e [utilitários](https://servicenow-prod.fluidtopics.net/E_YMYtJRuVZKf_sPJ1pTSA "Você pode controlar as interações em um tópico usando utilitários em Designer do Virtual Agent. Esses utilitários executam várias ações, como adicionar blocos de tópico (componentes reutilizáveis), executar um script ou adicionar diferentes caminhos de conversa (ramificações) em um tópico. Os utilitários são representados como nós em um fluxo de conversa, mas não exibem nada para o usuário.") para criar uma conversa do Virtual Agent. Como desenvolvedor, você pode usar o Designer do Virtual Agent para criar controles adicionais (componentes de interface) para entradas ou respostas de saída específicas. Por exemplo, um controle deslizante é um exemplo de um controle de entrada personalizado que permite que os usuários finais selecionem uma quantidade. Nota: Os controles personalizados não funcionam no Internet Explorer versão 11. Controles personalizados também não são compatíveis com Microsoft Teams. ## Antes de criar um controle personalizado {#custom-controls__section_igd_gfj_skb} Os controles personalizados são baseados em Componetes do Next Experience personalizável que você pode criar usando o Next Experience Design System. Antes de criar um componente personalizado, você deve ter o seguinte: * Conhecimento básico da plataforma Now Platform® e estruturas da tabela de aplicações. * Conhecimento geral de conceitos, desenvolvimento e design de componentes da Web. * Conhecimento de JavaScript para definir o comportamento do componente e do controle personalizado. * Conhecimento do processo de design para criar componentes personalizados para uso em Designer do Virtual Agent. {#custom-controls__ul_bjc_lfj_skb} Para saber mais sobre como desenvolver componentes personalizados para Virtual Agent, consulte [Desenvolver um componente para o Virtual Agent](https://www.servicenow.com/docs/access?context=va-components&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ## Como os controles personalizados funcionam {#custom-controls__section_mlf_kcf_bmb} Para adicionar seu controle personalizado ao Virtual Agent, siga estas etapas principais: 1. [Criar 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."). Depois de criar o componente personalizado a ser usado para o controle, crie uma definição de controle personalizada que mapeie um controle de entrada ou de resposta para o componente personalizado. 2. [Criar um controle personalizado usando Designer do Virtual Agent.](https://servicenow-prod.fluidtopics.net/tozvV_vNAikq4bDNJCyOWQ "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.") Um controle personalizado é um controle de entrada ou resposta. Os desenvolvedores criam um controle personalizado em Designer do Virtual Agent fazendo o seguinte: * Selecionar uma definição de controle personalizada. * Definir os parâmetros de entrada para usar o controle. * Especificar os parâmetros de saída retornados pelo controle. {#custom-controls__ul_fdy_ndn_fpb} Um controle de entrada tem retornos de chamada que usam entrada do usuário final. Um controle de resposta normalmente apresenta informações para o usuário final e não tem retornos de chamada. 3. [Adicione um controle personalizado a um tópico ou bloco de tópicos](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."). Autores de tópico, administradores de agente virtual ou administradores podem adicionar um utilitário de controle personalizado a um tópico ou bloco de tópicos. {#custom-controls__ol_ppp_zcn_fpb} ## Entradas seguras {#custom-controls__section_tbg_3fr_zqb} Começando com a versão San Diego, você pode criar controles de entrada personalizados que podem aceitar entradas seguras, como senhas, para passar para Integration Hub ações ou subfluxos. Para habilitar isso, deslize o comutador Tornar entradas seguras ao criar seu controle de entrada personalizado. Para obter mais informações, consulte [Criar um controle personalizado Virtual Agent](https://servicenow-prod.fluidtopics.net/tozvV_vNAikq4bDNJCyOWQ "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.").