Code
Robôs em Node.js ou Python com código vindo de um repositório Git ou de um .zip, publicados por deploy e executados nos dispositivos do workspace.
Code
Um projeto de código é um robô escrito em Node.js ou Python que roda na infraestrutura da Roberty. O código não é editado na plataforma: ele vem de um repositório Git sincronizado (GitHub, Azure DevOps, GitLab ou Bitbucket) ou de um arquivo .zip enviado por upload, e é executado pelo Runner em dispositivos Windows vinculados ao projeto.
Use projetos de código quando a automação fica melhor escrita em código — integrações com APIs, tratamento de dados, rotinas que já existem em Node.js ou Python — e você quer que a Roberty cuide de publicar, agendar, disparar e registrar as execuções.
Do código à execução
Cada projeto segue o mesmo caminho, a pipeline de entrega:
- Fonte do código — o repositório Git conectado ao projeto ou o .zip enviado. Veja Fonte do código.
- Deploy — a cada push na branch configurada (ou a cada upload de .zip), a Roberty valida a estrutura do projeto, instala as dependências e entrega o código aos dispositivos do ambiente. O primeiro deploy ativa o projeto. Veja Deploys.
- Dispositivos — as máquinas que executam o projeto. Sem dispositivo vinculado e com deploy pronto, o projeto não roda. Veja Dispositivos.
Para a plataforma saber como iniciar o robô, o projeto precisa de um arquivo roberty.json na raiz. Veja Preparar o projeto.
Ambientes: Produção e Preview
| Ambiente | Dispositivos | Para que serve |
|---|---|---|
| Produção | Vários | Execução real: chamadas pela API, agendamentos e execuções manuais. |
| Preview | Um por projeto | Ambiente de testes: execuções manuais e avaliações, sem afetar a Produção. |
Em um projeto Git, cada ambiente recebe o código de uma branch própria. Projetos que recebem código por .zip só têm o ambiente de Produção.
Gatilhos de execução
Um projeto de código pode ser executado de várias formas:
| Gatilho | Como dispara |
|---|---|
| Manual | Pelo botão Executar do projeto, escolhendo ambiente e dispositivo. Veja Execuções. |
| Agendamento | Recorrência configurada por dispositivo de Produção. Veja Agendamentos. |
| Webhook | Chamada à API pública com uma chave de API do workspace, com argumentos e resposta. Veja API e webhook. |
| Avaliação | Conjuntos de teste com entradas e saída esperada, executados no Preview. Veja Avaliações. |
Um robô RPA também pode executar um projeto de código com a ação Executar projeto Code.
Onde os projetos ficam
Projetos de código são criados e organizados na aba Arquivos do workspace, junto com robôs, sub-rotinas e agentes. Ao abrir um projeto, ele é exibido em abas: Visão geral, Deploys, Execuções, Avaliações e Configurações.
A Visão geral mostra os números do projeto — execuções nas últimas 24 horas, taxa de sucesso das execuções concluídas, duração média e total de execuções desde a criação — e a pipeline de entrega, em que cada etapa abre o lugar onde é gerenciada.
Se o projeto estiver desativado, as execuções pelo Studio e pela API ficam bloqueadas até que ele seja reativado em Configurações.