--- sourceDocument: Interfaces conversacionais de Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais de Yokohama ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Personalizando Virtual Agentcom controles personalizados # Personalizando Virtual Agentcom controles personalizados {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura Os controles personalizados são componentes que ServiceNow®os desenvolvedores podem criar para uso em Virtual Agentblocos de tópicos ou tópicos. Esses controles incluem controles deslizantes ou players de vídeo. Os controles personalizados complementam os controles fornecidos em Designer do Virtual Agent. Designer do Virtual Agentfornece um conjunto padrão de controles que representam [entradas do usuário](https://servicenow-prod.fluidtopics.net/Rwp03gWqB~lzBK~VXQ3APg "Use a coleção de controles de entrada fornecida por Designer do Virtual Agentpara solicitar e capturar informações do usuário em uma conversa."), [respostas de bot](https://servicenow-prod.fluidtopics.net/WqLMvdULfAdk3q96lBxD1g "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/ycC9cWDixiWplxfLHiGdVg "Você pode controlar 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ópicos (componentes reutilizáveis), executar um script ou adicionar caminhos de conversa diferentes (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 construir um Virtual Agentconversa. Como desenvolvedor, você pode usar Designer do Virtual Agentpara 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. Os 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 personalizáveis Componetes do Next Experienceque você pode criar usando Next Experience Design System. Antes de criar um componente personalizado, você deve ter o seguinte: * Conhecimento básico do Now Platform®e estruturas da tabela de aplicações. * Conhecimento geral de conceitos, desenvolvimento e design de componentes web. * Conhecimento de JavaScript para definir o comportamento do componente e o 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 o desenvolvimento de componentes personalizados para Virtual Agent, consulte [Desenvolva um componente para Virtual Agent](https://www.servicenow.com/docs/access?context=va-components&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US). ## Como os controles personalizados funcionam {#custom-controls__section_mlf_kcf_bmb} Para adicionar seu controle personalizado a. Virtual Agent, siga estas etapas principais: 1. [Crie uma definição de controle personalizada](https://servicenow-prod.fluidtopics.net/2z1rYcO7bXm5JW8_ftPdlQ "Defina uma definição de controle de resposta ou entrada personalizada que mapeie para um componente personalizado."). Depois de criar o componente personalizado a ser usado para o controle, crie uma definição de controle personalizado que mapeie um controle de entrada ou resposta para o componente personalizado. 2. [Crie um controle personalizado usando Designer do Virtual Agent.](https://servicenow-prod.fluidtopics.net/Wml31LfFeSdCtURG2wZYdw "Crie uma entrada personalizada ou um controle de resposta que os autores de tópicos possam usar em tópicos ou blocos de tópicos. Em Virtual Agentconversations, um controle de entrada reúne 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 no Designer do Virtual Agentfazendo o seguinte: * Selecionando uma definição de controle personalizada. * Definindo os parâmetros de entrada para usar o controle. * Especificando 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 ao 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/Q3HI7rMwKusbaCt9nBl7HA "Adicione um controle personalizado a um Virtual Agentbloco de tópico ou tópico. Durante a conversa, você pode coletar entradas do usuário ou exibir saídas para o usuário."). Os autores de tópicos, 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 San Diegoversão, você pode criar controles de entrada personalizados que podem aceitar entradas seguras, como senhas, para passar por Integration Hubações ou subfluxos. Para habilitar isso, deslize o. Proteja as entradas alternar interrutor quando você cria seu controle de entrada personalizado. Para obter mais informações, consulte [Crie um Virtual Agentcontrole personalizado](https://servicenow-prod.fluidtopics.net/Wml31LfFeSdCtURG2wZYdw "Crie uma entrada personalizada ou um controle de resposta que os autores de tópicos possam usar em tópicos ou blocos de tópicos. Em Virtual Agentconversations, um controle de entrada reúne informações dos usuários finais, enquanto um controle de resposta exibe informações para os usuários finais.").