SimpleaSIMPLEA ORQUESTRA / GUIA DE USO

Como usar o Orquestra

A central web organiza os clientes, os acessos e as máquinas. O agente instalado no Windows executa os scripts e devolve os resultados ao painel.

Guia da V2 · Atualizado em 15/10/2026

1. Acesso e clientes

  1. Entre na central com seu usuário e senha em orquestra.simplea.tech.
  2. Abra Workspaces. Cada workspace representa um cliente da Simplea. A lista mostra somente os clientes autorizados para sua conta; administradores globais gerenciam todos.
  3. Escolha Simplea Servidor para os testes internos. Em Dispositivos, confira o estado e o último contato do Servidor Simplea. Use Abrir ambiente para acessar o painel da máquina.

A administração global da Simplea gerencia os clientes. Em Usuários e acessos, os administradores autorizados gerenciam convites e perfis do workspace selecionado. O administrador de um cliente não se torna administrador global por receber esse perfil.

Senha da central
Permite entrar no site com seu usuário.
Senha do editor local
Definida no setup da máquina; protege o cadastro e a edição de código. Não é necessariamente a mesma senha da central.
Código de instalação / token
Credencial secreta que identifica uma máquina no workspace. Não é uma senha de usuário.

Inicio, monitoramento e workspace

Inicio reúne os clientes acessíveis e os totais de dispositivos conectados e desconectados. Monitoramento permite filtrar cliente, dispositivo e conexão sem entrar no ambiente de uma máquina.

Use Consultar execucoes para ler os últimos 20 registros de cada dispositivo conectado que corresponda aos filtros. Essa consulta não executa scripts. A lista informa quando houve falha de comunicação; máquinas offline não fornecem histórico nessa consulta.

Conectada indica contato recente do agente, não sucesso da automação. O resultado de cada RPA vem do histórico do agente: na fila, em execução, concluída, falhou ou cancelada. Em Comandos remotos, “Respondido” indica apenas que o agente respondeu à requisição.

Academy está em breve: vídeos, trilhas de aprendizado e mentorias ainda não foram publicados.

Administrar usuários e permissões

Administradores globais encontram Administração global na central: contas ativadas, convites pendentes e histórico de alterações.

  1. Use Convidar usuário, escolha o cliente e o perfil. Compartilhe o link para a pessoa definir a senha. Gerar um link não envia um e-mail automaticamente.
  2. Depois da ativação, use a engrenagem da conta para definir acesso global, se necessário. Global + desenvolvimento também permite editar scripts e configurações técnicas.
  3. Para rebaixar, escolha Somente workspaces atribuídos. Os vínculos com clientes permanecem; clique no cliente para alterar o perfil ou remover esse acesso.
  4. Em Workspaces, crie, renomeie ou desative clientes. Em Convites pendentes, revogue links que não devem mais ser usados.

Você não pode alterar o próprio perfil global. Toda alteração efetiva encerra as sessões do destinatário, invalida seus convites pendentes e fica na auditoria. A senha não é alterada.

2. Instalar e vincular uma máquina Windows

  1. Na central, selecione o cliente correto e use Cadastrar máquina. Guarde o código de instalação exibido; ele contém uma credencial secreta.
  2. Use o botão verde de instalador no canto superior da central e escolha Baixar ZIP. O download exige login e não inclui credenciais ou dados de clientes. Na máquina executora, extraia todo o ZIP para uma pasta definitiva, como C:\Simplea\Orquestra, desde que seu usuário tenha permissão. Não execute o setup de dentro do ZIP.
  3. Abra Setup.cmd e escolha 1 - Máquina executora (agente conectado à central). Instale os componentes exigidos pelos seus scripts: Node.js para JavaScript e navegadores para automações web. Git é opcional para desenvolvimento.
  4. No assistente, informe o código de instalação, escolha uma porta local livre e defina uma senha do editor com pelo menos 12 caracteres. Confirme a URL da central, o cliente e a máquina antes de concluir.
  5. Habilite alterações remotas somente se estiver autorizado a cadastrar, editar ou acionar operações que alteram dados nessa máquina.
  6. Escolha se deseja iniciar ao entrar no Windows e aceite iniciar agora quando estiver pronto. Confira a confirmação de conexão e depois o estado na central.

Vínculo validado significa que a credencial foi aceita. A máquina só aparece conectada quando o agente está rodando e enviando contatos. O setup não executa automaticamente os scripts de Despesas corporativas nem fornece planilhas, PDFs ou chaves de IA.

3. Manter o agente conectado

Fechar a aba do navegador não desfaz o vínculo. O computador precisa estar ligado, com rede e com os componentes do Orquestra em execução. Use o atalho criado pelo setup para iniciá-los.

