--- 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 --- # Crie um Virtual Agentcontrole personalizado # Crie um Virtual Agentcontrole personalizado {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura 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. ## Antes de Iniciar [Crie a 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."). Importante: Para implementar entradas seguras (password2) no Virtual Agentcontrole personalizado, você deve aderir aos requisitos da aplicação com escopo em Workflow Studio. Para obter detalhes, consulte [Workflow Studio requisitos da aplicação com escopo para entradas seguras](https://servicenow-prod.fluidtopics.net/Ukk7neOzR2u3_K0W46NgKw "Siga os seguintes requisitos da aplicação com escopo para implementar entradas seguras (password2) no Virtual Agenttópicos."). Dica: Os desenvolvedores e autores de tópicos podem precisar acessar controles personalizados criados em outros escopos da aplicação. Para conceder acesso, consulte [Crie privilégios de acesso entre escopos para blocos de tópicos e controles personalizados](https://servicenow-prod.fluidtopics.net/7cVc7eWdzFO3l6MmBn2nZQ "Permita que autores e desenvolvedores de tópicos acessem Virtual Agentblocos de tópicos e controles personalizados de outras aplicações com escopo."). Função necessária: virtual_agent_admin ou admin ## Procedimento 1. Navegar até TudoInterfaces conversacionaisVirtual AgentDesigner. 2. Na página inicial, selecione Criar. 3. No formulário, preencha os campos. {#create-custom-control__table_dzy_15h_cmb__entry__2} | Campo | Descrição | |-|-| | Tipo | Lista de ativos que você pode criar em Designer do Virtual Agent. Escolha o tipo de controle personalizado: * Controle da Entrada Personalizada * Controle de Resposta Personalizada {#create-custom-control__ul_yly_pfg_dmb} | | Nome | Nome exclusivo do controle personalizado que reflete sua finalidade. | | Descrição | Breve explicação da finalidade e da funcionalidade do controle. | | Propriedades avançadas (opcional) || | Tornar entradas seguras \[Somente controles de entrada personalizados\] || | Habilitar | Chave 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 no 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 seu controle. | [Tabela 1. Formulário Propriedades] {#create-custom-control__table_dzy_15h_cmb} 4. Selecione Criar. . Fluxo a guia é aberta e exibe um fluxo inicial que contém um nó de controle personalizado. 5. Selecione Início e defina os parâmetros de entrada para o controle. Os autores do tópico fornecerão esses parâmetros de entrada e valores do tópico de chamada. 1. Selecione E 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 Virtual Agenttópicos](https://servicenow-prod.fluidtopics.net/zJ1b4zZTs6CSWVO6pzSXAw "Você pode definir entradas do Glide comumente usado Virtual Agent(com.glide.cs.chatbot) tipos de dados em Designer do Virtual Agentsem escrever um script. Defina o tipo de dados de entrada no nó Iniciar de um bloco de tópico ou controle personalizado."). | | 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. Selecione Salvar. 4. Repita essas etapas para parâmetros adicionais. {#create-custom-control__substeps_j5d_fbw_3mb} 6. Selecione Fim e definem 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. Selecione - Adicionar novo . 2. Insira o nome e o valor do parâmetro. 3. Repita essas etapas para parâmetros adicionais. 4. Selecione Salvar. {#create-custom-control__substeps_v3h_mmc_bpb} 7. Selecione o 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/nTXqvdxB6H7kiTxKAxBRjw "Use esta planilha para definir um controle de entrada personalizado no Virtual Agent."). * Para um controle de entrada personalizada seguro, preencha [Folha de propriedades de entrada personalizada segura](https://servicenow-prod.fluidtopics.net/0MlK~3NtfKO~ZxDseU_CdQ "Use esta planilha para especificar entradas seguras, como uma senha, em um controle de entrada personalizada em Virtual Agent."). * Para um controle de resposta personalizado, preencha [Folha de propriedades de saída personalizada](https://servicenow-prod.fluidtopics.net/oENX6HT6gCfyPsljWtYKnA "Use esta planilha para definir um controle de resposta personalizado no Virtual Agent."). 8. Para criar o controle, selecione Salvar e então Publicar . {#create-custom-control__steps_egn_xm2_dmb} ## Resultado Se você selecionou Disponível na paleta Na página Propriedades, o ícone Controle personalizado é 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 Virtual Agentbloco de tópico ou tópico](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.").