Uso do UiPath CLI com agentes de codificação

Agentes de codificação de IA — Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex, OpenCode — podem criar e operar automações UiPath usando uip da mesma forma que um desenvolvedor faz. Você os ensina instalando habilidades: pacotes de instruções orientadas a tarefas publicados pela UiPath. Depois que uma habilidade é instalada, o agente sabe quando empacotar uma Solução, como encadear publish com deploy run, quando esperar por um trabalho, como inspecionar uma pasta do Orchestrator — toda a superfície, não apenas nomes de comando.

Esta página orienta a configuração por agente: instale a própria CLI do agente, faça login na UiPath, instale habilidades e verifique a instalação.

Pré-requisitos

Todos os agentes compatíveis compartilham os mesmos pré-requisitos:

1. @uipath/cli instalado em sua máquina. Consulte Instalação do UiPath CLI.
2. Uma sessão conectada. Execute uip login uma vez; as habilidades usam a mesma sessão que o restante da CLI usa. Consulte Autenticação.
3. O agente de codificação instalado. Cada seção abaixo está vinculada ao instalador do agente.

Você não precisa instalar ferramentas UiPath (uip tools install …) antes de instalar habilidades — o agente pode instalá-las automaticamente no primeiro uso.

Escolha um agente

Agente	--agent Value	Suporte a escopo	Observações
Claude Code (guia)	claude	Apenas global	Habilidades instaladas como plug-ins do Claude Code; o sistema de plug-in tem o escopo do usuário, sem opção de projeto.
Cursor	cursor	Global ou local	As habilidades são instaladas em .cursor/skills/<skill>/; O cursor as carrega por espaço de trabalho.
Copilot do GitHub	copilot	Global ou local	As habilidades são instaladas em .github/skills/<skill>/; O Copilot os carrega como instruções personalizadas.
CLI do Gemini	gemini	Global ou local	As habilidades são instaladas em .gemini/skills/<skill>/.
Código	codex	Global ou local	As habilidades são instaladas em .agents/skills/<skill>/ — o diretório padrão aberto de Habilidades do agente.
Abrir código	opencode	Global ou local	As habilidades são instaladas em .opencode/skills/<skill>/ (local) ou ~/.config/opencode/skills/<skill>/ (global).

Consulte Habilidades para o modelo e referência de habilidades uip para a superfície completa da flag.

Código do Claude

Instalar o agente

Consulte Claude.com/Claude-code para instalação. No macOS/Linux, o caminho comum é curl -fsSL https://claude.ai/install.sh | bash.

Instalar habilidades

uip skills install --agent claude

O Claude Code é global apenas para habilidades. Passando --local erros com um ValidationError.

Verificar

Abra o Claude Code. Peça: "Empacote esta solução e implante-a na pasta compartilhada." O agente deve propõe uip solution pack → uip solution publish → uip solution deploy run — o fluxo canônico.

Se o agente não reconhecer tarefas específicas da UiPath, reinicie o Claude Code para que ele recarregue os plug-ins e, em seguida, tente novamente.

Cursor

Instalar o agente

Consulte cursor.com para ver a instalação.

Instalar habilidades

Global (disponível em todos os espaços de trabalho):

uip skills install --agent cursor

Por projeto (controlado ao lado de seu repositório):

cd /path/to/project
uip skills install --agent cursor --local

As instalações locais adicionam o diretório de armazenamento de habilidades a .gitignore automaticamente — os pacotes de habilidades em cache ficam fora das confirmações.

Verificar

Abra o Cursor no repositório. No Compositor, peça: "Crie um novo projeto do agente do UiPath e empacota-o." O agente deve propõe uip agent init → uip agent validate → uip agent pack.

Copilot do GitHub

Instalar o agente

O GitHub Copilot é um plug-in de VS Code / ObjectBrains / Visual Studio. Consulte github.com/features/copilot.

Instalar habilidades

uip skills install --agent copilot

( --local para regras por repositório.)

Verificar

