- UiPath Assistant
- Instalando o UiPath Assistant
- Configuração do UiPath Assistant
- UiPath Assistant no MacOS
- Picture in Picture
- Configuração de automações attended
- Governança
- Widgets no UiPath Assistant

Guia do usuário do UiPath Assistant
PiP - Sessão filho
O Picture-in-Picture - Session filho permite que você execute processos Attended em um sessão isolada do Windows sem interromper seu trabalho atual.
Quando um processo é iniciado no modo Picture-in-Picture, uma nova sessão é gerada. Se você executar uma automação no PiP pela primeira vez, será solicitado que você autentique a nova sessão usando suas credenciais do Windows.
Após a sessão ser criada, aparecerá uma janela de visualização em sua área de trabalho, fornecendo feedback em tempo real da execução do processo. A janela pode ser redimensionada, movida, colocada em tela cheia ou por cima de outras janelas. Você pode sair do modo Picture-in-Picture a qualquer momento, clicando com o botão direito do mouse na entrada Picture-in-Picture da Barra de Tarefas do Windows e selecionando Fechar Janela, ou simplesmente fechando a janela. Uma caixa de diálogo de confirmação aparece e ao escolher fechar a janela do PiP, encerra o processo em execução.
The default timeout to start a process in a PiP session is 180 seconds. If the login in the Picture-in-Picture session takes longer than that, a timeout error is thrown.
This default timeout can be changed using UIPATH_PIP_SESSION_TIMEOUT environment variable on the machine. When using the Robot in Service Mode, make sure to set the UIPATH_PIP_SESSION_TIMEOUT variable as a system environment variable and restart the Robot Service.
São necessários direitos de administrador para habilitar o recurso Picture-in-Picture na máquina. Isso será necessário apenas na primeira vez em que o Picture-in-Picture for usado. Depois disso, o processo real poderá ser iniciado no Picture-in-Picture sem privilégios elevados.
Credenciais para a sessão do UiPath Robot
The credentials used for the Robot session are managed by the Windows Child Session mechanism. For more information, read the Microsoft child sessions documentation.
After PiP is enabled, these credentials are required when a PiP child session is launched until the user logs on again on the machine, or in specific scenarios such as using a smart card or PIN instead of a username/password combination.
Habilitando o PiP na máquina
A funcionalidade Picture-in-Picture da máquina pode ser habilitada por meio da linha de comando ou manualmente, ao iniciar a sessão do PiP pela primeira vez na máquina.
| Método | Command | Description |
|---|---|---|
| Manualmente | A primeira vez que você iniciar uma sessão do Picture-in-Picture no Studio ou UiPath Assistant, será solicitado que você habilite a funcionalidade do PiP na máquina. Isso exige direitos de administrador. | |
| Linha de comando |
| Allows you to enable or disable the Picture-in-Picture functionality on the machine. This setting is applied on the local machine and affects all users and is used for modifying existing installations . Ela pode conter os seguintes parâmetros:
Habilita a funcionalidade Picture-in-Picture da máquina.
Desabilita a funcionalidade Picture-in-Picture da máquina. UiRobot.exe PiP --EnableSão necessários direitos de administrador para executar esses comandos. |
| Linha de comando |
| Allows you to enable the Picture-in-Picture functionality of the machine during the UiPath command-line installation . Para habilitá-la, use o seguinte parâmetro:
Exemplo:
|
Problemas e Limitações Conhecidas
Há algumas coisas a serem levadas em consideração ao usar o recurso Picture-in-Picture:
- Se você estiver usando um PIN para fazer login na sessão principal do Windows, serão solicitadas suas credenciais sempre que você iniciar uma sessão do UiPath Robot.
- Quando a sessão do UiPath Robot está ativa, ela também inicia programas de inicialização dentro da mesma sessão. Isso pode redefinir as configurações de seus dispositivos periféricos, como configurações de luz do teclado e mouse, de volta a seus padrões.
- Habilitar a Sessão da área de trabalho remota durante uma sessão ativa do UiPath Robot requer fazer logout e fazer login novamente na Sessão principal do Windows para que as alterações entrem em vigor.
- Você não pode reiniciar ou desligar sua máquina enquanto a sessão do UiPath Robot estiver ativa. Feche a sessão do UiPath Robot primeiro.
- As restrições do sistema operacional impedem a compatibilidade do Picture-in-Picture com as edições Home do Windows 8 e 10.
- A área de transferência é compartilhada entre a sessão do UiPath Robot e a sessão principal.
- A execução como Administrator não pode ser usada na sessão do UiPath Robot.
- Você pode iniciar uma única sessão do UiPath Robot ao mesmo tempo.
- To start a Robot session, you need Allow Log On Locally permissions.
Automação do Microsoft Office
Automações que usam os recursos do Microsoft Office, não executam com sucesso no Picture-in-Picture, se os recursos já estiverem abertos na sessão principal. Para garantir que as automações sejam executadas de forma suave no PiP, você poderá fazer o seguinte:
- Feche o recurso usado pelos aplicativos do Microsoft Office na sessão principal, para que eles possam ser abertos na sessão PiP.
- Use an Invoke Isolated Workflow activity to invoke the part of the automation using Microsoft Office and set its Target Session to Picture in Picture from Studio.
Usando o Navegador Web em Sessões PIP
Os dados do navegador de uma sessão Picture-in-Picture são salvos na sessão principal por padrão. Se houver uma instância aberta do Google Chrome ou do Microsoft Edge na sessão principal, ele terá que usar outro perfil de usuário no PiP. Isso é feito automaticamente pela atividade Open Browser. Não é possível ter um navegador específico (digamos, o Chrome) aberto com o mesmo perfil de usuário, tanto na sessão PiP, como na sessão Principal, ao mesmo tempo.
However, the mode and location of the browser data can be configured from the Open Browser activity properties.
Configurar a propriedade UserDataFolderMode como Automatic permite que o navegador use pastas de dados do usuário separadas nas sessões principal e PiP.
Observe que, se você limpar os dados do usuário da pasta %LocalAppData%\UiPath\PIP Browser Profiles neste modo, a extensão do navegador correspondente precisará ser habilitada novamente.
Caso você precise usar dados da sessão principal (como cookies ou senhas salvas), considere definir a propriedade UserDataFolderMode como DefaultFolder. Isso significa que as sessões principais e do PiP usam a mesma pasta para os dados do usuário do navegador.
Ao definir o UserDataFolderMode como DefaultFolder, o navegador irá funcionar em apenas uma sessão por vez. Se o navegador estiver aberto na sessão principal, ele não funciona na sessão PiP. Isso ocorre porque o mesmo perfil do navegador não pode ser usado em duas sessões simultaneamente.
Target Session e UserDataFolderMode são propriedades que podem ser modificadas apenas no Studio. Os projetos desenvolvidos no StudioX precisam ser abertos no Studio para alterar essas propriedades.
Configurar a propriedade UserDataFolderMode para CustomFolder, permite que você especifique diferentes pastas de dados do usuário para as sessões principal e de PiP.
O PiP Requer login todas as vezes
Com base no seu ambiente, determinadas políticas do Windows podem fazer com que a sessão PiP solicite um login sempre que ele for inicializado.
Por exemplo, a seguinte configuração definida como Disabled faz com que a janela PiP solicite credenciais toda vez que for iniciada:
Local Group Policy\Computer Configuration\Administrative Templates\System\Credential Delegation\Allow delegating default credentials
Isso também acontece quando o PIN de Hello do Windows Business é usado. A autenticação PIN só funciona na primeira vez que uma sessão PiP é lançada. Depois disso, a sessão PiP só pode ser autenticada usando nome de usuário e senha.
Autenticação do SmartCard
Se seu ambiente exigir logon com um smartcard, a seguinte política deve notser definida como Enabled:
Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection\Do not allow smart card device redirection
O fluxo de trabalho leva muito tempo para iniciar no PiP
Ao iniciar um processo no PiP pela primeira vez, ele leva mais tempo do que o habitual até a execução real começar. Isso acontece porque a sessão do PiP precisa iniciar todos os seus processos do Windows e programas de inicialização.
Recomendação: inicie uma sessão PiP quanto ligar a máquina e a mantenha aberta ao longo do dia. Isso utiliza menos recursos do que iniciar uma nova sessão PiP para cada processo.
A sessão do PiP não inicia
Algumas políticas do Windows podem restringir o início da sessão do PiP. Para evitar isso, o usuário que estiver iniciando uma sessão do PiP deve fazer parte das seguintes políticas:
-
Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment\Allow Log On Locally -
Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment\Access this computer from the networkImportante:This policy is needed if Device Guard is enabled on the robot machine. This means that both Kernel DMA Protection is turned on, and Local Group Policies enforce Device Guard on the machine.
In the scenario where Device Guard is enabled but the
Access this computer from the networkis disabled, when trying to launch a PiP session, the following error is displayed: "ChildSession Disconnected: The system administrator has restricted the types of logon (network or interactive) that you may use. For assistance, contact your system administrator or technical support., Reason: 4871, ExtendedReason exDiscReasonNoInfo"
Atualmente estamos investigando para encontrar outras políticas que possam afetar a funcionalidade PiP.
Cliente VPN não trabalhando no PiP
Quando clientes VPN são usados em conjunto com o PiP, há algumas situações nas quais podem ocorrer conflitos. Por exemplo, se os clientes VPN estiverem configurados para iniciar quando o usuário fizer login, quando o PiP iniciar, outra instância do cliente VPN será iniciada. Isso causa um conflito entre as duas sessões, pois o cliente VPN está definido para executar uma única instância por usuário.
Para resolver esses cenários, compilamos uma lista dos provedores VPN mais comuns com suas particularidades, além de resoluções para os problemas conhecidos que possam ocorrer.
Cisco Anyconnect
Comportamento Observado
Quando o cliente do Cisco Anyconnect estiver sendo executado na máquina do usuário e uma sessão PiP for iniciada, outro cliente do Cisco Anyconnect será iniciado na sessão PiP.
Causa
O servidor VPN Cisco está definido para aceitar uma sessão por usuário de cada vez. Quando a sessão PiP é iniciada, o Cisco Anyconnect desconecta a VPN na sessão principal e gera um erro na sessão PiP.
Isso desabilita a conexão VPN do usuário, impedindo o usuário de acessar serviços que exijam uma conexão VPN.
Resolution
Não defina o cliente VPN para iniciar automaticamente na inicialização do Windows. Isso impede o cliente VPN de iniciar uma nova conexão quando a sessão PiP iniciar e direciona o tráfego do PiP pela sessão principal do Windows.
Zscaler
A versão 4.4.0.300 do Zscaler resolve o comportamento observado aqui.
Comportamento Observado
Quando a sessão PiP é iniciada, outro cliente do Zscaler é iniciado na sessão PiP. Isso faz com que o cliente do Zscaler desapareça da sessão principal do Windows. Tudo funciona como esperado até o usuário fechar a sessão PiP. Quando a sessão PiP é fechada, o cliente Zscaler permanece em estado de limbo e o usuário tem que sair e entrar novamente ou reiniciar a máquina para abrir o Zscaler.
Causa
A Zscaler está investigando esse problema.
Resolution
Abra um ticket com a equipe de suporte da Zscaler.
Pulse secure
Comportamento Observado
Quando uma sessão PiP é iniciada, o usuário é desconectado da VPN.
Causa
O cliente Pulse secure não pode lidar com duas sessões do Windows para o mesmo usuário.
Resolution
Recomendamos abrir um tíquete com a equipe do Pulse Secure.
Palo Alto Global Protect
Quando o PiP é iniciado, a GUI mostra o usuário desconectado da VPN em ambas as sessões. Mas a sessão PiP ainda está conectada à VPN.
Resolution
Recomendamos abrir um tíquete com a equipe da Palo Alto.
PIP e Servidores Windows
Em um cenário em que vários usuários estão conectados a um Windows Server ao mesmo tempo, apenas uma sessão PIP pode ser iniciada na máquina. Isso significa que apenas uma sessão PiP pode ser aberta em uma única máquina, independentemente de qual usuário ou tipo de sessão foi usado para abrir a sessão PiP.
PIP e outros ambientes virtualizados
Em outros ambientes virtualizados, como AppV ou Citrix XenApps, a funcionalidade de PIP não está disponível.
- Credenciais para a sessão do UiPath Robot
- Habilitando o PiP na máquina
- Problemas e Limitações Conhecidas
- Automação do Microsoft Office
- Usando o Navegador Web em Sessões PIP
- O PiP Requer login todas as vezes
- Autenticação do SmartCard
- O fluxo de trabalho leva muito tempo para iniciar no PiP
- A sessão do PiP não inicia
- Cliente VPN não trabalhando no PiP
- Cisco Anyconnect
- Zscaler
- Pulse secure
- Palo Alto Global Protect
- PIP e Servidores Windows
- PIP e outros ambientes virtualizados