Gerenciamento de ferramentas e habilidades

Instale, atualize e remova ferramentas e habilidades da UiPath CLI usando os comandos integrados "uip Tools" e "uip Skills".

Ferramentas e habilidades são os dois sistemas de extensão que ficam ao lado do host uip . Ferramentas adicionam comandos que se comunicam com os serviços da UiPath; habilidades ensinam aos agentes de codificação de IA como direcionar esses comandos. Ambos são instalados, atualizados e removidos por meio da própria CLI. Esta página abrange os fluxos de trabalho do dia a dia — não a divisão conceitual (consulte Ferramentas (guia) e Habilidades) e não a referência completa do comando (consulte ferramentas uip e habilidades uip).

Ferramentas — dia a dia

Veja o que está instalado

uip tools list --output table

Retorna uma tabela de Name, Version, CommandPrefix. Use isso para identificar descompassos entre um laptop de desenvolvedor e um servidor de compilação.

Para capturar um instantâneo, você pode comparar depois:

uip tools list --output json --output-filter "Data[*].{Name: Name, Version: Version}" > tools.json

Instalar uma ferramenta

Três formas de identificador funcionam — escolha o que for melhor lido no contexto:

uip tools install or                                # alias (shortest)
uip tools install orchestrator-tool                 # short name
uip tools install @uipath/orchestrator-tool         # full npm name

Versão explícita (para reprodutibilidade de CI):

uip tools install orchestrator-tool@1.0.2

Canal de visualização — alterne o canal de atualização e, em seguida, instale normalmente (uip tools install <name>@beta falha: a versão após @ deve ser uma string semver válida, não um nome de canal):

uip config set updateChannel preview
uip tools install maestro-tool

# or pin an exact prerelease version directly, without changing the channel:
uip tools install maestro-tool@1.0.0-preview.1

Consulte Controle de versão e estabilidade para o modelo completo de canal/dist-tag.

No CI, sempre instale as ferramentas de que você precisa como uma etapa dedicada — a instalação automática paga um custo único de download no comando que for executado primeiro. Defina UIPATH_CLI_DISABLE_AUTOINSTALL=true para uma exclusão forçada ou apenas pré-instale (detalhes):

uip tools install @uipath/orchestrator-tool \
                  @uipath/solution-tool \
                  @uipath/test-manager-tool

Atualizar ferramentas após um clique de CLI

Quando você atualiza @uipath/cli, as ferramentas instaladas permanecem em sua versão anterior. Execute uip tools update para trazê-los para a versão mais recente dentro da nova linha MAJOR.MINOR da CLI:

npm install -g @uipath/cli@1.1.0
uip tools update

Atualize uma única ferramenta:

uip tools update --name orchestrator-tool

O Data em UpdateResult fornece diferenças por ferramenta from → to — útil para logs de auditoria.

Observação:

uip tools update leva apenas --name <scoped-tool-name> — não há sinalizador --version para fixar uma versão exata por meio de update. Para fixar uma versão exata, reinstale-a explicitamente: uip tools install orchestrator-tool@1.0.3 (consulte ferramentas uip).

Dica:

Atualizar conclusão do shell após uma atualização

O script de conclusão de shell é um instantâneo estático dos verbos e sinalizadores conhecidos na uip completion execução. Após npm install -g @uipath/cli@<new>, uip tools install, ou uip tools update, execute novamente uip completion para que comandos e sinalizadores recém-adicionados apareçam em <TAB>. Consulte conclusão do uip — Instantâneo estático.

Remova uma ferramenta

uip tools uninstall or

Após a desinstalação, a próxima invocação de uip or … disparará a instalação automática novamente, a menos que ela seja bloqueada (executor offline, instalação de lista de permissões). Para manter uma ferramenta em um executor sem estado, pré-instale apenas as ferramentas que você deseja e não chame as desinstaladas.

Desvio de auditoria entre ambientes

Em cada ambiente, capture o conjunto instalado:

uip tools list --output json --output-filter "Data[*].{Name: Name, Version: Version}" | jq -S . > tools.$(hostname).json

Diferenciar os arquivos entre os ambientes. Qualquer delta é uma origem de "trabalhos na minha máquina" — resolvidos fixadando no CI.

Habilidades — dia a dia

Veja o que está instalado

ls ~/.uipath/.skills         # the on-disk skill catalog cache
cat ~/.uipath/.skills/manifest.json   # manifest of installed skills per agent

Para uma instalação local, o armazenamento fica sob a raiz do projeto ./.uipath/.skills/. Alternativamente, peça a um agente para listar suas habilidades instaladas — todo agente compatível expõe isso por meio de sua própria IU / comando.

Instalar habilidades em um agente de codificação

Por agente:

uip skills install --agent claude        # Claude Code (global only)
uip skills install --agent cursor        # Cursor
uip skills install --agent copilot       # GitHub Copilot
uip skills install --agent codex         # Codex
uip skills install --agent opencode      # OpenCode
uip skills install --agent autopilot     # UiPath Autopilot
uip skills install --agent kiro          # Kiro (Amazon Q)
uip skills install --agent windsurf      # Windsurf
uip skills install --agent antigravity   # Antigravity CLI
uip skills install --agent devin         # Devin

