UiPath Documentation
orchestrator
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do usuário do Orchestrator

Última atualização 17 de abr de 2026

Configurações

A página Configurações permite que administradores ajustem as configurações do tenant do Orchestrator.

Guia Geral

Campo

Description

Configurações de Aplicativo

Fuso horário - O fuso horário do tenant. Por padrão, esse campo é definido como UTC.

Espaços de Trabalho Pessoais

For Automation Cloud and Test Cloud or Automation Cloud Dedicated, Automatically configure Serverless machines in Personal Workspace for Studio Web users - Option selected by default, allowing Serverless machines to be automatically provisioned in the personal workspaces of users who design or debug in Studio Web.

For Automation Cloud and Test Cloud or Automation Cloud Dedicated, deselecting the option prevents Serverless machines from being automatically created in personal workspaces, which may impact designing or debugging processes in Studio Web.

Note: For Automation Cloud and Test Cloud or Automation Cloud Dedicated, deselecting the option does not deallocate the Serverless machine from your personal workspace. Explicit deallocation of the Serverless machine might be required.

Automatically stop exploring Personal Workspaces after - Allows Orchestrator administrators to enforce a rule dictating that personal workspace exploration is automatically stopped after a set amount of time.

As opções disponíveis são 15 minutos, 1 hora, 1 dia e valor personalizado.

Por padrão, ao migrar ou criar novos inquilinos, esse valor não é definido. Você precisa configurá-lo manualmente assim que o processo de migração/criação for concluído.

Interromper todas as sessões ativas de exploração de espaços de trabalho pessoais — permite que os administradores do Orchestrator interrompam todas as sessões de exploração de espaços de trabalho pessoais ativas no momento. Isso é sufixado pelo número de sessões ativas, exibido entre parênteses, e pode ser ativado clicando em Interromper exploração de sessões .

As alterações feitas nas configurações de exploração não se aplicam retroativamente às sessões que já foram exploradas.

Mass enable Personal workspaces for current users and groups: - Create personal workspaces for all users in a tenant that use a certain attended licensing profile, while also selecting the UI profile to be used for those users.

Observação: essa ação não pode ser revertida; após o recurso Espaços de trabalho pessoais ter sido habilitado, ele não poderá ser desabilitado.

Funções Padrão

Create standard roles for folders. These roles allow you to leverage the benefits of user groups.

Clique em Criar função ao lado de cada função que deseja criar.

Configurações de atualização automática de binários de clientes (Robô, Studio, Assistant)

Ignorar o status de atualização automática de máquinas de Robôs que estiveram offline por mais de ___ dias - Exclua máquinas inativas do processo de atualização e não as leve mais em consideração quando o status de atualização for reportado.

Pastas

Habilitar mapeamentos de conta-máquina - Habilitar a funcionalidade de Mapeamentos de conta-máquina .

Seção Configurações de execução

Observação:

In this section, settings pertaining to triggers apply to all process types. However, settings pertaining to queues and jobs do not apply to agents and agentic processes.

Campo/Valor padrão

Description

Gatilhos - Estratégia de contagem de trabalhos

( Triggers.JobsCountStrategy )

Valor padrão Por processo

Escolha a estratégia de contagem de trabalhos para trabalhos iniciados por meio de gatilhos.

Observe que isso não leva em consideração quaisquer argumentos que possam ter sido fornecidos.

As seguintes opções estão disponíveis:

  • Per Process - A trigger launches the required number of jobs taking into account any pending jobs for the specified process. For example, two triggers defined for the same process launch 3 and 5 jobs, respectively. If the first trigger launches 3 jobs at a given point in time, when the second trigger is set off, 2 jobs are launched so as to reach the 5 required jobs.
  • Per Trigger - A trigger launches the required number of jobs taking into account any existing jobs previously launched by that same trigger. For example, a trigger is defined to launch 5 jobs at a given point in time. If 3 jobs have been successfully completed by the time this trigger is set off again, Orchestrator launches another 2 jobs so as to reach the 5 required jobs.

Gatilhos - Gatilhos de fila - Habilitar estratégia de trabalhos pendentes

( Features.QueueTriggers.PendingJobsStrategy )

Valor padrão: Verdadeiro

