Configuração

A UiPath CLI é configurada por meio de variáveis de ambiente e sinalizadores por comando. Não há arquivo de configuração de uso geral: defina variáveis de ambiente no ambiente do executor e passe sinalizadores nos comandos.

Origens de configuração

Em ordem de precedência, da mais específica para a mais geral:

1. Sinalizador de linha de comando — --tenant, --authority, --client-id, --output, --log-level, etc. Os sinalizadores têm precedência sobre todas as outras origens.
2. Variável de ambiente — variáveis lidas pela CLI no runtime (consulte Variáveis de ambiente). A CLI lê cada variável apenas nos pontos documentados; não há regra implícita "cada sinalizador tem uma contraparte de env-var".
3. Padrões codificados — https://cloud.uipath.com para a autoridade, json para o formato de saída, info para o nível de log, tamanho da página de 50 nos verbos de lista.

Variáveis de Ambiente

As variáveis de ambiente são o principal mecanismo para configurar a CLI em executores de CI, contêineres e configurações de desenvolvedor por shell. Defina-os no ambiente do executor (ou em um arquivo .env consumido por seu executor), e a CLI os lerá nos pontos documentados abaixo.

Variável	Lido por	Finalidade
UIPATH_URL	uip login, cada comando autenticado	Substitua o URL base da autoridade de identidade. O padrão é https://cloud.uipath.com.
UIPATH_CLI_ENABLE_ENV_AUTH	Cada comando autenticado	Defina como true para alternar a CLI do fluxo de credenciais baseado em arquivos para autenticação da variável de ambiente. Com essa porta ativada, a CLI lê o token de acesso + tenant + organização das variáveis abaixo e ignora totalmente a pasta de credenciais ~/.uipath/ . Consulte Autenticação — Fluxo 3.
UIPATH_CLI_AUTH_TOKEN	somente fluxo de autenticação do env-var	Token de acesso JWT. O URL do servidor é derivados da declaração iss do token.
UIPATH_CLI_ORGANIZATION_NAME	somente fluxo de autenticação do env-var	Campo de dados dinâmico da organização.
UIPATH_CLI_ORGANIZATION_ID	somente fluxo de autenticação do env-var	UUID da organização.
UIPATH_CLI_TENANT_NAME	somente fluxo de autenticação do env-var	Campo de dados dinâmico do tenant.
UIPATH_CLI_TENANT_ID	somente fluxo de autenticação do env-var	UUID do tenant.
UIPATH_TELEMETRY_DISABLED	Inicialização da telemetria	Defina como 1 ou true para desativar a telemetria de uso anônimo.
UIPATH_AI_CONNECTION_STRING	Inicialização da telemetria	Substitua a string de conexão do Application Insights.
HTTP_PROXY / http_proxy	Camada de rede	Proxy HTTP para solicitações de saída (host e ferramentas).
HTTPS_PROXY / https_proxy	Camada de rede	Proxy HTTPS.
NO_PROXY / no_proxy	Camada de rede	Lista de proxy ignorado.

Para valores não secretos que variam entre implantações (tenant, organização, nome da pasta), passe-os como variáveis em seu executor de CI e faça referência a eles em comandos uip :

env:
  UIPATH_TENANT: Production
  UIPATH_FOLDER: Shared
script:
  - uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT"
  - uip or folders list --all --path "$UIPATH_FOLDER"

AVISO:

Nenhuma leitura implícita de UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET

A configuração de UIPATH_CLIENT_ID e UIPATH_CLIENT_SECRET no ambiente sozinho não autentica a CLI. As versões pré-1.0 as lêem implicitamente; esse comportamento foi removido. Passe-os explicitamente usando o prefixo env.VAR_NAME em --client-id / --client-secret ou use o fluxo de autenticação env-var acima para autenticação baseada em token. Consulte Autenticação.

Onde cada configuração pode ficar

Configuração	Bandeira	Env var	Padrão
Autoridade / URL de base	--authority <url>	UIPATH_URL	https://cloud.uipath.com
ID do cliente do aplicativo externo	--client-id <id>	— (definido via sinalizador com prefixo env.var_NAME)	nenhum
Segredo do cliente do aplicativo externo	--client-secret <secret>	— (definido via sinalizador com prefixo env.var_NAME)	nenhum
Tenant	--tenant <name> (ou sessão)	—	da sessão
Folder	--folder-path / --folder-key por comando	—	nenhum
Formato de saída	--output <format>	—	json
Filtro de saída	--output-filter <jmespath>	—	nenhum
Nível de log	--log-level <level>	—	info
arquivo de log	--log-file <path>	—	nenhum
registro npm para ferramentas	—	—	.npmrc @uipath:registry (se definido), caso contrário, padrão npm
Telemetria	—	UIPATH_TELEMETRY_DISABLED=1	enabled

As configurações sem uma coluna env-var só podem ser definidas por comando por meio de sinalizadores.

Exemplos de configurações

Executor de CI mínimo (tudo via env)

env:
  UIPATH_URL: https://cloud.uipath.com
  UIPATH_CLIENT_ID: ${{ secrets.UIPATH_CLIENT_ID }}
  UIPATH_CLIENT_SECRET: ${{ secrets.UIPATH_CLIENT_SECRET }}
  UIPATH_TENANT: Production
  UIPATH_TELEMETRY_DISABLED: "1"

steps:
  - run: npm install -g @uipath/cli
  - run: uip tools install @uipath/orchestrator-tool @uipath/solution-tool
  - run: |
      uip login \
        --client-id env.UIPATH_CLIENT_ID \
        --client-secret env.UIPATH_CLIENT_SECRET \
        --tenant "$UIPATH_TENANT"
  - run: uip or folders list

Contêiner com um token pré-emitido (fluxo de autenticação env-var)

export UIPATH_CLI_ENABLE_ENV_AUTH=true
export UIPATH_CLI_AUTH_TOKEN="$BUILD_TOKEN"
export UIPATH_CLI_ORGANIZATION_NAME=contoso
export UIPATH_CLI_ORGANIZATION_ID="$ORG_UUID"
export UIPATH_CLI_TENANT_NAME=Default
export UIPATH_CLI_TENANT_ID="$TENANT_UUID"

uip or folders list

Nenhuma etapa uip login , nenhum arquivo escrito. Cada comando autentica a partir do env vars.

Veja também

• Autenticação — os três fluxos de autenticação e qual ambiente cada um lê.
• Instalação do UiPath CLI — variáveis de proxy, recusa de telemetria e padrões de instalação do CI.
• Sessões e credenciais — a pasta de credenciais .uipath/ escrita por uip login.
• Opções globais — sinalizadores que substituem variáveis de ambiente por invocação.