Atividades semânticas

As atividades Semântica são projetadas especificamente para trabalhar com formulários, oferecendo um método direto e poderoso para extração e entrada de dados.

Essas atividades permitem que você utilize uma abordagem flexível, enquanto os detalhes complexos são tratados pela nossa IA e componentes internos avançados, como:

• Mecanismo de extração de DOM com IA: extrai todos os elementos de interface gráfica utilizáveis no formulário.
• Mecanismo de correspondência semântica: adiciona resiliência às suas automações ao corresponder semanticamente rótulos de texto, garantindo a estabilidade contra alterações na interface gráfica.
• Segmentação semântica e mecanismo de execução: elimina os desafios baseados em seletor tradicional, permitindo a segmentação e execução perfeitas, sem os problemas usuais de complexidade e resiliência relacionados ao uso de seletores.

Esta seção inclui as seguintes atividades:

• Fechar pop-up
• Extract Form Data
• Preencher Formulário
• Atualizar Elemento de Interface Gráfica (anteriormente Set Value)

Suporte a idiomas

Atualmente, apenas o inglês é suportado.Listaremos a disponibilidade de outros idiomas assim que estendermos nosso suporte para incluir mais idiomas.

Consumo de AI Units

Each Semantic activity consumes 0.5 AI units per request.

Each request made to Extract Form Data, Fill Form, and Set Value consumes 0.5 AI units by default.

The Close Popup activity consumes 0.5 AI units per request only when the AI-Enhanced mode toggle button is enabled. In this case, each close action via AI consumes 0.5 AI units. When the toggle button is disabled, the activity does not consume any AI units.

O consumo de AI Unit pode ser monitorado usando o painel de consumo de AI Units no nível do tenant no Insights. Até abril de 2025, a métrica de atividades semânticas será renderizada como Atividades Semânticas (promo) e abrange o número de AI Units que você utiliza, mas não são cobradas.Você pode monitorar esse painel para prever seu consumo de AI Units para atividades semânticas após abril de 2025.

A partir da versão 6 de outubro de 2024 e até abril de 2025, As atividades semânticas estão disponíveis gratuitamente para clientes Community e Enterprise, incluindo aqueles sem AI Units comprados. Esse período promocional visa incentivar a adoção e construir a confiança do cliente na qualidade da funcionalidade. A partir da versão abril de 2025, o consumo de AI Units se aplica conforme descrito, garantindo continuidade e transparência sem interrupções para todos os usuários.

Fechar pop-up

UiPath.UIAutomationNext.Activities.NClosePopup

Description

Ignora todos os pop-ups que estão na parte superior do aplicativo e bloqueiam um destino, usando os botões de fechamento configurados.

Esta atividade pode ser usada dentro e fora de uma atividade Use Application/Browser.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Botões para fechar pop-up — Os rótulos dos botões usados para fechar o pop-up. No Studio Desktop, os rótulos dos botões Fechar e Cancelar são preenchidos por padrão.
• Modo aprimorado por IA - Aproveita a IA para fechar o pop-up se o botão de alternância estiver definido como Ativado. Cada ação fechada por meio de IA consome uma AI unit. A opção padrão é Desligado.

Opções adicionais

Horários

• Tempo limite de exibição de pop-up — o período (em segundos) de espera para que um pop-up apareça. O valor padrão é 30 segundos.

Entrada

• Exceção de pop-up detectado - A exceção gerada ao detectar um pop-up.

Saída

• Pop-up manipulado — indique se um pop-up foi manipulado ou não.

Extract Form Data

UiPath.Semantic.Activities.NExtractFormDataGeneric

Description

Usa IA para extrair perfeitamente dados do formulário.

Ele pode ser facilmente integrado com Entidades de Dados.

Esta atividade precisa ser adicionada a uma atividade Use Application/Browser.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Descubra campos da tela - A análise DOM que encontra elementos acionáveis com seus rótulos associados.
• Dados do formulário - Onde salvar os dados do formulário extraídos. A saída é um tipo personalizado de dados estruturados.

Opções adicionais

Horários

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Preencher Formulário

UiPath.Semantic.Activities.NFillForm

Description

Usa IA para preencher perfeitamente o formulário designado com informações extraídas da origem de dados fornecida.

Esta atividade precisa ser adicionada a uma atividade Use Application/Browser.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Fonte de dados - Selecione uma fonte de dados dos seguintes tipos compatíveis: DocumentData, Dictionary, DataEntity, DataRow, DataTable, arquivo JSON, arquivos de texto não estruturados ou até mesmo tipos personalizados, como aqueles produzidos como saída pela atividade Extract Form Data.
  Observação:

  Para DataTable, apenas os dados na primeira linha são usados para preencher o formulário.

  Para usar IEnumerable como uma fonte de dados, você precisa adicionar a atividade dentro de uma atividade For Each .
• Habilitar validação – Habilita a validação de execução para o valor de runtime se o botão de alternância for definido como Ativado. Uma exceção é gerada se o mecanismo de validação interno detectar um valor inválido após a execução. A opção padrão é Desligado.

Opções adicionais

Horários

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Atualizar Elemento de Interface Gráfica (anteriormente Set Value)

