ScreenPlay

UiPath.Semantic.Activities.NUITask

Description

O Screenplay é o agente de automação de próxima geração da UiPath®, projetado para trazer comportamento de agente e recursos cognitivos para a área de trabalho. O Screenplay interage com aplicativos de maneira semelhante a um humano: navegando por interfaces, adaptando-se a mudanças e lidando com tarefas complexas que anteriormente eram inviáveis com métodos de automação tradicionais.

Para saber mais, consulte Screenplay.

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

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Task - Prompt describing the UI task to be performed, with the ability to:
  • Use Variables
  • Add image from screen (inline with the text)
  • View last execution trace. For more details, see the Running and inspecting the execution results page.

• Model - Indicates the underlying LLM used by ScreenPlay for task execution planning and reasoning. The following options are available:

  UiPath (com Gemini 2.5 Flash)

  • Modelo básico
  • Funciona melhor em navegadores
  • Usa uma implementação proprietária baseada no DOM da página, usando o Gemini Flash para o raciocínio e compreensão de imagens
  • É moderadamente rápido
  UiPath (com GPT-4.1)
  • Modelo padrão - para tarefas complexas
  • Funciona melhor em navegadores
  • Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando o GPT-4.1 para o raciocínio
  • Não é muito rápido
  UiPath (com GPT-4.1 mini)
  • Modelo básico - mais rápido, mais barato
  • Funciona melhor em navegadores
  • Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando o GPT-4.1 mini para o raciocínio
  • É moderadamente rápido
  UiPath (com GPT-5)
  • Modelo padrão - para tarefas complexas
  • Funciona melhor em navegadores
  • Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando GPT-5 para raciocínio
  • Lenta
  UiPath (com GPT-5 mini)
  • Modelo básico - mais rápido, mais barato
  • Funciona melhor em navegadores
  • Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando o GPT-5 mini para o raciocínio
  • É moderadamente rápido
  OpenAI - Operator
  • Modelo padrão - para tarefas complexas
  • Funciona em qualquer tipo de aplicativo, incluindo interfaces baseadas em imagens
  • Usa o OpenAI Operator, um modelo de raciocínio baseado em imagens. Deve ser a melhor do grupo
  • Lenta
  Anthropic - Computer Use
  • Modelo padrão - para tarefas complexas
  • Funciona em qualquer tipo de aplicativo, incluindo interfaces baseadas em imagens
  • Usa Anthropic Computer Use, um modelo de raciocínio baseado em imagens
  • Lenta
• Rate this activity - Good or Poor

Opções adicionais

Opções

• Max number of steps - This is the maximum number of steps that ScreenPlay can take to achieve its goal. The property can be used as a basic guardrail to prevent infinite agentic loops.
• Type by clipboard - Indicates whether the clipboard is used to type the given text. The following options are available:
  • Nunca - usar a área de transferência
  • Sempre - Sempre usar a área de transferência
  • Sempre que possível — use a área de transferência quando possível. Isso depende do sistema operacional e do texto a ser digitado (por exemplo Se alguma tecla especial for usada, a área de transferência não será usada)

• Use DOM when available - Indicates whether DOM data will be used/sent to the LLM Model for applications where DOM can be extracted.

  O DOM pode ser usado somente por implementações LAM da UiPath.

  Desabilite se a segmentação baseada em DOM levar a coordenadas de elemento incorretas.

  Default value is True.

• Disable variable security - Indicates whether the variable security should be disabled.

  Variable security ensures that prompt instructions can not be passed via variable values.

  The purpose of this feature is to prevent prompt injection attacks and is based on LLM, so if a "false positive" occurs, the user can disable it for each ScreenPlay activity. To conclude if it is a "false positive", the user can inspect the execution trace, system prompt, reasoning, and actions.

  Enable this option only if you need to pass prompt instructions via variable values or if a "false positive" result occurred.

  Default value is False.

• Input mode - Select which method should be used to generate keyboard and mouse input:
  • Same as App/Browser - Uses the Input mode settings from the parent Use Application/Browser activity.
  • Eventos de hardware - Atua como um usuário real usando entradas de “hardware”, como movimentos do mouse ou pressionamentos de teclado, para interagir com os aplicativos. Esses são eventos acionados por hardware enviados diretamente ao sistema operacional. Embora esse método ofereça 100% de emulação comportamental, alguns eventos podem ocasionalmente ser perdidos. Como desenvolvedor, é sua responsabilidade garantir que todos os eventos alcancem de forma confiável o aplicativo de destino.
  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, consulte a API do Chromium.
  • Simular — simula usando APIs de acessibilidade. Recomendado para navegadores, aplicativos baseados em Java e SAP. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
  • Window messages - Simulates using Win32 messages. Recommended for desktop apps. Usually more reliable than Hardware Events. Sends all text in one go. Works even if target app is not in focus. Please test if your target application UI element supports this.

• 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.

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.

Saída

• Result - The result of the task, if any. For now we only support String output.