---
sourceDocument: Criar ou modificar aplicações do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Criar ou modificar aplicações do Xanadu

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# Adicionar propriedades com as quais se comunicar Virtual Agent

# Adicionar propriedades com as quais se comunicar 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) 1 min. de leitura

Para desenvolver um componente para Virtual Agent, adicione propriedades e ações específicas para interagir com a interface do cliente Virtual Agent. As propriedades necessárias dependem do tipo de componente que você está criando.

## Antes de Iniciar

* [Configurar seu ambiente](https://servicenow-prod.fluidtopics.net/ourC0hNhETgWb0BLV0Q8jA "Prepare seu ambiente local instalando o ambiente de tempo de execução JavaScript Node.js, o gerenciador de pacotes Node (npm) e o extensão do componente iu. Essas ferramentas permitem desenvolver e criar componentes localmente e implantá-los em sua instância.")
* [Configurar seu projeto](https://servicenow-prod.fluidtopics.net/Qf9laGAcmi1rtkVokT5uOQ "Crie o projeto de componente e o conjunto de arquivos necessários para desenvolver um componente. Você pode se conectar à sua instância e criar um escopo da aplicação para o seu componente ou pode reservar um escopo para verificar mais tarde.")
* [Desenvolver um componente](https://servicenow-prod.fluidtopics.net/eyOObVZdwtqEOVvfiyGNyw "Adicione seu código de componente e teste-o usando um servidor de desenvolvimento local.")
{#add-va-properties__ul_wb3_xbn_tkb}

## Procedimento

1. No código do componente, adicione as propriedades Virtual Agent para interagir com a interface do cliente Virtual Agent.  
   {#add-va-properties__table_k3t_nqd_lmb__entry__2}

   | Propriedade | Descrição |
   |-|-|
   | dadosdecontrole | Dados iniciais que o servidor Virtual Agent envia para o seu componente conforme o tópico é executado. Tipo de dados: objeto JSON |
   | responseValue | Dados enviados para o componente a partir da resposta do usuário, diretamente do cliente ou do servidor, se houver uma atualização. Use somente em componentes que exigem entrada do usuário. Tipo de dados: objeto JSON |
   | forceCloseControl | Sinalizador que indica se o componente pode aceitar entrada. Quando verdadeiro, o controle é fechado e o usuário não pode interagir com ele. Monitore as mudanças no cliente para atualizar este valor. Use somente em componentes que exigem entrada do usuário. Tipo de dados: booliano |
   [Tabela 1. Virtual Agent propriedades do componente]

   {#add-va-properties__table_k3t_nqd_lmb}
2. Se estiver criando um componente de entrada, use a ação `VA_CONTROL#VALUE_SENT` para enviar valores de usuário para o servidor.  
   {#add-va-properties__table_pdz_frd_lmb__entry__2}

   | Ação | Descrição |
   |-|-|
   | VA_CONTROL#VALOR_ENVIADO | Dados de resposta do cliente a serem enviados para o servidor. Use somente em componentes que exigem entrada do usuário. Tipo de dados: objeto JSON |
   [Tabela 2. Virtual Agent ações do componente]

   {#add-va-properties__table_pdz_frd_lmb}

## O que Fazer Depois

[Testar um componente para Virtual Agent](https://servicenow-prod.fluidtopics.net/jqfWrF39z5966cTjXJBlbg "Teste o componente personalizado Virtual Agent antes de implantá-lo na instância.") e [Implantar um componente em uma instância](https://servicenow-prod.fluidtopics.net/FShv4NrX1MNtp0SZ8Apwvg "Implante seu componente para ser exibido em sua instância como um plug-in de aplicação.").
**Conceitos relacionados**   

* [Construtor de componente personalizado](https://servicenow-prod.fluidtopics.net/1fP78Qyn79GbWRJSiJ9ZaQ "Desenvolva componentes personalizados usando o Estrutura de IU do Next Experience e o extensão do componente iu.")