Interativo (seleção múltipla via caixa de seleção):

uip skills install

Escopo:

• O padrão é global — instalado no perfil do usuário do agente. Disponível em todos os lugares em que o agente é executado.
• em vez disso, --local é instalado no diretório atual. Bom para habilidades fixadas no projeto ou quando você não quer confundir o perfil do usuário. O Claude Code é somente global — passando --local com erros --agent claude excluídos.

Mantenha as habilidades atualizadas

uip skills update busca novamente o catálogo de habilidades da UiPath e reinstala:

uip skills update --agent claude

A atualização também remove as habilidades que desapareceram do catálogo remoto desde a última instalação — os agentes permanecem em dia com o conjunto lançado da UiPath.

Remover habilidades

uip skills uninstall --agent claude

Não remove o próprio agente e não afeta as habilidades de outros agentes. Execute uma vez por agente do qual você deseja remover habilidades.

Combinação de ferramentas e habilidades em um projeto

Um padrão comum para um repositório que usa agentes de codificação de IA para trabalho da UiPath:

1. Fixe @uipath/cli na documentação do projeto (não em package.json — a CLI é uma dependência de desenvolvimento na máquina do operador, não uma dependência de runtime do projeto).
2. Documente o Aplicativo Externo e o tenant dos destinos do projeto em seu README. Cada colaborador define as variáveis de ambiente correspondentes em sua máquina e faz login uip login.
3. Instale as ferramentas relevantes para o projeto na máquina de cada colaborador:

   uip tools install or solution tm
   

4. Instale habilidades localmente para o agente de codificação usado pelo projeto:

   uip skills install --agent cursor --local
   

5. Adicione o diretório local Skills-store a .gitignore (o comando de instalação imprime o caminho na primeira execução).

Os agentes em execução no repositório autenticam-se com a sessão do colaborador, as habilidades ensinam a eles a usar uip e as ferramentas fixadas mantêm as compilações reprodutíveis.

Quando as coisas dão errado

Os comandos de uma ferramenta não aparecem em uip --help

A ferramenta não está instalada ou falhou ao carregar. Verificar:

uip tools list                  # is it installed?
uip --log-level debug or folders list   # what does the host say during tool load?

Uma ferramenta que carrega com um erro é ignorada silenciosamente pela árvore de conclusão e pelo dispatcher de comando.

Uma ferramenta é instalada, mas os comandos falham com "opção desconhecida"

Provavelmente uma incompatibilidade de versão — a ferramenta foi criada em relação a uma linha secundária de CLI diferente. Corrigir com uip tools update --name <tool>.

As habilidades não aparecem no meu agente de codificação

Cada agente lida com arquivos de habilidades por meio de seu próprio sistema de plug-in/regras. Depois de uip skills install --agent <name>:

• Claude Code — reinicie o Claude Code; as habilidades aparecem no seletor de plug-ins.
• Cursor — as habilidades são carregadas automaticamente na próxima conversa; consulte ~/.cursor/skills/ (global) ou ./.cursor/skills/ (local).
• GitHub Copilot — abra o painel Copilot; as habilidades ficam em ~/.copilot/skills/ (global) ou ./.github/skills/ (local).
• Codex — as habilidades são gravadas em ~/.agents/skills/ ou ./.agents/skills/ (o diretório padrão aberto de Habilidades do agente).
• OpenCode — as habilidades são escritas em ~/.config/opencode/skills/ (global) ou ./.opencode/skills/ (local).
• UiPath Autopilot — as habilidades são escritas em ~/.autopilot/skills/ (global) ou ./.autopilot/skills/ (local).
• Especificar (Amazon Q) — as habilidades são gravadas em ~/.kiro/skills/ (global) ou ./.kiro/skills/ (local).
• Navegar — as habilidades são escritas em ~/.windsurf/skills/ (global) ou ./.windsurf/skills/ (local).
• Antigravity CLI — as habilidades são escritas em ~/.gemini/antigravity-cli/skills/ (global) ou ./.agents/skills/ (local).
• Devin — as habilidades são gravadas em ~/.agents/skills/ ou ./.agents/skills/ (o diretório padrão aberto de Habilidades do agente).

uip skills install --agent <name> --print (ou a caixa de seleção equivalente no modo interativo) para ver o destino exato.

Veja também

• Ferramentas ( Esse tipo de plug-ins ) — o modelo de host mais plug-ins.
• Habilidades — o sistema de extensão do agente de IA.
• referência de ferramentas uip — lista completa de sinalizadores.
• referência de habilidades UIP — lista completa de sinalizadores.
• Instalação do UiPath CLI — Controle da instalação automática da ferramenta — como a instalação automática se comporta no CI.
• Uso do UiPath CLI com agentes de codificação — orientações de configuração por agente.