Escolha o método de computação para o número de trabalhos adicionais a serem acionados quando novos itens forem adicionados a uma fila. Isso é feito subtraindo o número de trabalhos em um determinado estado do número máximo de trabalhos a serem criados.

As seguintes opções estão disponíveis:

  • True - This option is best suited for cases where you want Orchestrator to assume that all running jobs have already moved queue items out of the status New .

O número é calculado da seguinte forma:

Máximo de trabalhos adicionais a serem criados com base em itens de fila disponibilizados recentemente = o número máximo de trabalhos pendentes e em execução permitidos simultaneamente menos o número de trabalhos em um estado Pendente.

  • False - This option is best suited for cases where you want Orchestrator to assume all running jobs have yet to move queue items out of the status New .

O número é calculado da seguinte forma:

Maximum additional jobs to be created based on newly available queue items = the maximum number of pending and running jobs allowed simultaneously minus the number of jobs in one of these states: Pending , Resumed , Running , Stopping , Terminating .

Gatilhos - Desabilitar quando houver falha na contagem na criação do trabalho

( Triggers.DisableWhenFailedCount )

Valor padrão: 10

Configurar um gatilho para ser desativado automaticamente após um certo número de inícios com falha e nenhuma execução bem-sucedida ocorrer em um número específico de dias.

This option works in conjunction with Triggers -Grace period when job creation keeps failing count (days) , as follows: Triggers - Disable when job creation fail count allows you to adjust the number of failed runs, whereas Triggers - Disable when it keeps failing count (days) enables you to change the number of days.

By default, the Triggers - Disable when job creation fail count value is 10, and the Triggers - Grace period when job creation keeps failing count (days) value is 1, which means that the trigger is disabled after 10 unsuccessful attempts to launch if there were no successful runs in the past day.

Esta opção pode ser definida dentro de um intervalo de 10 a 100.

Gatilhos - Período de tolerância quando a contagem continua falhando na criação do trabalho (dias)

( Triggers.DisableWhenFailingSinceDays )

Valor padrão: 1

Configurar um gatilho para ser desativado automaticamente após um certo número de inícios com falha e nenhuma execução bem-sucedida ocorrer em um número específico de dias.

This option works in conjunction with Triggers - Disable when failed count , as detailed above.

Pode ser definido dentro de um intervalo de 1 a 30.

Gatilhos - Gatilhos conectados - Desabilitar quando houver falha na contagem na execução do trabalho

Default value: 5

Observação:

Isso tem como alvo apenas gatilhos conectados (por exemplo, gatilhos criados no Studio Web) publicados para espaços de trabalho pessoais.

O disparador é desabilitado após o número de execuções com falha que você escolher para esta configuração.

Ele pode ser definido dentro de um intervalo de 0 a 100, onde 0 significa que o gatilho nunca é desabilitado.

If you select 0, Triggers - Connected triggers - Grace period when job execution keeps failing count (days) becomes irrelevant, and its field is disabled.

Essa configuração é válida apenas para gatilhos conectados recém-criados. As alterações não são aplicadas retroativamente a gatilhos conectados existentes.

Gatilhos - Gatilhos conectados - Período de tolerância quando a contagem continua falhando na execução do trabalho (dias)

Default value: 0

Observação:

Isso tem como alvo apenas gatilhos conectados (por exemplo, gatilhos criados no Studio Web) publicados para espaços de trabalho pessoais.

Essas configurações ditam o número de dias para aguardar antes que o gatilho seja desabilitado após a primeira falha de um trabalho.

Ele pode ser definido dentro de um intervalo de 0 a 30.

If Triggers - Connected triggers - Disable when job execution fail count is 0, this field is disabled.

Disparos - Disparos de API - Limite máximo de trabalhos pendentes

Valor padrão: 10

Set the maximum number of pending jobs that can be created by an API trigger .

O intervalo compatível é de 1 a 100.

Filas - Abandonar itens de fila em andamento após o limite (horas)

( inProgressMaxNumberOfMinutes )

Valor padrão: 24

Set the maximum amount of time, in hours, that queue items can have the In Progress status. After this time, the status of the queue items changes to Abandoned .

O valor padrão é de 24 horas, o que significa que itens de fila não podem ser marcados como Abandonados, a menos que tenham tido o Status Em andamento por pelo menos um dia.

Isso é tratado por um trabalho em segundo plano, que é executado uma vez por hora. Assim, você pode esperar que a transição aconteça até uma hora após o valor selecionado.

