Solução de problemas e perguntas frequentes

Soluções para problemas comuns de configuração e runtime com as habilidades uip CLI e UiPath, incluindo falhas de instalação, problemas de login e habilidades não reconhecidas.

Esta página lista os problemas que as pessoas encontram com mais frequência ao configurar e usar o UiPath para Coding Agents, organizados pelo sintoma que você vê.

O instalador falha parcialmente

Se o One-liner parar com um erro, leia a mensagem na tela — o instalador grava seu status e erros no terminal.

• Se um único runtime falhar, execute novamente o instalador. Cada etapa é idempotente e ignora o que já foi bem-sucedido.
• Se você ainda não precisar do.NET SDK ou do Python, execute novamente com --skip-runtimes para colocar o CLI e as habilidades no lugar primeiro.

o npm retorna um erro 403, 404 ou de tempo limite

Se a instalação ou uma atualização falhar ao recuperar um pacote @uipath, confirme se seu cliente npm ou repositório interno pode alcançar o escopo do pacote público da UiPath. Permitir apenas @uipath/cli não é suficiente porque a CLI recupera habilidades e pacotes de suporte específicos do recurso conforme necessário.

Consulte Redes restritas e registros npm internos para obter os comandos de escopo, ponto de extremidade de registro, configuração e verificação necessários.

"uip: comando não encontrado" após a instalação

Se uip não for reconhecido, seu PATH não selecionou a nova instalação.

1. Abra um novo terminal para que o PATH atualizado entre em vigor.
2. Execute uip --help novamente para confirmar.

o login do uip não é concluído

Se o navegador não abrir ou o login não for concluído:

• Confirme se você pode alcançar seu ambiente da UiPath em um navegador.
• Se você usar um ambiente diferente de cloud.uipath.com, passe-o explicitamente: uip login --authority "https://your-environment".
• Se o tenant errado for selecionado, execute uip login -it e escolha o correto.

Seu agente não parece usar as habilidades

Se seu agente de codificação atuar como se não conhecesse a UiPath:

1. Atualize as habilidades instaladas executando uip skills update.
2. Confirme que seu agente é um dos compatíveis (consulte Escolha de seu agente).
3. Reinicie seu agente de codificação para que ele recarregue as habilidades instaladas.

Um runtime está ausente quando você cria

Se uma compilação falhar porque o Node.js, o.NET SDK ou o Python está ausente, execute novamente o instalador sem quaisquer sinalizadores de skip para que ele instale os runtimes que ignorou anteriormente.

Obtendo mais ajuda

Para uma investigação mais profunda, seu agente de codificação pode usar uipath-troubleshoot habilidade para diagnosticar uma falha específica. Para relatar um bug ou sugestão, peça que ele use uipath-feedback ou execute o comando de feedback diretamente.