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 (com Gemini 2.5 Flash)
  • UiPath (com GPT - 4.1)
  • UiPath (com GPT 4.1 mini)
  • UiPath (com GPT - 5)
  • UiPath (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 dos seguintes recursos:

• Você pode editar facilmente solicitações em um editor moderno.
• Você pode inserir e gerenciar variáveis e imagens entre linhas com o texto.

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. Em versões mais antigas, as imagens entre linhas não são compatíveis, e você deve escrever variáveis usando a sintaxe {{variable}}.

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

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.

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 no menu suspenso 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:

• Os LAMs de última geração são bastante limitados. Portanto, é melhor usar várias atividades granulares do Screenplay , cada uma lidando com uma ou duas ações com alguns elementos de interface do usuário de destino, em vez de uma única instância de automação de ponta a ponta tentando um tarefa complexa.