Filas: frequência de verificação de itens da fila não processados (minutos)

( Queue.ProcessActivationSchedule )

Default value: 30

O tempo entre verificações para itens de fila não processados.

Para ajustar o intervalo de verificação, você pode escolher entre 10, 15, 20, 30 ou 60 minutos.

Para cada gatilho de fila que você cria, geramos um gatilho de tempo em segundo plano que se destina a lidar com itens de fila que não puderam ser processados no momento em que foram enfileirados. Esse gatilho do tempo de segundo plano é usado para calcular a frequência ditada pela configuração.

Existing queue triggers : the setting is applied when the default value is changed for the first time, and cannot be restored.

New queue triggers : the setting is always applied.

Important :

  • O carimbo de data/hora de referência usado se baseia na hora em que o gatilho da fila foi criado. Por exemplo, se um gatilho de fila for criado às 14:22:43 e essa opção estiver definida como 10 minutos, a seguinte recorrência será gerada: 14:32:43, 14:42:43, 14:52:43 e e assim por diante.
  • A tarefa em segundo plano que executa as alterações disparadas por essa configuração pode levar até 10 minutos para entrar em vigor.

Trabalhos - Tempo limite após encerramento (horas)

( Jobs.TerminatingJobsTimeout )

Valor padrão: 24

Set the time elapsed, in hours, until Terminating jobs become fit to be marked as Failed .

O valor padrão é 24, o que significa que os trabalhos não podem ser marcados como Com falha, a menos que tenham ficado em um estado Encerrando por pelo menos um dia.

Isso é tratado por um trabalho em segundo plano, que é executado uma vez por hora. Assim, você pode esperar que a transição aconteça até uma hora após o valor selecionado.

Seção de Configurações da API

ConfiguraçãoDescription
Lista de permissão do CORS com gatilhos de APIAllows you to enter domains permitted for incoming traffic. Separate distinct domains through a comma or by pressing Enter.
Solicitar cabeçalho de autenticação para sincronizar redirecionamentos de gatilhos de APIThis is enabled by default, and it enforces the use of an authentication header when selecting the Sync (long-polling) call mode for an API trigger.
API estritaIf enabled, certain API fields become non-filterable and/or non-sortable, thus helping prevent performance issues. You can see a list of these fields in the dedicated page. This setting is enabled by default for new tenants, but existing tenants need to be opted in manually. Keeping this option enabled at all times is a recommended best practice in API integrations.

Guia Implantação

Permite configurar e proteger feeds para pacotes e bibliotecas. É possível gerenciar os feeds para todos os tenants de um local centralizado usando o Automation Ops. Para obter mais informações, consulte gerenciamento de feeds no guia do Automation Ops.

As configurações feitas aqui afetam apenas feeds do tenant; feeds de pasta e feeds de espaço de trabalho pessoal são sempre internos e ficam disponíveis exclusivamente no contexto da pasta ou espaço de trabalho pessoal respectivo.

Pacotes

Permite que você defina um feed interno ou externo no qual os pacotes de automação podem ser mantidos. Por padrão, um feed interno é usado. Os feeds podem ser protegidos definindo credenciais básicas de autenticação ou usando uma chave de API.

Campo

Description

Interna

Uso de um feed interno. O feed pode ser protegido com a opção Implantação segura ou usando uma chave de API:

  • Implantação segura — garante que seus pacotes de automação serão baixados por meio de um feed seguro do NuGet.
  • Chave de API — a chave usada para proteger seu feed contra operações de gravação, como a de excluir ou carregar. Isso só é necessário se você quiser carregar um pacote diretamente no feed NuGet usando um cliente externo.
Importante: você só pode usar a opção chave de API para autenticar uploads de pacotes. Para autenticar downloads de pacotes, use a opção Implantação segura .

Externa

Uso de um feed externo. O feed pode ser protegido usando uma chave de API ou credenciais básicas de autenticação:

  • Deployment URL * - The address where the NuGet feed is located.

  • Chave de API — a chave usada para proteger seu feed contra operações de gravação, como a de excluir ou carregar.
  • Autenticação — permite que você especifique as credenciais para o seu feed básico autenticado.

Lembre-se de que o nome de usuário e a senha usados com a opção Chave de API também devem ser usados nesse caso.