O início automático atual acontece no login do usuário instalador. Não é um serviço Windows que inicia antes do login. Suspensão, desligamento, encerramento da sessão, falhas de rede ou parada do agente interrompem a comunicação. Automações com interface visível dependem de uma sessão adequada.

Na central, o estado online expira após cerca de 20 segundos sem contato. Confira também o horário do último contato. Revogar invalida o acesso da máquina; não use esse botão apenas para fechar a tela.

Não renomeie, mova ou apague uma instalação ativa. Preserve configurações, scripts e dados antes de planejar uma atualização com a Simplea.

4. Cadastrar scripts

No ambiente da máquina, selecione a automação e abra Scripts. Para um processo separado, use Nova pasta ou Nova automação, conforme a tela.

  1. Clique em Adicionar script e escolha Criar novo ou Arquivo existente.
  2. Escolha Python, JavaScript ou CMD / Batch, informe um nome e confira o caminho do arquivo.
  3. Informe a senha do editor quando solicitada. Confirme as opções de escrita e navegador de acordo com o que o código realmente faz.
  4. Use Criar e abrir código, edite e clique em Salvar rascunho para gravar na máquina executora. A opção Salvar e publicar envolve GitHub e exige a configuração e autorização correspondentes.

Copiar um arquivo para a pasta não o cadastra nem o executa automaticamente. Dependências específicas do seu código também precisam existir na máquina executora.

Abrir exemplo JavaScript e passo a passo

Scripts executam com as permissões do usuário Windows do agente. As opções de confirmação não são uma sandbox. Revise código antes de executá-lo e não grave credenciais no código ou no log.

5. Pastas de entrada e saída

Os arquivos usados pelos scripts precisam estar acessíveis na máquina executora, não apenas no computador onde você abriu o site. Confira sempre os caminhos em Configuração.

Em uma instalação nova compatível, o exemplo de Despesas corporativas usa esta estrutura. Instalações anteriores podem preservar caminhos personalizados:

scripts/<cliente>/despesas_corporativas/
  python/         javascript/         cmd/
  entrada/
    DESPESAS CORPORATIVAS/
    REEMBOLSOS/
  bases/
    conhecimento/
    destino/
  saida/          estado/             logs/

O identificador da pasta é gerado a partir do cliente; confirme o valor real na tela. Para Despesas corporativas, prepare cópias autorizadas dos PDFs e as duas bases exigidas:

Configure a credencial da IA somente na tela apropriada da máquina, quando a etapa precisar dela. O código nativo de Despesas permanece em src/, chamado por run.py; não precisa ser movido para essas pastas.

6. Executar e consultar o resultado

  1. Confira a máquina, a automação e as Pendências. Comece por um teste sem escrita ou pelo diagnóstico de leitura.
  2. Em Scripts, clique em Executar no item desejado. Leia qualquer confirmação antes de permitir alterações de dados.
  3. Acompanhe a saída no painel. Depois, abra Execuções e selecione o registro para consultar situação, início, fim, código de saída e log.
  4. Para o exemplo JavaScript, espere Resultado: 42, ORQUESTRA_JS_OK e código de saída 0.

Comandos remotos mostra a comunicação entre central e agente. Um comando entregue não comprova que o RPA terminou com sucesso; consulte a execução e seus resultados.

O Teste integrado da automação de Despesas exige arquivos específicos da amostra. Ele não é um teste genérico do instalador. Um teste JavaScript bem-sucedido também não valida IA, planilhas ou Protheus.

7. Agendamentos

Depois de validar manualmente o script, configure sua recorrência em Agendamentos, confira o horário configurado na máquina e salve com as permissões necessárias. Verifique o histórico após o primeiro disparo.

O agendador depende do painel local em execução. Não presuma que tarefas perdidas enquanto a máquina estava desligada serão recuperadas automaticamente. Desative agendamentos antes de manutenções planejadas.

8. Resolver problemas

Máquina desconectada
Confira Windows, rede, atalho de inicialização e último contato. Consulte _work/v2/runtime.log na instalação. Não cadastre outra máquina apenas porque houve uma queda de rede.
Origem recusada
Use a URL oficial configurada na central, evitando endereços alternativos de preview. Informe a URL usada à equipe Simplea se persistir.
Senha inválida
Confira se a tela pede a senha da central ou a do editor local. Solicite redefinição ao administrador; não envie senhas ou tokens pelo chat.
Arquivo, planilha ou módulo ausente
Confira os caminhos na máquina executora, as abas das planilhas e as dependências do script. Leia o primeiro erro no log antes de repetir a execução.
Comando de escrita recusado
Confira seu perfil e se a instalação permite alterações remotas. Não remova controles de acesso para contornar o erro.

Ao pedir suporte, informe cliente, máquina, nome do script, horário e mensagem de erro, removendo dados sensíveis. Não compartilhe o arquivo de acesso, o código de instalação ou chaves de API.