- Introdução
- Instalação

Guia do usuário do ScreenPlay
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:
- Agente de tela da UiPath (com Gemini 2.5 Flash)
- Agente de tela da UiPath (com GPT - 4.1)
- UiPath Screen Agent (com GPT 4.1 mini)
- Agente de tela da UiPath (com GPT - 5)
- Agente de tela da 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 de uma melhor experiência de criação de solicitações.
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:
- Abra o UiPath Studio e crie um novo projeto.
- Navegue até cloud.uipath.com e certifique-se de que você esteja conectado à sua conta do Automation Cloud.
- 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.
- Na tela do projeto, selecione o ícone Adicionar atividade para pesquisar e adicionar a atividade ScreenPlay.
- 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:
- Navegue para https://cloud.uipath.com, e faça login na sua conta.
- Navegue até o Studio, selecione Criar novo e, em seguida, selecione Fluxo de trabalho do RPA.
- Selecione o ícone Adicionar atividade para pesquisar e adicionar a atividade ScreenPlay à tela do projeto.
- 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:
- Na plataforma de Automation Cloud™, navegue até Admin.
- Selecione AI Trust Layer e, em seguida, selecione a guia Configurações de LLM.
- Selecione um tenant no menu suspenso Tenant e, em seguida, selecione Adicionar configuração.
- No painel Adicionar configuração, siga as seguintes etapas:
- Selecione Automação de interface gráfica no menu suspenso Produto.
- Selecione ScreenPlay na lista suspensa Funcionalidade.
- Selecione Substituir a assinatura do UiPath LLM no menu suspenso Modo de configuração.
- Selecione a assinatura que você tem e deseja usar no menu suspenso LLM.
- 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.
- 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.
- 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 atuais de última geração são bastante limitados, portanto, é melhor usar várias atividades do ScreenPlay granulares, cada uma lidando com uma ou duas Actions 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 uma Tarefa complexa.