Importante:

Não temos compatibilidade com pacotes multiplataforma carregados para um feed externo. Seus metadados só podem ser lidos se forem carregados diretamente para o Orchestrator.

Autenticação de feeds usando tokens de titular do JWT usando autorização básica

Você pode especificar tokens de acesso pessoal e outros tokens de titular de JWT para autenticar seus feeds, conforme mostrado no exemplo a seguir:

curl https://:<rt_my-reference-token>@cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json
curl https://:<rt_my-reference-token>@cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json

A abordagem comum em todos os principais provedores de feed do NuGet é usar a senha de autorização básica para enviar o token de acesso pessoal. Isso permite que você use os mecanismos integrados do NuGet para autenticação, conforme mostrado no exemplo a seguir:

<configuration>
  <packageSources>
    <add key="myfeed" value="cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <myfeed>
      <add key="Username" value="" />
      <add key="ClearTextPassword" value="%UIPATH_PAT%" />
    </myfeed>
  </packageSourceCredentials>
</configuration>
<configuration>
  <packageSources>
    <add key="myfeed" value="cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <myfeed>
      <add key="Username" value="" />
      <add key="ClearTextPassword" value="%UIPATH_PAT%" />
    </myfeed>
  </packageSourceCredentials>
</configuration>

Additionally, you can integrate the feeds using secure credential providers. For further information, refer to the Microsoft documentation.

Bibliotecas

Permite configurar o feed a ser usado para pacotes de biblioteca e atividade.

Campo

Description

Somente feed de host

As bibliotecas são armazenadas no feed do host e ficam disponíveis para todos os tenants que o usam. A página Bibliotecas é a mesma para uma instância do Orchestrator, o que significa que as bibliotecas não estão isoladas no nível do tenant: cada tenant tem acesso à atividade dos outros tenants.

Não é possível carregar bibliotecas a partir do Orchestrator se essa opção estiver selecionada.

Esta opção dá acesso ao robô apenas para o feed do host.

Apenas feed de tenant

As bibliotecas são isoladas no nível do tenant, o que significa que os dados estão separados entre os tenants. Você pode definir um feed interno ou externo no qual as bibliotecas são mantidas. Por padrão, um feed interno é usado.

Esta opção dá acesso ao robô apenas para o feed do tenant.

Feeds de tenant e host

As bibliotecas são isoladas no nível do tenant, o que significa que os dados estão separados entre os tenants. Você pode definir um feed interno ou externo no qual as bibliotecas são mantidas. Por padrão, um feed interno é usado.

Esta opção dá ao robô acesso aos feeds do host e do tenant.

Interna

Exibido quando Apenas feed do tenant ou Tanto feeds do host e do tenant estiver selecionado.

Usar um feed interno para suas bibliotecas. O feed pode ser protegido com a opção Implantação segura ou usando uma chave de API:

  • Implantação segura — garante que seus pacotes de automação serão baixados por meio de um feed seguro do NuGet.
  • Chave de API — a chave usada para proteger seu feed contra operações de gravação, como a de excluir ou carregar.

Externa

Exibido quando Apenas feed do tenant ou Tanto feeds do host e do tenant estiver selecionado.

Usar um feed externo para suas bibliotecas. O feed pode ser protegido usando uma chave de API ou credenciais básicas de autenticação:

  • Deployment URL * - The address where the NuGet feed is located.
  • Chave de API — a chave usada para proteger seu feed contra operações de gravação, como a de excluir ou carregar.
  • Autenticação — permite que você especifique as credenciais (nome de usuário e senha) para o seu feed básico autenticado.

Lembre-se de que o nome de usuário e a senha usados com a opção Chave de API também devem ser usados nesse caso.

For more details, read through the Library feeds page.

Aba de segurança do robô

Segurança

CampoDescription
O total de horas que um robô pode ser executado offline sem verificação de licençaEspecifique o número de horas que um Robô pode ser executado offline, sem que o Orchestrator verifique sua licença. Por padrão, esse valor é definido como 0. O valor máximo aceito é de 168 horas.

Autenticação do robô

