Instalação do ScreenPlay

O procedimento de instalação do Screenplay suporta as seguintes opções de implantação:

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

  • UiPath (com Gemini 2.5 Flash)
  • UiPath (with GPT - 4.1)
  • UiPath (com GPT 4.1 mini)
  • UiPath (with GPT - 5)
  • UiPath (with GPT - 5 mini)
  • Operador OpenAI
  • Anthropic - Computer Use

• A opção de implantação de traga seu próprio modelo (BYOM) - permite que você use sua própria assinatura existente para carregar o Screenplay. Com a implantação BYOM, não há limites impostos sobre o quanto você pode usar o serviço. Para executar esta instalação, você precisa ter sua própria assinatura de um dos seguintes serviços:

  • Azure Open AI
  • OpenAI
  • Amazon Bedrock (Uso de computador Anthropic)
  • Google Vertex
  • LLM compatível com Open AI V1 – 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 de LLM compatível com OpenAI V1 .

Studio - Configuração do ScreenPlay

Pré-requisitos

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 prompts em um editor moderno.
• Você pode inserir e gerenciar variáveis e imagens em linha com o texto.

Observação:

As 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 embutidas 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ê está conectado à sua conta do Automation Cloud.
3. Adicione o pacote UIAutomation mais recente, 2025.10.20 ou mais recente, navegando até Gerenciar Pacotes e selecionando Configurações. Na seção Origens de pacotes 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 um prompt no campo Tarefa . Além disso, você pode alterar o LAM padrão no menu suspenso Modelo e personalizar 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.