Abra um projeto no VS Code (ou seu editor compatível) e abra o painel Copilot Chat. Peça uma tarefa específica da UiPath. O Copilot deve mencionar as regras de habilidade instaladas ao compor sua resposta.

CLI do Gemini

Instalar o agente

Consulte github.com/google-gemini/gemini-cli.

Instalar habilidades

uip skills install --agent gemini

(Adicionar --local para habilidades com escopo de projeto.)

Verificar

Execute gemini no repositório. Peça uma tarefa da UiPath e verifique se ela propõe comandos uip a partir das habilidades instaladas.

Código

Instalar o agente

Consulte as instruções de instalação do Codex da OpenAI.

Instalar habilidades

uip skills install --agent codex

Verificar

Inicie o Codex. Peça uma tarefa da UiPath; as habilidades devem guiá-lo para a cadeia de comando uip .

Abrir código

Instalar o agente

Consulte opencode.ai.

Instalar habilidades

uip skills install --agent opencode

Verificar

Inicie o OpenCode no diretório do projeto. Verifique ~/.config/opencode/skills/ (global) ou ./.opencode/skills/ (local) para obter os arquivos de habilidades instalados.

Trabalho com agentes na prática

Deixe o agente guiar — não especifique todos os comandos

As habilidades codificam a sequência de comandos a serem usados. Peça resultados ("implantar esta solução na produção"), não comandos específicos. O agente encadeará pack → publish → deploy run (ou pedirá que você confirme cada etapa, dependendo do modo do agente).

Compartilhar sua sessão

Os agentes executam uip em sua máquina, usando a sessão uip login configurada. Se você estiver conectado como uma conta pessoal, o agente atua como você. Use uma sessão do App externo (Fluxo 2 na Autenticação) se você quiser o agente associado a uma identidade de serviço.

Mantenha as habilidades e ferramentas no mesmo passo

Após uma atualização da CLI, execute também uip skills update --agent <name> para selecionar quaisquer habilidades recém-publicadas e uip tools update para trazer ferramentas para a linha MAJOR.MINOR correspondente. Consulte Gerenciamento de ferramentas e habilidades.

Quando o agente fica travado

Peça ao agente para executar uip <command> --help e inserir a saída de volta na conversa. A ajuda integrada é autorizada e abrange sinalizadores que as habilidades ainda podem não descrever. Os agentes normalmente se recuperam por conta própria após a saída de ajuda.

MCP (caminho alternativo)

Para clientes sensíveis ao MCP que não estão na lista de agentes compatíveis, a UiPath CLI envia um servidor MCP por meio uip mcp. Ele expõe uma ferramenta, run_command, que permite que o cliente execute qualquer comando uip . Esse não é o caminho principal de IA para a UiPath — as habilidades são —, mas está disponível para integrações que já falem com MCP. Consulte a referência do uip mcp.

Veja também

• Habilidades — o que são habilidades, os agentes compatíveis e o modelo de granularidade.
• referência de habilidades uiip — referência de sinalizador.
• Gerenciamento de ferramentas e habilidades — manutenção do dia a dia.
• Instalação do UiPath CLI — configuração única.
• Autenticação — fluxos de sessão que os agentes herdam.

Isenção de responsabilidade

O agente de codificação não valida a conformidade de qualquer código que gera, comandos operacionais que executa ou ação de solução de problemas que recomenda — você é responsável por revisar todo o código gerado, alterações operacionais e saídas de diagnóstico antes de aplicá-los à produção. Para usá-la de forma responsável: autentique com um token dedicado com escopo de permissões mínimas (não seu acesso total) para trilhas de auditoria mais limpas; execute no modo attended para manter um humano no loop; certifique-se de que as proteções de agentes de terceiros estejam configuradas para limitar o escopo e evitar comportamentos inesperados em fluxos de trabalho de codificação, operacionais e de solução de problemas; verificar se qualquer processamento de dados pessoais está em conformidade com as políticas e requisitos de proteção de dados de sua organização; e mantenha a supervisão humana em cada ponto de controle interno ou aprovação — especialmente antes de executar alterações operacionais ou agir nas recomendações de solução de problemas que podem afetar ambientes ao vivo.