CampoDescription
Autenticação de robôs unattendedClient credentials (Recommended) - This option only allows for connections with tokens that expire. It uses the OAuth 2.0 framework as the basis for the authentication protocol, meaning unattended robots can connect to Orchestrator with a client ID - client secret pair generated via machine template objects. The client ID - client secret pair generates a token that authorizes the connection between the robot and Orchestrator and provides the robot with access to Orchestrator resources. Hybrid - This option allows for both connections with tokens that don't expire (machine key) and connections with tokens that expire (client credentials).
Autenticação de robô assistidoInteractive Sign-in SSO (Recommended) - This option only allows for robot connections with tokens that expire. Users can authenticate their robots only by signing-in with their credentials in the Assistant. User sign in is required to run attended robots, make Orchestrator HTTP requests, or view processes in the Assistant. When using interactive sing-in, there is no need to create machine objects in Orchestrator. User license management option enforeces Interactive Sign-In (SSO) for Attended robot authentication. Hybrid - This option allows for both connections with tokens that don't expire (machine key) and connections with tokens that expire (interactive sign-in or client credentials). Users have the option to sign-in with their credentials to authenticate their robots, which in turn allows them to connect Studio and the Assistant to Orchestrator, however it is not mandatory.

Guia Escalabilidade

Especifique se o serviço de robôs deve assinar os canais do SignalR do Orchestrator, e configure os protocolos de transporte que funcionam melhor para você.

Figure 1. Scalability tab

CapturaDeTela da aba Escalabilidade

SignalR (Robôs)

Campo

Description

Habilitado

Essa alternância especifica se o serviço de robôs assina os canais do SignalR do Orchestrator ou não. Por padrão, essa configuração está habilitada, e todos os canais disponíveis serão selecionados:

  • WebSocket
  • Eventos Enviados pelo Servidor (SSE)
  • Long Polling

Quando todos os canais de transporte são ativados, o melhor transporte disponível é selecionado automaticamente, na seguinte ordem de prioridade: WebSocket > Eventos enviados pelo servidor > Long Polling. Se o primeiro protocolo não estiver disponível por algum motivo, o próximo da fila (se habilitado) é usado para facilitar a comunicação entre o Orchestrator e o Robô.

Desabilitar o SignalR no tenant pode fazer com que alguns recursos da UiPath, incluindo o Studio Web, funcionem de forma incorreta ou parem de funcionar por completo.

WebSocket

Quando estiver selecionado, permite que o protocolo de transporte de WebSocket seja usado para conectar o robô aos canais do SignalR do Orchestrator. Esse é o protocolo mais alto usado na ordem de prioridade, devido ao seu desempenho e compatibilidade com a comunicação simultânea em ambas as direções: do serviço de robôs para o Orchestrator e vice-versa.

If the SignalR (Robots) feature is not enabled, WebSocket becomes the only available transport protocol.

Eventos Enviados pelo Servidor (SSE)

Quando estiver selecionado, permite que a tecnologia de push do Server-Sent Events (SSE) seja usada para conectar o robô aos canais do SignalR do Orchestrator. Esse é o primeiro backup, caso o WebSockets não esteja disponível por qualquer motivo.

Essa opção não pode ser usada se a funcionalidade SignalR (robôs) não estiver habilitada.

Long Polling

Quando estiver selecionado, permite que o protocolo de transporte Long Polling seja usado para conectar o robô aos canais do SignalR do Orchestrator. Esse protocolo é usado, caso os WebSockets e os SSE não estejam disponíveis.

Essa opção não pode ser usada se a funcionalidade SignalR (robôs) não estiver habilitada.

Guia Dias não úteis

Defina uma lista de dias não úteis por tenant, nos quais você pode restringir a execução de gatilhos. Isso significa que, durante feriados públicos, fins de semana ou qualquer outro dia em que as atividades de negócios normais não são realizadas, seus gatilhos de longo prazo podem ser configurados para não dispararem. Após os dias não úteis definidos terem passado, os gatilhos serão iniciados da forma normal.

Para aplicar essas restrições aos seus gatilhos, você precisa selecionar o calendário de dias não úteis ao configurar os gatilhos. Todas as alterações que você fizer na guia Dias não úteis afetam todos os gatilhos que usam esse calendário.

Para obter mais detalhes sobre como gerenciar dias não úteis, clique aqui.

Conexões de Nuvem

This tabs allows you to configure integrations with third-party cloud service providers (CSPs) which are used for elastic robot orchestration.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades