Ir para o conteúdo

BotCity Phoenix — Migração de UiPath para Python

O BotCity Phoenix é uma skill do Claude Code que converte arquivos de workflow UiPath (.xaml + .json) em automações Python prontas para o ecossistema BotCity. Este guia descreve como instalar a skill e executar sua primeira conversão.

Pré-requisitos

  • Claude Code instalado na máquina
  • Arquivos do processo UiPath disponíveis localmente: o arquivo .xaml (workflow) e o arquivo .json (geralmente project.json)
  • Python com o BotCity SDK instalado:
pip install botcity-maestro-sdk

Instalar a skill Phoenix

Copie a pasta da skill para o diretório de skills do Claude Code:

mkdir -p ~/.claude/skills
cp -r ./phoenix-botcity ~/.claude/skills/

Reinicie o Claude Code para que a skill seja reconhecida.

Dica

Confirme que a skill foi instalada corretamente: ao digitar / no Claude Code, phoenix-botcity deve aparecer na lista de skills disponíveis.

Abrir o Claude Code na pasta do projeto

Navegue até o diretório onde estão os arquivos .xaml e .json do processo UiPath:

cd /caminho/para/seu/projeto-uipath

Abra o Claude Code nesse diretório. A skill precisa ter acesso aos arquivos do projeto para realizar a conversão.

Executar a conversão

No Claude Code, chame a skill:

/phoenix-botcity

Para passar contexto adicional — como manter os nomes de variáveis originais ou converter um arquivo específico —, inclua a instrução na chamada:

/phoenix-botcity converter o ProcessoFaturamento.xaml mantendo os nomes de variáveis originais

Para converter um projeto inteiro com múltiplos arquivos .xaml, aponte para a pasta raiz e instrua a skill:

/phoenix-botcity converter o projeto inteiro

Revisar os arquivos gerados

Após a execução, a skill gera três arquivos na pasta do projeto:

Arquivo Conteúdo
.py Automação convertida em Python
requirements.txt Dependências BotCity necessárias
MIGRATION_NOTES.md Pontos que exigem revisão manual

Abra o MIGRATION_NOTES.md antes de qualquer outra coisa. Ele lista:

  • Custom activities que viraram # TODO no código Python
  • Seletores UiPath que podem precisar de ajuste manual
  • Credenciais e variáveis de ambiente que precisam ser reconfiguradas

Atenção

O BotCity Phoenix é um acelerador de migração, não um conversor automático completo. Revise o código gerado e o MIGRATION_NOTES.md antes de usar a automação em produção.

Resultado esperado

Ao final do processo, você terá:

  • Um arquivo .py funcional com a automação convertida para o padrão BotCity
  • Um requirements.txt com as libs necessárias para executar a automação
  • Um MIGRATION_NOTES.md detalhando tudo que exige atenção humana antes de colocar em produção