Instalação do ScreenPlay

O procedimento de instalação do ScreenPlay é compatível com as seguintes opções de implantação:

• A opção de implantação pronta para uso (OOB) - dá a você acesso gratuito a uma lista de modelos disponíveis:

  • UiPath Screen Agent (com Gemini 2.5 Flash)
  • UiPath Screen Agent (com GPT - 4.1)
  • UiPath Screen Agent (com GPT 4.1 mini)
  • UiPath Screen Agent (com GPT - 5)
  • UiPath Screen Agent (com GPT - 5 mini)
  • OpenAI Operator
  • Anthropic - Computer Use

• A opção de implantação bring-your-own-model (BYOM) - permite que você use sua própria assinatura existente para alimentar o ScreenPlay. Com a implantação BYOM, não há limites impostos sobre o quanto você pode usar o serviço. Para realizar essa instalação, você precisa ter sua própria assinatura para um dos seguintes serviços:

  • Azure Open AI
  • OpenAI
  • Amazon Bedrock (Anthropic Computer Use)
  • Google Vertex
  • Open AI V1 Compliant LLM – Use essa opção para se conectar a qualquer provedor de LLM cuja API siga o padrão OpenAI V1. Para obter detalhes, consulte a documentação do conector OpenAI V1 Compliant LLM.

Studio - Configuração do ScreenPlay

Pré-requisitos

O ScreenPlay é compatível com qualquer Versão do UiPath Studio. No entanto, recomendamos fortemente o uso do Studio 2025.10 para se beneficiar de uma melhor experiência de criação de solicitações.

Observação:

Versões mais antigas do Studio ainda são compatíveis com o ScreenPlay, mas usam um editor mais básico e menos flexível.

Para configurar o ScreenPlay por meio do Studio, siga as seguintes etapas:

1. Abra o UiPath Studio e crie um novo projeto.
2. Navegue até cloud.uipath.com e certifique-se de que você esteja conectado à sua conta do Automation Cloud.
3. Adicione o pacote UIAutomation mais recente, 2025.10.20 ou mais novo, navegando até Gerenciar pacotes e, em seguida, selecionando Configurações.Na seção Origens de pacote padrão, certifique-se de habilitar o pacote Oficial.
4. Na tela do projeto, selecione o ícone Adicionar atividade para pesquisar e adicionar a atividade ScreenPlay.
5. In the ScreenPlay activity, add a prompt in the Task field. Additionally, you can change the default large action model (LAM) from the Model drop-down, and tailor other properties, if needed.

Result: The ScreenPlay activity is added to your Studio project and ready to run.

Studio Web - Configuração do ScreenPlay

Para configurar o ScreenPlay por meio do Studio Web, siga as seguintes etapas:

1. Navegue para https://cloud.uipath.com, e faça login na sua conta.
2. Navegue até o Studio, selecione Criar novo e, em seguida, selecione Fluxo de trabalho do RPA.
3. Selecione o ícone Adicionar atividade para pesquisar e adicionar a atividade ScreenPlay à tela do projeto.
4. No painel Propriedades da atividade ScreenPlay, adicione uma solicitação no campo Tarefa. Além disso, você pode alterar o LAM padrão no menu suspenso Modelo e adaptar outras propriedades, se necessário.

Result: The ScreenPlay activity is added to your Studio Web project and ready to run.

Configuração de traga-seu-próprio-modelo

Para usar suas próprias assinaturas, siga as seguintes etapas de configuração por meio das configurações de LLM no AI Trust Layer:

1. Na plataforma de Automation Cloud™, navegue até Admin.
2. Selecione AI Trust Layer e, em seguida, selecione a guia Configurações de LLM.
3. Selecione um tenant no menu suspenso Tenant e, em seguida, selecione Adicionar configuração.
4. No painel Adicionar configuração, siga as seguintes etapas:
   1. Selecione Automação de interface gráfica no menu suspenso Produto.
   2. Selecione ScreenPlay na lista suspensa Funcionalidade.
   3. Selecione Substituir a assinatura do UiPath LLM no menu suspenso Modo de configuração.
   4. Selecione a assinatura que você tem e deseja usar no menu suspenso LLM.
   5. Na seção Configurar conexão gerenciada pelo cliente, selecione uma pasta de Pasta no menu suspenso e, em seguida, selecione um conector de Conector no menu suspenso.
   6. Selecione Adicionar nova conexão. Uma nova aba abre, solicitando que você forneça informações para conectar a UiPath ao seu conector selecionado. Preencha os campos necessários e, em seguida, selecione Teste no painel Adicionar configuração.
   7. Selecione Salvar.

Para obter mais informações, consulte Configuração de LLMs.

Precauções importantes

Para um uso seguro do ScreenPlay, você deve tomar as seguintes precauções importantes:

• Current state-of-the-art LAMs have limited capabilities, so it is better to use multiple granular ScreenPlay activities, each handling one or two actions with a few target UI elements, rather than a single end-to-end automation attempting a complex task.