UiPath.Semantic.Activities.NSetValue

Description

Usa IA para definir um valor em qualquer campo de entrada: caixa de entrada, caixa suspensa, caixa de seleção, botões de rádio, seletor de data.

Ele pode ser usado apenas no Chrome Edge, Firefox e Safari.

Usa a mesma funcionalidade que Preencher Formulário, mas no nível do elemento.

Em vez de usar outras atividades para campos de entrada específicos (por exemplo, Type Into para caixas de entrada, Check/Uncheck para caixas de seleção, etc.), você pode usar uma única atividade genérica Update UI Element . Ele também pode lidar com seletores de datas e grupos de botões de opção.

Esta atividade precisa ser adicionada a uma atividade Use Application/Browser.

Esta atividade é compatível com o Repositório de Objetos.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Indicar destino na tela — indique o elemento de interface gráfica a ser usado como destino.

  Após indicar o destino, selecione o botão mais para acessar as seguintes opções:

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.
• Valor — o valor definido no campo. Este campo aceita apenas variáveis String .
  Se o destino indicado for uma caixa de seleção, esses são os valores aceitos:

  • Verdadeiro: "true", "yes", "checked", "x"
  • Falso: "false", "no", "unchecked"
• Habilitar validação - Habilita a validação de execução para o valor de tempo de execução se o botão de alternância estiver definido como Ativado.Uma exceção é gerada se o mecanismo de validação interno detectar um valor inválido após a execução. A opção padrão é Desligado.

Opções

• Modo do Healing Agent - configura o comportamento do Healing Agent para esta atividade, com base nas configurações de Governança ou do Orchestrator no nível do processo ou trabalho.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Apenas recomendação — permite que o Healing Agent forneça recomendações sobre como corrigir problemas de automação de interface gráfica na execução de trabalhos, mas somente se permitido pela governança ou pelas configurações do Orchestrator.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Destino

• Expandir propriedades de destino - Exibe as propriedades de destino e de âncora. Isso ocultará as outras propriedades da atividade e exibirá apenas aquelas relacionadas ao destino.

• Recolher propriedades de destino — Oculta propriedades de destino e de âncora. Isso ocultará as propriedades relacionadas ao destino e exibirá as propriedades da atividade.

• Métodos de segmentação - Os tipos de seletor que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
  • Nenhum
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica de destino.
  • Seletor difuso - Os parâmetros do seletor difuso.

  • Computer Vision - Para usar o Computer Vision como um método de segmentação, você precisa acessar Configurações do projeto > Computer Vision e certificar-se de definir o ponto de extremidade do servidor correto. Você pode deixar esse campo como está e usar o UiPath Cloud, que é preenchido por padrão, ou você pode inserir outro valor selecionando qualquer um dos outros pontos de extremidade públicos específicos de uma região do servidor ou seu próprio servidor no local.

    Outra maneira de usar o Computer Vision como um método de segmentação é definir Usar Servidor Local como True. Isso indica que o pacote UiPath.ComputerVision.LocalServer está instalado em seu projeto. Quando o Servidor local é habilitado, o valor do servidor é substituído. No entanto, o Servidor local não está disponível em projetos multiplataforma.

    • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
    • Texto do CV - Indica o texto identificado usando o Computer Vision.
    • Ocorrência de CV Text - Indica uma ocorrência específica a ser usada quando várias correspondências são encontradas.
    • Precisão do texto CV - Indica o nível de precisão para correspondência de texto OCR.
  • Seletor semântico – Aproveita modelos de linguagem grande (LLMs) para gerar descrições funcionais e semelhantes às humanas de elementos de interface gráfica. Essas descrições são altamente confiáveis, tornando-as adaptáveis a alterações de interface gráfica e melhorando significativamente a resiliência da automação quando os seletores tradicionais falham.
  • Imagem (apenas Windows)
    • Precisão da imagem - Indica o nível de precisão para correspondência de imagens.
    • Ocorrência de imagem - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
  • Texto nativo (apenas Windows)
    • Texto nativo - O texto a ser encontrado para identificar o elemento de interface gráfica.
    • Ocorrência de texto nativa - Indica uma ocorrência específica a ser usada quando várias correspondências forem encontradas.
• Seletor de janela (Instância do aplicativo) — Seletor da janela do aplicativo. Aplicável somente quando modo de anexação de janela estiver definido como instância do aplicativo.
• Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. As opções são:
  • Nenhum - Não aguarda que o destino esteja pronto.
  • Interativo - Aguarda até que apenas uma parte do aplicativo seja carregada.
  • Completo - Aguarda até que todo o aplicativo seja carregado.
• Verificação de visibilidade - Ao habilitada, a atividade também verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
  • Nenhum - Não verifica a visibilidade.
  • Interativo (para seletor Difuso) - opção padrão. Verifica se o elemento está potencialmente visível, ignorando a rolagem da página, as obstruções de outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja segmentando elementos invisíveis que existem no DOM, mas que estão ocultos.
  • Totalmente visível - Verifica se o elemento de interface gráfica está visível ou não.
• Sites responsivos — habilita o layout de sites responsivos.

Horários

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.